Executive Summary

PyjamaHR allows you to display department and location filters on your careers page, making it easier for candidates to find relevant job openings and for recruiters to manage postings efficiently. This guide covers how these filters work, how to configure them, common issues, and best practices—based entirely on real customer scenarios and questions.

Detailed Overview

What Are Department and Location Filters?

Department and location filters are dropdown menus or search fields on your PyjamaHR careers page and job management screens. They let candidates and recruiters filter job listings by department (e.g., Engineering, Sales) or by location (e.g., city, state, country). This improves the candidate experience and streamlines internal job management.

Why Use These Filters?

For candidates: Quickly find jobs that match their skills or preferred location.
For recruiters: Easily manage and organize multiple job postings, especially when hiring for several departments or locations.
For organizations: Reduce irrelevant applications and improve hiring efficiency.

Where Do These Filters Appear?

Careers Page: Public-facing, for candidates to search/filter jobs.
Jobs Section (Admin): Internal, for recruiters to filter/manage postings.
Candidate List: Filter applicants by their selected location or department.

Step-by-Step Guide: Displaying and Using Department or Location Filters

Prerequisites

You must have jobs posted with department and location fields filled out.
Your careers page must be integrated with PyjamaHR (see Career Page Integration Guide).

1. Adding Departments and Locations to Job Postings

A. Department

While creating or editing a job:
- Locate the Department field.
- If your department is in the dropdown, select it.
- If not, type the department name and press Enter to add a custom department (see [Customer Conversation 4141, 4388]).
- Note: In some cases, if you cannot add a new department, contact support to have it added for you ([11570]).
To remove a department:
- Currently, you cannot delete departments from the dropdown or careers page ([1476]).
- If you want to remove a department from appearing, ensure no jobs are assigned to it.

B. Location

While creating or editing a job:
- Locate the Location field.
- Start typing the city/state/country. Select from the dropdown.
- If your location is missing, contact support to request it be added ([11066, 7659, 5203]).
- For remote jobs, only the country can be specified ([9252, 8540]).
- For in-office/hybrid jobs, specify both city and state/country ([10246, 7753]).

2. Displaying Filters on the Careers Page

Department and location filters appear automatically if you have jobs posted with these fields filled.
Candidates can use these filters to narrow down job listings.
If filters are not displaying or not working, ensure:
Jobs have valid department/location fields.
The careers page integration is set up correctly ([7753]).

3. Filtering Jobs Internally

In the Jobs section, use the filters on the left sidebar to filter by department or location ([4224]).
In the Candidate List, use the "Current Location" filter to view applicants from specific locations ([3051, 2377, 2916]).

Advanced Usage & Best Practices

Power User Tips

Custom Departments: If your department isn’t listed, type it and press Enter. This adds it for future use ([4141, 4388]).
Mandatory Fields: Make "Current Location" a mandatory field in your application form to ensure you can filter candidates later ([3051, 2377, 963]).
Screening Questions: Add location or department as a screening question to further filter candidates ([895, 2916, 2334]).
API Integration: Advanced users can use the PyjamaHR API to fetch jobs and customize filters on embedded career pages ([12010]).

Optimization Strategies

Keep job data clean: Avoid typos in department/location fields to ensure filters work correctly.
Regularly review job postings: Remove or update jobs to keep filters relevant.
Communicate with support: If you need to add or remove options not available in the UI, reach out to PyjamaHR support ([11570, 11066]).

Do’s and Don’ts

Do: Always specify both city and state/country for in-office jobs.
Don’t: Expect to restrict applicants by location at the application stage—filters are for sorting, not restricting ([11027]).
Do: Use custom CSS and API for advanced customization if embedding jobs on your own website ([12010]).
Don’t: Expect to remove default country options from the filter dropdown ([12010]).

Troubleshooting & Common Issues

Common Problems and Solutions

