# Shortcodes

Shortcodes let you embed job listings anywhere on your site, without coding. They enhance flexibility, save time, ensure consistent formatting, and allow effortless customization. If you prefer a visual, no-shortcode workflow, see [Gutenberg Blocks](https://loxo.w4dev.com/docs/gutenberg-blocks/) for the block equivalent of each shortcode.

## Shortcode – Job Search Form

Use the `[loxo-jobs-filter]` shortcode to display a job search form. Visitors can filter jobs by category, location, types and keywords.

Say your job archive/listing page is at /jobs, and you want to show the filters on the homepage. Use the form\_action parameter to link the form with the jobs: `[loxo-jobs-filter form_action="/jobs"]`

![](https://loxo.w4dev.com/wp-content/uploads/2025/05/image.png)Job Search Form## Shortcode – Job Directory

Use the `[loxo-jobs]` shortcode to display a job directory. To show a limited number of jobs (especially on the homepage), use the `[loxo-jobs per_page=5 pagination="" show_count=""]` shortcode.

![](https://loxo.w4dev.com/wp-content/uploads/2024/10/Loxo-job-directory.png)Job Directory## Available Parameters

The following parameters work with both `[loxo-jobs-filter]` and `[loxo-jobs]`. They override the defaults configured in [Template Customization](https://loxo.w4dev.com/docs/template-customization/).

### Filtering

- `job_keyword` — Pre-fill keyword search
- `job_category` — Filter by job category slug
- `job_type` — Filter by job type slug
- `job_country` — Filter by country slug
- `job_state` — Filter by state slug
- `job_city` — Filter by city slug
- `job_location_type` — Filter by location type slug (e.g., remote, onsite)

### Display

- `per_page` — Number of jobs per page (default: from plugin settings)
- `pagination` — Pagination style: `default` or `more` (Load More button)
- `show_count` — Show total job count: `1` to show, `0` to hide
- `hide_excerpt` — Hide job excerpts: `true` or `false`
- `hide_salary` — Hide salary: `true` or `false`
- `job_filters` — Comma-separated list of filters to show. Options: `keyword`, `category`, `country`, `state`, `city`, `type`, `location_type`

### Filter Form Only

- `form_action` — URL where the filter form submits to. Use when the filter and job list are on different pages.

## Examples

**Show 5 remote jobs with keyword and type filters:**

```
[loxo-jobs-filter job_location_type="remote" job_filters="keyword,type"]
[loxo-jobs job_location_type="remote" per_page="5" hide_excerpt="true"]
```

**Show all full-time jobs with Load More pagination:**

```
[loxo-jobs job_type="full-time" pagination="more" per_page="10"]
```

## Single Job Shortcodes

These shortcodes display individual job components. The `id` parameter is the job’s WordPress post ID (shown in the URL when editing the job in wp-admin — not the Loxo job ID). When used on a single job page, you can omit `id` — the plugin uses the current job automatically.

- `[loxo-job-title id=123]` — Display job title
- `[loxo-job-description id=123]` — Display job description
- `[loxo-job-meta id=123]` — Display job metadata (salary, type, location)
- `[loxo-job-sharing id=123]` — Display social sharing links
- `[loxo-job-application-form id=123]` — Display application form
- `[loxo-job-company id=123]` — Display the job’s company logo and name (v2.3.0+; accepts `show_logo` and `show_name`, both default `yes`) — see [Job Company Information](https://loxo.w4dev.com/docs/job-company-information/)

## Related documentation

- [Gutenberg Blocks](https://loxo.w4dev.com/docs/gutenberg-blocks/) — build the same displays visually instead of with shortcode syntax.
- [Template Customization](https://loxo.w4dev.com/docs/template-customization/) — see the underlying settings these shortcode parameters override.
- [Available Job Data](https://loxo.w4dev.com/docs/available-job-data/) — check which fields are available to filter and display.
- [Job Company Information](https://loxo.w4dev.com/docs/job-company-information/) — show each job’s own hiring company instead of the site-wide one.

Source: https://loxo.w4dev.com/docs/shortcodes/