Your careers page

How published jobs appear on your website, the automatic careers page, placing a job list anywhere with a block or shortcode, and changing the job URL base.

The moment you publish your first job, your site has a working careers page. You do not have to build anything. This page explains what you get automatically, how each job also gets its own page, and how to drop a job list onto any other page of your site.

Where your jobs appear

Publishing a job lists it on your careers page automatically. The careers page is the public list of your open roles, living on your own website with your theme’s header and footer, so it looks like the rest of your site. It shows every published job that has not passed its closing date, under the page’s own title (“Careers” unless you named it something else during setup).

Vakanssi creates this page for you during setup. Jobs appear here when you publish them and disappear when they close. There is nothing to configure.

Since v0.35.3, a job you protect with a password is left off this list and out of its role count, since it is meant to be private. See Creating and publishing a job.

Since v0.33.7, the list also splits into pages of 20 roles once you have more than that many open at once, so nothing past the newest 20 stays hidden. Sites with 20 or fewer open roles see no change.

Since v0.33.10, the page links below the list show where you are, for example “Showing 21–40 of 112 roles” and “Page 2 of 6”, with round Previous and Next buttons instead of a row of page numbers.

Visitors can narrow the list without leaving the page. Across the top of the listing is a small toolbar with:

• A search box to type a keyword and match roles by title, team, location, employment type, or “Remote” / “Hybrid”.
• A team filter to show only one department’s openings. It appears once the listed roles span more than one team.
• A remote-only toggle to hide roles that require an office.
• A sort control to reorder the list.

Since v0.33.8, the search box, team filter, and remote toggle cover every page of a split listing, not only the one a visitor happens to be on. The first search or filter quietly loads the other pages in the background, so a matching role never reads as “no roles match your filters” just because it sits on page two.

An Apply button on the list

Since v0.33.3, you can add an Apply button to every eligible role right in the list, so a candidate can go straight to the application form instead of opening the job first. It is off by default. Turn it on under Hiring, then Settings, then Jobs & Careers, in the Careers listing card.

A role that is closed, or whose applications have not opened yet, never shows the button: the list and the job’s own page always agree on whether a role can be applied to.

Each job gets its own page

Every published job also has its own page, reached by clicking it from the careers list. That page shows the full description, a facts table (location, workplace, employment type, salary, closing date), and the application form.

By default, Vakanssi renders this page with its own clean, branded layout: just the title and the job content, no theme sidebar, comments, or “related posts” list dragging a job page down to look like a blog post. It works this way on any theme, with nothing to set up.

Since v0.32.16, this page and the careers list above both match your active theme’s own content width when the theme publishes one (most block themes, and classic themes such as Astra, Kadence, GeneratePress, and Hello Elementor, do), so a job no longer looks narrower than the careers page a click earlier. A theme that does not publish a width keeps the previous, fixed column.

On a block theme (Twenty Twenty-Five and similar), this layout is already an editable Site Editor template. Restyle it under Appearance, then Editor, with no setting to change. An Elementor Pro Theme Builder Single template with a matching condition also takes over automatically, nothing to switch.

If you build your own single job page with Divi or Oxygen instead, switch Page layout to my theme’s template under Hiring, then Settings, then Jobs & Careers, in the Job page card, and hand the layout back to your theme or builder. See Settings reference and Elementor, Divi, and block themes.

The job URL base

Single job pages live under a shared web address, called the job URL base. By default that is a slug (a short, web-friendly word) like jobs, so a role sits at an address such as example.com/jobs/senior-php-engineer/.

You can change this word in Hiring, then Settings, then Jobs & Careers, in the Job URLs card. If your site already uses jobs for something else, or you simply prefer a different word (for example, positions or careers), set it here and Vakanssi rebuilds your job links to match.

On a fresh site, connecting or creating a careers page during the setup wizard moves the job URL base to match that page automatically, so example.com/careers/ lists your jobs and example.com/careers/senior-php-engineer/ opens one, one address instead of two. If jobs are already published under a different address, Vakanssi leaves it alone; change it here yourself if you want them to match.

Placing a job list on any other page

You are not limited to the automatic careers page. You can show a job list anywhere on your site, for example on your homepage or on a specific team’s page. There are two built-in ways that work on every site, plus a native element if your site uses a page builder. All of them produce the same list.

The Job Listings block. In the WordPress block editor, click the + button to add a block, search for “Job Listings”, and insert it. This is the simplest option and needs no typing.

The shortcode. A shortcode is a small bracketed tag you paste into a page, which WordPress replaces with real content when the page is viewed. Vakanssi’s is:

[vakanssi_jobs]

Add it through a Shortcode block, or drop it into any page or post. When the page is viewed, you get the same live list of open jobs as your careers page. For a full listing, use a page rather than a post (see below).

A page-builder element. If your site uses Elementor or the Divi Builder, you also get a native Vakanssi Jobs element: add it from the builder’s element list (in Elementor, search the widget panel for “jobs”; in Divi, add the “Vakanssi Jobs” module) and pick the layout, teams, and visible details in its settings, no typing needed.

The published page shows the same list as the block and the shortcode. In Divi’s Visual Builder the module shows a placeholder box instead of a live preview; the real list appears on the published page. See Elementor, Divi, and block themes for the full picture, including custom archive and single-job templates.

On a page, this list paginates by default, just like the automatic careers page: more roles than fit on one page (20 unless you change it) get page links instead of disappearing. In a post it never paginates, so roles past the first 20 (or your limit) do not show.

For a short, fixed-size teaser instead, for example three roles on your homepage, turn off Split into pages on the block, or add paginate="false" to the shortcode.

Next steps