Location/Department Not Showing in Dropdown
- Solution: Contact support to add missing options ([11066, 7659, 5203, 8488]).
- Tip: Try a hard refresh or clear your browser cache after support confirms the update ([11246]).
Filters Not Displaying on Careers Page
- Solution: Ensure jobs have valid department/location fields and the careers page is properly integrated ([7753]).
- Check: No jobs assigned to a department/location = filter may not appear.
"No Results Found" When Typing Location
- Solution: Double-check spelling and capitalization ([1974]).
- If still not found: Contact support to add the location ([5203, 7659]).
Cannot Remove Department or Country from Filters
- Explanation: PyjamaHR is a global product; all countries remain in the dropdown ([12010, 1476]).
- Workaround: Only assign jobs to relevant departments/locations.
Filter Not Working on Candidate List
- Solution: Ensure "Current Location" is a mandatory field in the application form ([3051, 2377, 963]).
Location Filter Not Working for Remote Jobs
- Explanation: Only country-level filtering is available for remote jobs ([9252, 8540]).
Location/Department Filter Not Updating After Changes
- Solution: Perform a hard refresh or clear cache ([11246, 5203]).

When to Contact Support

When a required location or department is missing and you cannot add it.
When filters do not appear despite jobs being posted with correct fields.
When encountering persistent technical errors (e.g., "No results found" for valid entries).

Comprehensive FAQ

1. Why can’t I see my department or location in the filter dropdown?
Departments and locations must be added during job creation. If missing, contact support to add them.

2. Can I remove a country or department from the filter dropdown?
No, you cannot remove default countries or departments from the dropdown. Only unassign jobs from them.

3. Why do filters not appear on my careers page?
Filters only appear if jobs are posted with those fields filled. Check your job postings.

4. Can I restrict applications to a specific location?
No, filters are for sorting after applications are received. You cannot restrict who applies by location ([11027]).

5. How do I add a custom department?
Type the department name in the field and press Enter. If this doesn’t work, contact support ([4141, 4388, 11570]).

6. Why do I see irrelevant countries in the location filter?
PyjamaHR includes all countries by default to support global hiring ([12010]).

7. How do I ensure candidates provide their location?
Make "Current Location" a mandatory field in your application form ([3051, 2377, 963]).

8. Can I filter candidates by state or city?
Yes, if the location is captured in the application form ([10080, 963]).

9. What if the filter isn’t working for some candidates?
Check if the relevant field was made mandatory in the application form. Otherwise, data may be missing ([2377]).

10. Can I customize filters on my embedded careers page?
Advanced users can use the API and custom CSS for embedded job lists ([12010]).

11. Why do some filters show but return no jobs?
If no jobs are assigned to a department/location, the filter will show but yield no results ([1476]).

12. How do I add a new location that isn’t listed?
Contact support with the specific city/state/country you need ([11066, 7659, 5203, 8488]).

13. Can I use filters for bulk actions (e.g., emailing candidates)?
Yes, use filters within a job to segment candidates before sending bulk emails ([2916]).

14. Why do I get "No results found" even for common locations?
This can be a temporary system issue—contact support and try again after a refresh ([80, 1199, 62]).

Career Page Integration: How to integrate your careers page with PyjamaHR
Application Form Customization: Add mandatory fields and screening questions for better filtering.
Candidate Comparison & Export: How to export candidate data
API Documentation: For advanced customization and embedding (API Docs)

Summary Table: Do’s and Don’ts

Do	Don’t
Add departments/locations during job setup	Expect to remove default countries
Make "Current Location" mandatory	Expect filters to restrict applications
Contact support for missing options	Use typos or inconsistent naming
Use filters for sorting and reporting	Assume filters update instantly after edits
Use API for advanced customization

Final Notes

If you encounter persistent issues, always provide screenshots or screen recordings to support for faster resolution.
Regularly review your job postings to ensure filters remain relevant and accurate.
For advanced needs (custom filters, embedded pages), leverage PyjamaHR’s API and consult with your web developer.

Still have questions?
Contact PyjamaHR Support or use the in-app chat for personalized assistance.

This article is based on real customer conversations and is updated regularly to reflect the latest PyjamaHR features and best practices.

How to Display and Use Department or Location Filters on Your PyjamaHR Careers Page