Skip to main content

How to Set Up a Custom Domain or Sub-domain for Your PyjamaHR Careers Page

Updated over 3 weeks ago

Executive Summary

Setting up a custom domain or sub-domain for your PyjamaHR careers page allows you to present a fully branded, seamless candidate experience under your own company’s web address (e.g., jobs.yourcompany.com). This guide covers everything you need to know—from basic iframe integration to advanced white-labeling—so you can showcase jobs on your own site, avoid common pitfalls, and maximize the impact of your recruitment marketing.


Detailed Overview

What Is Custom Domain/Sub-domain Setup in PyjamaHR?

A custom domain or sub-domain setup lets you display your PyjamaHR-powered careers page under your own website’s address, such as careers.yourcompany.com or jobs.yourcompany.com, instead of the default PyjamaHR URL. This can be achieved in two primary ways:

  1. Iframe Integration: Embedding your PyjamaHR careers page within your website using an iframe. This is the standard method and is available to all users.

  2. Full White-labeling & Custom Domain Mapping: For advanced branding (removing PyjamaHR branding, using your own domain for job links, etc.), PyjamaHR offers a custom plan with additional setup and fees.

Why Use a Custom Domain?
- Consistent employer branding
- Improved candidate trust and experience
- Shareable, branded job links (especially important for marketing and social sharing)
- Seamless integration with your existing website

Integration with Other PyjamaHR Features
- All jobs posted in PyjamaHR are automatically reflected on your embedded careers page.
- Candidates apply directly via your branded site, but all applications flow into PyjamaHR for tracking and management.


Step-by-Step Guide: Setting Up a Custom Domain or Sub-domain

Prerequisites

  • Access to your company website’s admin or CMS (e.g., Webflow, WordPress, custom HTML)

  • Admin access to PyjamaHR

  • (For advanced setup) Approval for a custom plan and payment of one-time fees

  1. Get Your PyjamaHR Careers Page Iframe Code
    - Log in to PyjamaHR.
    - Go to Profile > Company Settings > Careers Page.
    - Locate the iframe code provided for integration.
    - (Screenshot: Show where to find the iframe code in the UI)

  2. Embed the Iframe on Your Website
    - In your website builder (e.g., Webflow, WordPress, custom HTML):

    • Add a new section or page (e.g., /careers or jobs.yourcompany.com).

    • Paste the iframe code into the HTML or embed widget.

    • (Screenshot: Example of iframe code pasted into a Webflow embed block)

  3. (Optional) Set Up a Sub-domain
    - In your DNS provider, create a sub-domain (e.g., jobs.yourcompany.com) and point it to your careers page.
    - Use a redirect or configure your web server to serve the careers page at this sub-domain.

  4. Test the Integration
    - Visit your new careers page/sub-domain.
    - Ensure jobs are displaying and applications are flowing into PyjamaHR.

Note: The iframe method displays your careers page within your site, but individual job links will still use PyjamaHR URLs.


Option 2: Full White-labeling & Custom Domain Mapping (Advanced, Custom Plan Only)

If you require:
- Removal of all PyjamaHR branding (“Powered by PyjamaHR”)
- Job links under your domain (e.g., jobs.yourcompany.com/job/123)
- Custom headers/footers or deeper integration

Contact PyjamaHR Support to Request a Custom Plan:
- White-labeling and custom domain mapping are available as a paid add-on (typically a $400 one-time fee; minimum company size and monthly fees may apply).
- Setup takes approximately 2 weeks.
- Minimum requirements: 25 users, custom plan approval.

Process:
1. Contact support via chat or email and specify your requirements (branding removal, custom domain, etc.).
2. Approve the custom plan and pay the one-time fee.
3. Work with the PyjamaHR team to configure DNS and domain mapping.
4. PyjamaHR will handle the technical setup and notify you when your careers page is live under your custom domain.


