1. Home
  2. Getting Started
  3. Basic Matador Settings

Basic Matador Settings

Congratulations, you’re installed and connected to Bullhorn! Now let’s review some of the most common settings you’ll want to consider before your first sync. This help doc will not explore all settings, just the most common ones.

In general, Matador is infinitely customizable through the use of over five hundred hooks–programmer speak for points where another programmer can change a value or insert or remove a behavior. That said, we’ve identified about 50 changes the average user may want to make and created a no-programming-skills-needed settings page to manage these.

Hover or tap the Matador Jobs menu in the sidebar and then click or tap on Settings to begin.

Settings Overview

The Matador Jobs plugin settings page is organized into tabs and sections to help you find you what you’re looking for.

Settings Tabs

A default installation of Matador Jobs will have three tabs: General, Job Listings, and Applications. A tab contains a collection of settings that relate to the tab’s name. For example, job sync related settings will be under the Job Listings tab. By clicking or tapping on a tab, the settings for that section will show.

Screenshot of the tabs on the Matador Settings screen.
The default install’s tabs.

When adding certain Matador Jobs Pro Extensions, new tabs may be added.

Settings Sections

Each tab has related settings grouped into a settings section. The number of topics in each section changes based on which version of Matador you are running and the Matador Jobs Pro Extensions you have installed. A settings section contains related options grouped together under a descriptive title.

Screenshot of the Email Settings settings group on the Matador Settings.
The Email Settings settings group under the General tab of Matador Settings.

Save Settings

At this time, in order to save a change, you need to scroll to the bottom of the Settings page and click or tap on the Save Changes button. Some times, other buttons will save changes for you, like when you click or tap on Connection Assistant and Sync Now.

The General Tab

The General Tab is home to the License Key and Bullhorn Connection sections, covered in other specific guides. It also allows you to set global email, logging, and error email settings. Take note of the following:

Email Settings

Matador can send many emails, including notification for applications, confirmations for applicants, and admin notifications if the Bullhorn connection fails. If these settings are left unset, email will send from “A Matador Jobs Website” with the email set to your WordPress administrator email address.

Logging and Error Handling

Matador can create verbose logs to track many aspects of its operation. It’s highly recommended that you save at least 4 days of logs whenever doing custom development or are in staging, and 1 or 2 days of logs when things are in production or live. Note that sites with lots of applications or lots of jobs can generate huge log files, so you shouldn’t save more days of logs than needed.

You can also customize whether admin emails are sent and to whom. If left blank, emails will go the WordPress administrator email address. These emails send when an unrecoverable Bullhorn disconnection occurs.

Job Listings Tab

The Job Listings Tab is home to sections related what to import from Bullhorn, how to assemble your structured data external aggregation by Google for Jobs Search and others, how you want your URLs to appear, and more. Take note of the following:

Bullhorn Import section

The Published Status to Import determines what publishing status to import. We recommend using “Published, Approved”. This means a job has been explicitly published by its manager, and in companies where a review is required, the review has completed. If your workflow doesn’t require review, you can use “Published, Submitted”. You can also sync “All Jobs” which will import all jobs that are open and not deleted, but this will import job drafts too, and is discouraged.

The next three settings recommend using various options based on a published job. If your company is not using the publishing feature of Bullhorn, make sure you select options that take that into consideration.

The Description Field determines which description field is pulled in from your sync. We recommend using the Public Description, created upon a job’s publishing, but you can use the standard description (necessary when importing “All Jobs”).

The Category Field, like the description field, can use multiple sources. Bullhorn’s “Published Category” can only have one category, while using “Categories” can allow you to import multiple categories.

The Date Field can import jobs based on several values. The job is saved into WordPress with this date and it is used when sorting by date. If your company likes to “refresh” jobs a lot and/or re-use old postings, its encouraged you use “Date Last Published.”

Jobs Structured Data Section

Structured Data is the hidden computer code that aggregators, like Google for Jobs Search, uses to feature your jobs on their systems. A lot of information can be exposed via Structured Data, and some of it your company may not be allowed to expose. So take note of the following:

The “Hiring Company” Data Source will determine who is credited as offering the role. If you want it to be your company, e.g. “ABC Jobs”, then choose “use Hiring Agency data”, but if you want to highlight the company, e.g. “Coca Cola”, choose “use Client Company data”.

