Executive Summary
Setting the correct job location in PyjamaHR is crucial for attracting the right candidates and ensuring your job posts appear on relevant job boards. This guide covers everything you need to know about specifying job locations—whether remote, hybrid, in-office, or across multiple locations—based on real customer scenarios and the latest platform updates. Learn step-by-step workflows, avoid common pitfalls, and resolve issues quickly to maximize your hiring reach.
Detailed Overview
What is the Job Location Feature?
The job location field in PyjamaHR determines where your job is advertised, who sees it, and which job boards it appears on. You can set roles as:
- In-office: Specific city/state/country required.
- Remote: Country-level only (city/state not supported for remote roles).
- Hybrid: Combination of in-office and remote, city-level required.
- Multiple Locations: Post the same job in several cities/countries.
Why It Matters:
- Ensures your job reaches the right talent pool.
- Controls job board distribution (some boards require specific location formats).
- Filters candidate applications by location.
- Impacts job visibility and compliance with job board policies (e.g., LinkedIn, ZipRecruiter).
Integration with Other Features:
- Job Board Publishing: Location determines where your job is posted externally.
- Candidate Filtering: Location fields help filter applicants.
- Screening Questions: Use as a workaround for location-specific requirements.
- API & Career Page Integration: Location data is used in job feeds and embeds.
Step-by-Step Guide: Setting Job Location in PyjamaHR
Prerequisites
Ensure your account plan supports the desired location (free plan: India only; premium: international).
Have the exact city/state/country ready.
For remote jobs, know the country (city/state not supported).
1. Creating a New Job Posting
A. Choose Job Type
In-office: Select this for roles requiring physical presence.
Remote: For fully remote roles (country-level only).
Hybrid: For roles with both remote and in-office requirements (city-level required).
B. Entering the Location
For In-office:
1. In the "Location" field, start typing the city name (e.g., "Bangalore").
2. Select from the auto-suggested dropdown (shows City, State, Country).
- Screenshot suggestion: Show location dropdown with city/state/country.
3. If the city is missing, contact support to have it added (see troubleshooting).
For Remote:
1. Toggle the "Remote" option ON.
2. In the "Location" field, type and select the country only (e.g., "India", "USA").
- Note: You cannot select a city or state for remote jobs.
- Screenshot suggestion: Show remote toggle and country selection.
For Hybrid:
1. Select "Hybrid" as the job type.
2. Enter the specific city (not just the country).
- Screenshot suggestion: Show hybrid selection and city dropdown.
For Multiple Locations:
1. When creating the job, look for the "Add another location" or "+" button.
2. Add each city/country as needed.
- Screenshot suggestion: Show multiple locations being added.
2. Editing an Existing Job Location
Go to the job listing, click "Edit".
Update the location field as per the above steps.
For remote/hybrid, ensure you follow the correct format (country for remote, city for hybrid).
3. Special Cases & Workarounds
If your city/state is missing: Contact support with the exact name (e.g., "Kota, Rajasthan"). The team can add it, usually within 24-48 hours.
If you need to specify a region for remote jobs: Mention the region/city in the job description and add a screening question (e.g., "Do you currently live in Bangalore?").
Cloning jobs for multiple countries: Use the "Clone Job" feature to quickly create similar postings for each location.
Advanced Usage & Best Practices
Power User Tips
Multiple Locations: For roles open in several cities/countries, add each as a separate location to maximize reach.
Hybrid Roles: Always specify the city, not just the country, for hybrid jobs.
Remote with Regional Restriction: Since only country is supported, highlight the required region in the job description and use a screening question to filter.
API Integration: Use the jobs API to fetch or display jobs with location data on your website. Custom CSS can be applied if embedding job lists.
Optimization Strategies
Job Description Clarity: Clearly state location expectations (e.g., "Remote—India only" or "Hybrid: 3 days/week in Mumbai office").
Screening Questions: Add location-based questions to filter candidates more effectively.
Job Board Compliance: Avoid using non-standard location formats (e.g., "EMEA", "Worldwide") as some job boards (like LinkedIn) do not support these via ATS integration.
Do’s and Don’ts
Do:
- Use the dropdown suggestions for location to ensure correct formatting.
- Contact support if a location is missing.
- Use screening questions for additional location filtering.
Don’t:
- Try to enter unsupported formats (e.g., city for remote jobs).
- Expect to select regions or continents as locations (not supported).
- Ignore job board requirements—incorrect location formats may prevent posting.
Troubleshooting & Common Issues
Common Error Messages & Solutions
Error Message / Issue | Cause | Solution |
"No results found" in location dropdown | City/state/country not in database or temporary system issue | Try alternate spelling, check for typos. If still missing, contact support to add the location. |
Cannot select city for remote job | Remote jobs only support country-level location | Enter the country, and specify city/region in job description or via screening question. |
Location dropdown not working at all | System bug or outage | Refresh browser, clear cache, try again. If unresolved, contact support—issue is usually fixed within hours. |
Only previous locations appear, can't add new ones | Temporary bug or cache issue | Hard refresh browser, try incognito mode. If persists, contact support. |
Location filter includes unwanted countries | Global product design | Cannot remove countries from dropdown; use screening questions to filter candidates. |
Unable to post jobs for international locations on free plan | Plan limitation | Upgrade to premium plan to access international job posting. |
What If Scenarios
City not found: Contact support with the exact city/state/country.
Need to post in multiple countries: Clone the job for each country.
Remote job but need city restriction: Use job description and screening questions.
Location dropdown not loading: Try hard refresh; if unresolved, report to support.
When to Contact Support
Location missing from dropdown after checking spelling.
Location dropdown not working for all jobs.
Need to add a new city/state/country.
System errors persist after refresh.
Comprehensive FAQ
1. Why can’t I select a city for a remote job?
Remote jobs only support country-level location. Specify the city/region in the job description and use screening questions to filter candidates.
2. How do I add multiple locations to a job?
Use the "Add another location" option when creating/editing a job. For multiple countries, clone the job for each country.
3. My city/state/country is missing from the dropdown. What should I do?
Contact support with the exact name. The team can add it, usually within 24-48 hours.
4. Why does the location dropdown show “No results found”?
This could be due to a typo, unsupported location, or a temporary system issue. Double-check spelling and try again later. If unresolved, contact support.
5. Can I specify a region (e.g., EMEA, Worldwide) as a location?
No. Job boards like LinkedIn do not support such locations via ATS integration. Use country or city as required.
6. Why can’t I post jobs outside India on the free plan?
International job posting is only available on the premium plan.
7. How do I set up a hybrid job location?
Select "Hybrid" and enter the specific city (not just the country).
8. Can I filter candidates by country or state?
Filtering is based on city and country. For more granular filtering, use screening questions in the application form.
9. How do I handle confidential locations?
For in-office roles, you must specify a city. If confidentiality is needed, mention this in the job description and discuss with support for possible workarounds.
10. What if the location dropdown is not working for anyone in my company?
This may be a system-wide issue. Contact support immediately; such issues are typically resolved quickly.
11. Why do I see locations from other countries in the filter when all my jobs are in one country?
The dropdown is global and cannot be customized per account. Use screening questions to further filter candidates.
12. Can I use custom CSS for embedded job lists on my website?
Yes, if you use the API to fetch job lists, you can apply your own CSS.
Related Features & Next Steps
Screening Questions: Add location-based questions to filter candidates.
Job Board Publishing: Understand how location affects external job board visibility.
API Integration: Use the jobs API for custom career page displays.
Career Page Integration: Embed jobs with correct location data on your website.
Cloning Jobs: Quickly create similar jobs for multiple locations.
Recommended Articles:
- How to Import Candidates via Excel/CSV
- Career Page Integration Guide
- How to Export Candidate Data
Summary Table: Supported Location Types by Job Mode
Job Mode | Location Field Supports | Notes |
In-office | City, State, Country | Must select specific city. |
Remote | Country only | City/state not supported. |
Hybrid | City, State, Country | Must select specific city. |
Multiple | Add multiple cities/countries | Use "Add another location" or clone jobs. |
Final Tips
Always use the dropdown suggestions for locations.
For remote jobs with regional restrictions, communicate clearly in the job description and use screening questions.
If you encounter issues, try a hard refresh and check for typos before contacting support.
Keep your plan limitations in mind—upgrade if you need international posting.
By following these guidelines, you’ll ensure your jobs are visible to the right candidates, on the right platforms, every time.
Still have questions? Contact PyjamaHR Support with your specific location and job details for personalized assistance.