Skip to main content

How to Enable and Integrate Your Hosted Career Site with PyjamaHR: The Complete Guide

Updated over 3 weeks ago

Executive Summary

The PyjamaHR hosted career site lets you showcase all your open positions on a branded, easy-to-manage web page—either on a PyjamaHR-hosted URL or seamlessly embedded within your company website. This guide walks you through enabling your career site, integrating it with your domain, and optimizing the candidate experience, so you can attract more applicants and streamline your hiring process.

Detailed Overview

What Is the Hosted Career Site?

The hosted career site in PyjamaHR is a ready-to-use web page that automatically lists all your active job openings. You can:

  • Use the default PyjamaHR-hosted URL (e.g., https://app.pyjamahr.com/careers?company=YourCompany)

  • Embed your job listings directly into your company’s website using an iframe

  • Customize the look and feel (to a degree) and even use your own subdomain with proper integration

Why Use It?
- Centralizes all open roles for candidates
- Automatically updates as you add, edit, or close jobs in PyjamaHR
- Streamlines application flow—candidates apply directly, and their profiles appear instantly in your ATS
- Reduces manual work and ensures a consistent employer brand

Integration with Other Features
- All applications from the career site flow directly into PyjamaHR
- Social sharing tools allow you to promote jobs from the career site to platforms like LinkedIn and Facebook
- API options for advanced customization and automation

Step-by-Step Guide: Enabling and Integrating Your Hosted Career Site

Prerequisites

  • You must be an Admin or have access to Settings

  • Your company profile should be set up in PyjamaHR

  • For website integration, you’ll need access to your website’s code or CMS (e.g., Webflow, WordPress, etc.)

1. Access the Career Page Settings

  1. Log in to your PyjamaHR account.

  2. Click your Profile Icon (top right).

  3. Go to Settings > Career Page.

Screenshot suggestion: Show navigation to Settings > Career Page.

2. Enable Your Hosted Career Site

  • By default, your career site is enabled and available at a PyjamaHR-hosted URL.

  • Copy your unique career page link (e.g., https://app.pyjamahr.com/careers?company=YourCompany&company_uuid=XXXX).

Screenshot suggestion: Highlight the career page URL and iframe code area.

3. Integrate the Career Site with Your Company Website

A. Embed Using Iframe (Most Common Method)

  1. In the Career Page settings, locate the iframe code provided.

  2. Copy the entire iframe snippet.

  3. Paste the iframe code into the HTML of your website where you want the job listings to appear.
    - For Webflow, use an Embed element.
    - For WordPress, use a Custom HTML block.

  4. Save and publish your website changes.

Example iframe code:

<iframe src="https://app.pyjamahr.com/careers?company=YourCompany&company_uuid=XXXX&isHeaderVisible=false&is_careers_page=true" frameborder="0" scrolling="yes" seamless="seamless" style="display:block; width:100%; height:100vh;"></iframe>

Screenshot suggestion: Show copying the iframe code and pasting into a website editor.

B. Use a Custom Domain or Subdomain

  • You can point a subdomain (e.g., jobs.yourcompany.com) to your career site by embedding the iframe on a page under that subdomain.

  • Note: PyjamaHR does not currently support direct white-label hosting or DNS mapping. All custom domain setups require embedding the iframe on your own site.

C. Advanced: Use the Career Page API

  • For full design control, use the PyjamaHR Career Page API to fetch job data and build a custom job board.

  • You’ll need a developer and an API token (provided in your settings or by support).

  • This method allows you to style listings and application forms as you wish.

4. Verify Integration

  • Visit your company website and check the embedded career page.

  • Click on job listings to ensure the application flow works.

  • All jobs you publish in PyjamaHR should appear instantly.

5. Optional: Remove PyjamaHR Branding

  • By default, the embedded career site displays "Powered by PyjamaHR."

  • Removal is available as a custom paid option (one-time fee, e.g., $400). Contact support for details.

Advanced Usage & Best Practices

Power User Tips

  • Custom Styling: The iframe method has limited CSS customization. For full control, use the API.

  • Header/Menu Conflicts: If your website already has a header, use the isHeaderVisible=false parameter in the iframe URL to hide the PyjamaHR header.

  • Single Job Links: The iframe method does not support direct links to individual jobs. For this, use the PyjamaHR-hosted career page URL or the API.

  • Location Filters: All countries appear in the location filter by default; this cannot be customized currently.

  • Social Sharing: Share jobs directly from PyjamaHR to social media for broader reach.

Do’s and Don’ts

Do:
- Always copy the full iframe code without extra spaces.
- Test the integration on both desktop and mobile.
- Contact support for API tokens or advanced needs.

Don’t:
- Don’t try to map jobs from your website to PyjamaHR (reverse integration is not supported).
- Don’t attempt to remove branding via CSS hacks—use the official custom option.

Troubleshooting & Common Issues

Common Problems and Solutions

Issue

Solution

Iframe not displaying jobs

Ensure you copied the correct iframe code from PyjamaHR. Double-check the company_uuid and remove any extra spaces.

404 Error on career page

Confirm the company UUID and URL are correct. If issue persists, contact support with a screenshot.

CORS error when using API

API calls must be made from the backend/server, not directly from the browser. Contact support to whitelist your domain if needed.

Unable to style iframe

Styling is limited. For full customization, use the API.

PyjamaHR logo/branding visible

Branding can only be removed via a paid custom option. Contact support for pricing.

Jobs not appearing on website

Make sure all jobs are published and the iframe is correctly embedded. Refresh the page and clear cache.

Cannot remove certain countries from location filter

This is not currently supported. All countries are shown by default.

Want to use a custom domain

Embed the iframe on a page under your own subdomain (e.g., jobs.yourcompany.com). Direct DNS mapping is not supported.

When to Contact Support

  • Persistent 404 or integration errors

  • Need for API tokens or advanced API help

  • Requesting branding removal

  • Custom integration requirements

Comprehensive FAQ

1. Can I embed my PyjamaHR career site on my company website?
Yes, use the iframe code from Settings > Career Page.

2. How do I get the iframe code?
Go to Settings > Career Page in PyjamaHR. Copy the provided code.

3. Can I use my own domain or subdomain (e.g., jobs.mycompany.com)?
Yes, by embedding the iframe on a page under your domain. Direct DNS mapping is not supported.

4. Can I customize the look and feel of the embedded career site?
Limited customization is possible with the iframe. For full control, use the API.

5. How do I remove the "Powered by PyjamaHR" branding?
Contact support for a paid custom branding removal option.

6. Why are jobs not showing up on my website?
Ensure jobs are published and the iframe code is correct. Double-check for extra spaces or incorrect UUIDs.

7. Can I link directly to a single job?
Not via the iframe. Use the PyjamaHR-hosted career page URL for direct job links.

8. Why does the location filter show countries I don’t hire in?
All countries are shown by default; this cannot be customized currently.

9. Can I use custom CSS to style the embedded job listings?
Not with the iframe. Use the API for full styling control.

10. What if I get a CORS error when using the API?
API calls must be made from your server, not the browser. Contact support if you need your domain whitelisted.

11. Can I automate job posting from my website to PyjamaHR?
No, jobs must be created in PyjamaHR to appear on your career site.

12. How do I change my company name or career page branding?
Update company details in Settings > Company Details. For branding changes, contact support.

13. Can I hide certain jobs from the career page?
No, all published jobs appear on the career page. To hide a job, unpublish it in PyjamaHR.

14. How do I share jobs on social media?
Use the "Share with Social Media" button in the job posting view.

15. What if the iframe code doesn’t work in my CMS (e.g., Webflow, WordPress)?
Use the platform’s HTML/embed widget. If issues persist, contact your web developer or PyjamaHR support.

Related Features & Next Steps

  • Job Publishing: All jobs published in PyjamaHR appear on your career site automatically.

  • Social Media Sharing: Promote jobs directly from PyjamaHR.

  • API Integration: For advanced customization and automation.

  • User Access Management: Control who can manage jobs and career site settings.

  • Branding Customization: Paid option to remove PyjamaHR branding.

Recommended Next Steps:
- Review and update your company profile and branding in PyjamaHR.
- Embed your career site on your company website.
- Explore API documentation for advanced needs.
- Contact support for custom branding or integration help.

Related Help Articles:
- Career Page Integration
- Understanding Access Types
- API Documentation

Summary Table: Key Actions

Task

Where to Find

Who Can Do It

Get career page URL/iframe

Settings > Career Page

Admin/Super Admin

Embed on website

Website HTML/CMS

Web Admin/Developer

Remove branding

Contact Support

Admin/Super Admin

Use API

API Docs, Support

Developer

Still have questions?
Contact PyjamaHR support via chat or email for personalized help with your career site integration.

This article is based on real customer questions and scenarios to ensure you have everything you need to successfully enable and integrate your hosted career site with PyjamaHR.

Did this answer your question?