Some themes may not be fully compatible with single job pages, usually due to the structure of a theme’s
In order to work, WP Job Manager requires the single template to contain:
- Content being output via the_content() function (see https://codex.wordpress.org/Function_Reference/the_content)
- A valid ‘loop’ (see http://codex.wordpress.org/The_Loop)
Most themes adhere to this convention, as it’s a commonly accepted approach. You can look at the default WordPress themes, like Twenty Twenty-Three, for a reference.
Determining if the issue is the theme
To confirm whether or not an issue is due to a theme, switch your site’s theme to a default theme included with WordPress such as Twenty Twenty-Three or Storefront, then see if the issue persists. If everything works as expected, the issue is the theme.
To ensure compatibility, WP Job Manager and its add-ons are optimized for the most recent default WordPress theme and Storefront. This makes either option a great choice for troubleshooting issues linked to other themes.
Fixing your single template
Think of jobs as a special category of posts. This lets us tap into WordPress’s built-in system for organizing templates.
Creating a New Theme Template File
- Navigate to your theme’s directory on your site.
- Create a new template file named
- To start, you can duplicate the contents from
page.phpinto this new file. This ensures your job listings maintain the look and feel of your theme.
Customizing the Theme Template File
- Feel free to modify its content: remove sections, add new code, or adjust as needed.
- Ensure you have a valid loop in place to display the job details.
A valid loop
Below is a sample loop that includes both a heading and content. By incorporating a similar structure, your job listings should display as intended.
<?php while ( have_posts() ) : the_post(); ?> <h1 class="entry-title"><?php the_title(); ?></h1> <div class="entry-content"> <?php the_content(); ?> </div><!-- .entry-content --> <?php endwhile; // end of the loop. ?>
Sometimes it’s hard to figure out which template file is used on a page. You can try using a plugin such as What the file to figure out the template that is used.
Once you know the template that is used, you can try overriding the template you need to change. Please check out this tutorial for overriding WP Job Manager templates.
Although Elementor is not a theme but a plugin, it’s often mentioned with theme-related questions. WP Job Manager doesn’t fully support Elementor.
Although Divi is a plugin rather than a theme, we can’t guarantee WP Job Manager will be fully compatible with Divi.
While WPBakery is a plugin like Elementor rather than a theme, we can’t guarantee that WP Job Manager will be fully compatible with WPBakery.
Gutenberg block editor
Since WP Job Manager was built with frontend usage in mind, we haven’t made it fully compatible with the block editor, yet. We recommend adding jobs using the frontend form. However, if you decide to use WP-Admin, job post content will be added as a classic block.
Themes with Full-site Editing (FSE)
WP Job Manager is not 100% compatible with Themes using Full-site Editing (FSE), so you cannot customize the Job Manager template pages using FSE. You can use the WP Job Manager with Block Themes instead.
Themes that bundle our WPJM add-ons are not supported by us and cause unexpected issues.