Overview
The following article provides an overview of how to add parameters and values to your iFrame or Evolve ATS-hosted career site.
Audience
All users
Parameters
Parameters are the different ways that you can filter your job listings.
Parameter | In a URL | In an iFrame |
Category | c=name-of-category | data-category=name-of-category |
Department | d=name-of-department | data-department=name-of-department |
Location | l=name-of-location | data-location=name-of-location |
Region | r=name-of-region | data-region=name-of-region |
Subsidiary | s=name-of-subsidiary | data-subsidiary=name-of-subsidiary |
Job Type | t=name-of-job-type | data-type=name-of-job-type |
Page | N/A | data-page=job/{job-id}/apply |
Values
Values are the specific categories, departments, locations, etc., by which you can filter. You must create your own values.
Parameter | Example Values |
Category | Accounting, Engineering, HR |
Department | Accounts Receivable, Application Development, Recruiting |
Location | Chicago, New York, San Mateo |
Region | United States, Germany, North America, Europe |
Subsidiary | (the name of your subsidiary) |
Job Type | Full-Time, Part-Time, Internship |
Page | job/{unique-job-id}/apply |
Filtering iFrames
Use the iFrame parameters from the list above and add the parameter to the iFrame code. Use -%7C- to filter by more than one value. For example:
<div class="jv-careersite" data-careersite="your-careersite-name" data-force-redirect data-category="Accounting-%7C-Finance" data-location="San Mateo"></div>
<script src="//jobs.jobvite.com/__assets__/scripts/careersite/public/iframe.js"></script>
Filtering with URLs
Before you add any filters, you must first add either ? or & to the end of your URL.
Is there a ? anywhere in the URL already?
If so, start by adding & to the end of the URL.
If not, then add ? to the end of the URL.
Filter by One Parameter
Now, add the parameter by which you would like to filter. For example:
- To filter by category, add c=
- For department, add d=
- For location, add l=
- (etc.)
Add the name of the category, department, location, etc., precisely as it appears in Evolve ATS.
Example: If you want to filter by the Accounting category, the URL should look like this:
If you filter by location, you need to use the name of the location title, not the city/state values.
Example: If you create a location called Central Office and assign Chicago, IL, as the city/state values, the URL should look like this:
http://jobs.jobvite.com/sandbox?l=Central Office
Filter by Multiple Parameters
Let's say you want to filter by a category and a department. In that case, separate the parameters with &.
Example: If you want to filter by the category Accounting and the department Accounts Receivable, the URL should look like this:
Filter by Multiple Values
To filter by more than one category, department, location, etc., separate each value with -%7C-.
Do you want to filter by multiple parameters and multiple values?
- Use & to add parameters
- Use -%7C- to add values