Configuration
Settings are under Hire → Settings, split across screens so the retention setting is somewhere
you will find it. As with any Craft plugin, a config/hire.php returning an array of these keys
overrides what is saved in the control panel.
General
| Setting | Key | Default |
|---|---|---|
| Jobs per page | jobsPerPage | 20 |
| Default order | defaultSort | postDate desc |
| Show the search box | showSearch | on |
| Show the filters | showFilters | on |
| Keep closed jobs in the listing | showClosedJobs | off |
| How new jobs take applications | defaultApplyMethod | form |
| Reference prefix | jobCodePrefix | JOB |
| Default advert length, in weeks | defaultDurationWeeks | 0 (no closing date) |
| Close jobs when their closing date passes | closeExpiredJobs | on |
| Emit JobPosting structured data | jobPostingSchema | on |
| Organisation name, URL, logo URL | organizationName, organizationUrl, organizationLogo | site name, site URL, none |
| Default country | defaultCountryCode | US |
| Default currency | defaultCurrency | USD |
Job URLs, job fields, application fields
Per-site URI format, template and default enabled state for jobs; the job field layout; and the field layout for what your team records about an application. All project config.
Application forms, pipeline stages, specifications
Covered in The application form, Applications and the pipeline and Specifications and filtering. All project config.
Notifications
| Setting | Key | Default |
|---|---|---|
| Email the applicant | notifyApplicant | on |
| Email the hiring side | notifyRecipients | on |
| Who to notify | recipients | the system email address |
| Reply goes to the applicant | replyToApplicant | on |
| Attach the CV | attachResume | off |
| Send through the queue | queueNotifications | on |
| Honeypot field name | honeypotField | hire_website |
| Minimum seconds on the form | minSubmitSeconds | 3 |
| Applications per IP, per hour | rateLimit | 10 |
| CAPTCHA | captchaDriver | none |
| Site key, secret key | captchaSiteKey, captchaSecret | — |
| reCAPTCHA v3 minimum score | recaptchaMinScore | 0.5 |
| Blocked email domains | blockedEmailDomains | none |
recipients, organizationName, organizationUrl and the CAPTCHA keys accept environment
variables ($HIRE_CAPTCHA_SECRET).
Uploads & privacy
| Setting | Key | Default |
|---|---|---|
| Asset volume | resumeVolumeUid | none — choose one |
| Subfolder | resumeSubpath | applications/{year}/{month} |
| Accepted file types | allowedResumeExtensions | pdf doc docx odt rtf txt pages |
| Largest file, in MB | maxResumeSize | 5 |
| Keep applications for, in days | retentionDays | 0 (forever) |
| Record the applicant's IP address | storeIpAddress | off |
| Applying twice for the same job | duplicateHandling | flag |
| Let applicants check their status | applicantPortal | off |
| Where to go after applying | redirectAfterApply | the same page |