View Categories

WordPress iFrame

Table of Contents

The PCRecruiter Extensions plugin offers two ways to display your PCRecruiter jobs on your WordPress site. Choose the method that best fits your needs:

  • iFrame Embed – Quick and simple, embeds PCRecruiter’s job board by placing a pcrecruiter.net window into the page. All functionality and styling are controlled within PCR. The job search and listings are displayed within a single page on the WordPress site. Seamless to the jobseeker, easy to implement, but results in less friendly job URLs and sharing or SEO options.
    • The plugin also offers an RSS Feed feature, which periodically downloads an XML file of the current job openings into WordPress’s upload folder. This can be useful for pulling job data out for manipulation when not using the full sync function.
  • Full Job Sync – Advanced integration that syncs jobs to WordPress with searchable job pages. The job search and listings are handled by WordPress and are fully matched to the theming and structure of the website. More involved configuration and setup, but greater control and SEO capabilities. The ‘apply’ steps remain handled via iframe.
  • Custom Forms – The plugin can also embed Custom Forms, which are one-way registration forms to add contacts to the database or to trigger an iframe mode job search.

Installation #

  1. Install from WordPress.org:
  2. Or install via upload:

iFrame Method (Basic) #

If you are looking for information on the full API sync with WordPress, see this document.

The iFrame Embed method displays your PCRecruiter Job Board inside an inline frame on your WordPress page — essentially a sub-browser window inside of the careers page. The job board remains hosted entirely on PCRecruiter’s servers, and the plugin simply shows that content in an auto-sized block on the page of your choosing.

In this setup, all of the individual job links will begin with your given page URL (mysite.com/careers/) followed by a long encoded string that tells PCR’s frame which job to load. This can lead to some drawbacks in regards to SEO and link sharing, but is a very simple and effective method of placing the job board into the site with minimal effort.

1. Work with PCR to configure your Job Board #

Because the job board in the iframe setup is entirely handled on the PCRecruiter servers, the first step will be to work with your PCR account team to get the job board configured to show the data you intend it to and styled to match your website. Configuring the PCR side of this integration requires an administrator-level login to PCRecruiter.

2. Create / Edit Your Jobs Page #

  1. Go to Pages → Add New or Edit your existing careers page.
  2. Add the shortcode to the page content:
[PCRecruiter link="YOUR-DATABASE-ID"]

Replace YOUR-DATABASE-ID with your actual database ID, which is typically the name of the database followed by a period and the account ID. (e.g. Recruiting%20Database.RecruitingAgency)

  1. Click Publish

3. View Your Job Board #

Visit the page you just created – you should see your PCRecruiter job board embedded in the page.

Notify your PCRecruiter representative that the job board has been published so that the live URL can be logged in the Job Board Landing Page settings and added to the list of active job boards. If your Landing Page URL changes, you will need to update it in System >> Job Board >> Landing Pages for your URLs to function properly.

iFrame Troubleshooting #

  • If the iframe appears but shows says “invalid database”, verify that you have the correct database ID. If it looks correct, switch to “Code editor” view in WordPress and make sure that no HTML tags or unexpected characters appear in the shortcode.
  • The plugin automatically attempts to prevent optimization plugins (WP Rocket, Autoptimize, LiteSpeed Cache, Perfmatters, WP-Optimize, Asset CleanUp, FlyingPress, WP Fastest Cache) from applying defer/delay, lazy loading, asset blocking, and script minification/combination to its iframe or javascript. These behaviors can prevent the PCR iframe from loading content. If your iframe still doesn’t load after enabling an optimization plugin, clear all caches (WordPress, optimization plugin, and browser), test in an incognito/private browser window, check your browser’s console (press F12) for JavaScript errors. Contact your WordPress designer or PCR support for additional help.

Custom Forms #

To use the plugin for embedding a Custom Form, append the ‘form=’ parameter with the ID of the form.

[PCRecruiter link="YOUR-DATABASE-ID" form="123"]

Optional RSS Feed #

The RSS Feed feature loads the dynamic XML feed of your job data from the PCRecruiter system and stores it as a static file in your WordPress site. This is completely optional and separate from the iFrame or Full Sync methods.

This is typically used in cases where the iFrame method is being used for embedding the PCR Job Board, but the job data or URLs need to be parsed by some feature in WordPress, such as an import utility, featured listings widget, etc.

1. Get Your PCR SessionID #

Contact PCRecruiter support to have a Session ID generated for you.

2. Enable the Feed #

  1. Go to Settings → PCRecruiter Extensions
  2. Find “PCRecruiter Feed Settings”
  3. Check the “Job Feed Enabled” box
  4. Paste your PCR SessionID in the text field

3. Configure Update Frequency #

Choose how often the feed refreshes. These settings use WordPress’s built-in timing (WP Cron) and can vary based on traffic to the site. The given timings are general.

  • Hourly – Best for high-volume hiring
  • Daily – Recommended for most users (less server load)
  • Twice Daily – Good balance

Use the Update Feed Now button to trigger an immediate download without waiting for the next automated sync.

4. Configure Fields and Query (Advanced) #

The query and fields are passed through the PCRecruiter API and converted to XML. This utility is limited solely to the Positions endpoint and cannot retrieve contacts, users, or other data outside of the job record. The fields and queries follow the API documentation.

Standard Fields: Enter comma-separated field names such as:

PositionId,JobTitle,City,State,JobType,MinSalary,MaxSalary

Custom Fields: Add any Position Custom Fields from your PCRecruiter database:

CustomField1,CustomField2

Query: Filter which jobs appear in feed. 

Status eq Available and ShowOnWeb eq true and (NumberOfOpenings ne 0 OR NumberOfOpenings eq '')

Mode:

  • Job Link – The links in the feed go to job detail pages
  • Apply Link – The links skip the detail and go directly to apply steps

5. Save Settings #

Click “Save Changes” at the bottom of the page.

Once enabled, your job feed XML is available at:

https://yourwebsite.com/wp-content/uploads/pcrjobfeed.xml

The plugin also generates a JSON format at:

https://yourwebsite.com/wp-content/uploads/pcrjobfeed.json

Plugin Deactivation #

When you deactivate the PCRecruiter Extensions plugin, you’ll be presented with a modal dialog offering options to control what happens to your data:

Settings Options:

  • Keep Settings (recommended for temporary deactivation) – Preserves all plugin configuration including API tokens and templates
  • Delete Settings – Removes all plugin configuration

Job Postings Options: (Full Sync Method)

  • Keep Job Posts (recommended) – Preserves all synced jobs in WordPress
  • Delete All Job Posts – Permanently removes all job postings and their metadata

RSS Feed Files Options: (Optional RSS)

  • Keep RSS Feed Files – Preserves pcrjobfeed.xml and pcrjobfeed.json
  • Delete RSS Feed Files – Removes feed files from uploads folder

For destructive options (deleting settings, jobs, or RSS files), you must type “DELETE” to confirm. This cleanup process helps maintain a clean WordPress installation while giving you control over data retention.

Troubleshooting #

iFrame Issues #

  • Verify that the shortcode has been entered correctly. If your WordPress supports it, use the ‘Shortcode’ block. If you are inserting the shortcode into an editor, use the ‘Source’ or ‘Text’ view to make sure no extra characters have been inserted in the middle of the shortcode.
  • Although PCR’s plugin will attempt to prevent this, some page optimization plugins (LightSpeed, WP Rocket, etc.) can ‘defer’ or ‘lazy load’ the iframe and javascript. Check the settings for these plugins and exempt pcrecruiter.net content or the jobs page itself from these functions.