Advanced Usage & Best Practices

  • Brand Consistency: Use the iframe method to match your careers page styling with your main website. For full control, opt for the custom plan.

  • Webflow & Other CMS: Use the HTML embed widget to insert the iframe. For advanced branding, consult your web developer.

  • Single Job Links: Note that with iframe integration, individual job links will still use PyjamaHR URLs. Only full white-labeling supports branded job URLs.

  • Multiple Subsidiaries: Use sub-domains (e.g., us.yourcompany.com, jobs.yourbrand.com) for different business units or regions.

  • Hide Headers/Branding: Some elements (like headers or “Powered by PyjamaHR”) can be hidden via custom code or with a paid plan.

Do’s:
- Always test your careers page after integration.
- Communicate with PyjamaHR support for custom requirements.
- Use descriptive sub-domains (e.g., careers., jobs., apply.) for clarity.

Don’ts:
- Don’t use simple URL forwarding—it can cause issues with candidate experience and tracking.
- Don’t attempt to remove branding without PyjamaHR’s approval if you’re not on a custom plan.


Troubleshooting & Common Issues

Issue: I can’t find the iframe code.
- Solution: Go to Profile > Company Settings > Careers Page in PyjamaHR.

Issue: The iframe isn’t displaying jobs.
- Solution: Ensure the iframe code is correctly pasted and your jobs are published in PyjamaHR.

Issue: “Powered by PyjamaHR” branding is visible and I want it removed.
- Solution: Branding can only be removed with a custom plan (one-time fee applies).

Issue: Individual job links are not under my domain.
- Solution: Only possible with full white-labeling/custom domain mapping.

Issue: Candidates report issues with forwarding/redirects.
- Solution: Use iframe embedding, not simple URL forwarding.

Issue: Need to set up for a subsidiary or different region.
- Solution: Use a sub-domain for each business unit.

When to Contact Support:
- For full white-labeling, custom domain mapping, or branding removal.
- If iframe integration isn’t working as expected.
- For advanced DNS or technical setup.


Comprehensive FAQ

1. Can I use my own domain or sub-domain for the careers page?
- Yes, via iframe integration or full white-labeling (custom plan).

2. Where do I find the iframe code?
- Profile > Company Settings > Careers Page in PyjamaHR.

3. Can I remove “Powered by PyjamaHR” branding?
- Only with a custom plan (one-time fee, contact support).

4. Can I have job links under my domain (e.g., jobs.mycompany.com/job/123)?
- Only with full white-labeling/custom domain mapping.

5. How do I set this up in Webflow?
- Use the HTML embed widget to paste the iframe code.

6. Can I use a sub-domain for a subsidiary or different region?
- Yes, set up a sub-domain and embed the iframe or request a custom domain mapping.

7. What’s the cost for full white-labeling?
- Typically $400 one-time fee; minimum company size and monthly fees may apply.

8. How long does custom domain setup take?
- Approximately 2 weeks after approval and payment.

9. Can I share individual job links under my domain?
- Only with full white-labeling/custom domain mapping.

10. What if I have issues with iframe display or job visibility?
- Double-check the code, ensure jobs are published, and contact support if needed.

11. Can I customize the look and feel of the embedded careers page?
- Limited customization with iframe; full customization with custom plan.

12. Is simple URL forwarding recommended?
- No, it can cause issues. Use iframe embedding or custom domain mapping.


Related Features & Next Steps

  • Bulk Emailing Candidates: Use PyjamaHR’s bulk email flow for outreach.

  • Scheduling Interviews: Integrate with PyjamaHR’s scheduling features (note: some features may be in beta).

  • Candidate Data Export: Use the Compare view to download candidate data.

  • Further Customization: Contact support for advanced branding or integration needs.


Still have questions?
Contact PyjamaHR Support via chat or email for personalized assistance with your custom domain or sub-domain setup.


This article is based on real customer scenarios and PyjamaHR’s latest capabilities as of June 2024. For the most up-to-date information, always consult your PyjamaHR dashboard or reach out to support.

Did this answer your question?