Some themes don’t play nice with single job pages. This is usually down to a highly custom, or poorly coded, single.php template.
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)
The majority of themes do this just fine – its the standard way of doing things. Just refer to the default WordPress themes (Twenty Twelve for example) to see how things should be done.
Determining if the issue is the theme
To check the theme is actually causing the issue, simply change to the Twenty Twentyone theme included with WordPress, or Storefront theme, and see if things look correct. We always make sure WP Job Manager and its add-ons work with the latest default WordPress theme and the Storefront, so they are great for troubleshooting the issues that may be caused by other themes.
Fixing your single template
First things first, understand that jobs are just a custom post type. That means we can use the template hierarchy to our advantage.
If you create a template file in your theme called single-job_listing.php, it will always be used for jobs. As a starting point, you can copy the contents of single.php or page.php into this file so it contains the html your theme uses.
Now you can customise your single-job_listing.php. Remove code, add code, add a valid loop.
A valid loop
Here is an example of a valid loop, complete with heading and content:
<?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. ?>
As long as you have something like the above, job listings will be output as intended.
Which template?
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.
Elementor
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.
Divi
Although Divi is a plugin rather than a theme, we can’t guarantee WP Job Manager will be fully compatible with Divi.
WPBakery
While WPBakery is a plugin like Elementor and Divi and not 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.