Appearance
Shortcodes
The Recruitly plugin provides shortcodes for embedding job listings, search forms, and widgets on any page or post. No coding required — paste a shortcode into any WordPress editor and it renders automatically.
Job Listings
Job List
Displays a filterable list of all published jobs. Typically placed on your main "Jobs" page.
[recruitly_jobs]Works alongside the search form — when a visitor searches, this shortcode filters automatically.
Recent Jobs
Shows the most recently published jobs. Great for homepage widgets or sidebar content.
[recruitly_jobs_recent count=5]| Parameter | Default | Description |
|---|---|---|
count | 5 | Number of jobs to display |
Job Count
Displays the total number of live jobs. Useful for marketing copy ("Browse our 247 open positions").
[recruitly_jobs_count]Search
Job Search Form
Renders a search form that filters the [recruitly_jobs] listing. Place it above or alongside the job list.
[recruitly_job_search target="/jobs" cssclass="jumbotron padding-20"]| Parameter | Default | Description |
|---|---|---|
target | — | URL of the page containing [recruitly_jobs] |
cssclass | — | CSS classes applied to the form wrapper |
Widgets
Sector Widget
Shows jobs in a specific sector. Useful for sector-specific landing pages.
[recruitly_job_sector_widget target="/jobs" sector="aeronautics-and-defence" count=5]| Parameter | Default | Description |
|---|---|---|
target | — | URL of the jobs page to link to |
sector | — | Sector slug |
count | 5 | Number of jobs to display |
Tag Widget
Displays jobs by tag.
[recruitly_job_tag_widget]Cities List
Lists available job cities.
[recruitly_job_cities]Language List
Lists the languages required across job postings.
[recruitly_job_language_list]Single Job View
These shortcodes are used inside individual job post templates. They pull data from the currently viewed job.
Job Image
Displays the job's banner or detail image.
[recruitly_job_image]Recruiter Image
Shows the recruiter's profile photo.
[recruitly_job_recruiter_image]Job Location
Displays the job's location.
[recruitly_job_location displayfield="city"]| Parameter | Default | Description |
|---|---|---|
displayfield | — | Location field to show: city, county, country |
Recruiter Languages
Lists the languages spoken by the assigned recruiter.
[recruitly_job_recruiter_languages]Web Advert Fields
Renders specific sections of the job's web advert content. Use one shortcode per field.
[recruitly_job_web_field fieldname="mainResponsibilities"]fieldname value | Description |
|---|---|
recruitmentProcess | Recruitment process description |
mainResponsibilities | Key responsibilities |
whatsOnOffer | Benefits and package details |
coreSkills | Required skills |
whatWillYouLearn | Learning and development |
keyLanguages | Language requirements |
Template Customization
The plugin ships with default PHP templates for rendering job listings, search forms, and widgets. To customize them:
- Copy the template files from the plugin's folder
- Paste them into a
/recruitly/directory in your active theme - Edit the copies — WordPress will use your theme's version instead of the plugin's
Overridable templates:
| Template File | What It Controls |
|---|---|
job-listing.php | Individual job card in the listings |
job-search-form.php | Search form layout and fields |
job-sector-widget.php | Sector widget display |
job-recent-jobs-widget.php | Recent jobs widget display |
TIP
For full design control beyond template overrides, see the Custom Post Type approach — it lets you use Elementor, JetSmartFilters, or any page builder to design your job board from scratch.