Skip to main content

Configure advanced career portal settings

Configure the Salesforce-side labels, application fields, API connection, and error handling for an existing flair career portal.

Who can use this?

Salesforce Admins and HR Admins in Salesforce.

Before you begin​

Rename job sections on the career page​

By default, each job has Job Description, Responsibilities, Requirements, and Benefits sections. Use field label overrides to match these headings to your brand language.

  1. In Salesforce Setup, enter Override in Quick Find.
  2. Select the flair.hr package.
  3. Select the language of the career page you want to edit.
  4. Set Setup Component to Custom Field.
  5. Set Object to Job.
  6. Set Aspect to Field Label.

Career page custom sections, step 1 in Rename Job Sections

  1. Under Master Field Label, find the job section you want to rename.
  2. Enter the new heading in the corresponding Field Label Override field.
  3. Click Save. The new heading appears on the career page.

Career page custom sections, step 2 in Rename Job Sections

Career page custom sections, step 3 in Rename Job Sections

Hide a career portal from search engines​

flair serves matching robots.txt and agents.txt files for each career portal. Enable Hide From Indexing on the portal to have both files disallow crawling for that portal's pages.

  1. From the App Launcher (⋮⋮ grid icon), search for career.
  2. Open Career Portals and select the portal.
  3. Under Settings, select Hide From Indexing.
  4. Click Save. The portal's robots.txt and agents.txt now return Disallow: / for all crawlers, including AI agents; clear the checkbox to return to Allow: /.

The Hide From Indexing checkbox in the Settings section of a Career Portal record

warning

Disallow is a request that future crawls honor. It does not remove pages a search engine already indexed, and flair caches robots.txt and agents.txt for up to an hour, so the change is not immediate.

Add custom fields and picklists​

Create a field on the Candidate object when the standard career portal fields don't collect the information you need. This example creates a picklist.

Define the field​

  1. In the flair Recruiting app, open Candidates.
  2. From the setup cog menu, select Edit Object.
  1. In the Salesforce Object Manager, open Fields & Relationships.
  2. Click New.
  1. Select the field type.
  2. Click Next.
  1. Enter a value in Field Name.
  2. For a picklist, select Enter values, with each value separated by a new line.
  3. Enter each option on a separate line.

Set access and add the field to jobs​

  1. Click Next.
  2. Select the user profiles that can edit the field.
  1. Click Next.
  2. Select the page layouts that include the field.
  3. Click Save. The field appears under Career Page Fields next to Additional Information.
  1. Set the field to Mandatory or Optional for new jobs.
  2. To add the field to an existing published job, unpublish that job.
  3. Republish the job. The custom field appears on its application form.

Connect your website with the Recruiting API​

Update the authorization and endpoint when connecting your website to a flair career portal through the Recruiting API.

  1. In the flair HR app, open HR Admin.
  2. Open the Integrations tab.
  3. Select Recruiting API.
  4. Optional: Select the career portal you want to connect. Leave the field empty to link all jobs.
  5. Click Connect via Integration Service.

The Recruiting API connection dialog with the Career Portal field and Connect via Integration Service

  1. On the Recruiting API page, click Enable.
  2. Copy the API Token.

The Recruiting API settings page with Enable and the API Token

  1. In your website backend, change the endpoint from https://jobs-api.flair.hr/v1/ to https://api.flair.hr/recruiting.
  2. Use the copied API token for authorization.

For endpoint details, see Get all open positions.

Troubleshooting​

Error notifications go to the wrong person​

The integration user receives application error notifications by default. Choose another employee when a different person should investigate these errors.

  1. In flair Recruiting, open Career Portal Setup.
  2. Select the career portal.
  3. Open the Details tab.
  4. Under Settings, open Employee to Notify About Errors.
  5. Select an employee. That employee receives an email when an application error occurs on this portal.

Career portal application error, step 1 in Handle Application Errors

  1. From an error email, click Open Application to review the affected application.

Career portal application error, step 2 in Handle Application Errors

A career portal disappeared​

flair automatically deletes a career portal once its connection to Salesforce has been inactive for more than 40 days, checked weekly. An inactive connection means the portal's Salesforce authorization has already stopped working, so the portal could no longer serve jobs or accept applications.

To restore a deleted portal, reconnect it to Salesforce.

An application doesn't create a candidate​

Review the stored application error and correct its invalid value before processing the application again. For example, an inactive value such as fr can cause an error for the restricted flair__Language__c picklist.

  1. In the App Launcher (⋮⋮ grid icon), open Career Portal Applications.

Career portal application error, step 3 in Handle Application Errors

  1. Open the affected application.
  2. Review the error information.

Career portal application error, step 4 in Handle Application Errors

  1. In Setup → Object Manager, open the Candidate object.
  2. On Fields & Relationships, open the field named in the error.

Career portal application error, step 5 in Handle Application Errors

  1. Under Values, find the invalid entry in Inactive Values.

Career portal application error, step 6 in Handle Application Errors

  1. Click Activate.
  2. Return to the affected record in Career Portal Applications.
  3. Click Process Application. flair processes the application and creates the candidate.

Career portal application error, step 7 in Handle Application Errors