The Show “Pay Rate” Data option allows you to choose to expose or hide salary data from structured data. Some hiring agencies are not allowed to share this information due to agreements from the companies they work with.

The more info you expose in structured data, the better your traffic from organic search results. It’s common, for example, for users to search for roles by salary, and if you don’t provide it, your jobs may not show up in that search.

Reminder, this is an overview of basic settings for a new user. You will want to set up the Google Indexing API sometime later!

URL Slugs section

In your Bullhorn account, jobs have numeric IDs. In WordPress, jobs also have numeric IDs. To make an easier to use human-friendly experience, we create special URLs for each job that brings up your job data. These are called URL slugs. We have a few settings to customize your users’ experiences.

The Job Single URL Slug setting determines how each job’s URL name is displayed. For example, if the job ID in Bullhorn is 1234 and the title is “Executive Hiring Expert” a URL slug might be executive-hiring-expert-1234. Use this setting to plan that out.

The Job Board Location setting determines where links to “All Jobs” will go. This should be the home page of your jobs. You will either use the “Archive” which is a page made automatically by WordPress using your theme files (and can be customized by a WordPress theme developer) or a WordPress “page” with the [matador_jobs] shortcode.

The Job Listings Slug is the text that goes after your first slash in your domain name and before the Job Single URL Slug. So, let’s say your domain name is www.your-job-site.com and the job is executive-hiring-expert-1234 the job slug sits between these, eg: www.your-job-site.com/job-slug/executive-hiring-expert-1234. It is common for users to make the job listings slug the same as page slug when using a WordPress “page”, otherwise the job listings slug is the URL of the “Archive” (ie: all jobs are at www.your-job-site.com/job-slug/).

Further, in this section, a customizable URL slug for each taxonomy, eg: “category”, “location”, can also be set.

Applications Tab

The Applications Tab is home to sections related how Matador collects applications and sends them to Bullhorn. Take note of the following:

Most of the options in this tab are disabled for users of Matador Jobs Lite and are offered only for demonstration. Matador Jobs Lite does not process applications; to have this capability you must upgrade to Matador Jobs Pro.

Applications General Settings

The Application Method setting determines where the application form is located. You can choose to have “Apply Now” buttons link to a special generated page (found by adding /apply to the end of the jobs’ url) or adding the application under the job description. You can also have Apply Now buttons redirect to a custom page where you put an application form. This setting somewhat affects how Matador creates job navigation buttons.

The Confirmation Method setting is similar to the above, and determines where the user goes when an application completes. You can redirect to a page, go to a generated page (found by adding /confirmation to the end of the jobs’ url), or go back to the job page with a “thank you” message at the top. The easiest to customize is the redirected page.

The Resume or CV determines which word is used to describe the candidate history document submitted with most applications.

The Classify Applicants setting determines how Matador classifies applications in Bullhorn. Depending on your company workflow, you may want to set this to “Job Submission,” but both we and Bullhorn recommend this be set to “Web Response” as a best practice.

What’s Next?

If you followed along, there are quite a few settings we skipped over for this first run-through of your settings options.

That said, once you’ve got your Matador Jobs set up, we strongly recommend you review the Advanced Matador Settings guide, as well as the guides for in-depth Google Indexing API, Privacy Acts Adherence, and Email Notifications setup.

For now though, let’s do our first manual sync and set up our jobs, search, and application pages.


The Default Job to Apply To is a special field. If your company uses the [matador_application] shortcode to create a custom “general application” page for candidates who don’t see a job for them but want to sign up with your company for future opportunities, if this option is empty, the candidate will be created but no submission will be created. On the flip side, if you create a special job in your Bullhorn like “General Applicants Job” and put the job ID into this Matador option, the candidate will be submitted to that job.

Why is this helpful? Well, we’ve found that over 50% of recruiting companies’ recruiters’ workflows do not include using the Candidates tab of Bullhorn and instead focuses on evaluating candidates who submit to jobs in their portfolio. By assigning a person the “General Applicants Job” and getting Web Responses/Submissions to that, you can ensure that someone sees these potentially valuable submissions.

Updated on August 25, 2020

Was this article helpful?

Related Articles