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

• Create and design your career portal before configuring these advanced settings.
• Make sure you have access to Salesforce Setup for section labels and custom fields.

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.

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

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: /.

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.

3. In the Salesforce Object Manager, open Fields & Relationships.
4. Click New.

5. Select the field type.
6. Click Next.

7. Enter a Field Label. Salesforce fills in Field Name from it.
8. For a picklist, select Enter values, with each value separated by a new line.
9. 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.

3. Click Next.
4. Select the page layouts that include the field.
5. Click Save.
6. In Career Portals Setup, open Fields for the portal. The new field appears at the end of Additional Information.

7. Set the field to Mandatory or Optional.
8. To publish the change right away, click Force update on the Career Portal.
9. Open a published job on the Career Portal. 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.

6. On the Recruiting API page, click Enable.
7. Copy the API Token.

8. In your website backend, change the endpoint from https://jobs-api.flair.hr/v1/ to https://api.flair.hr/recruiting.
9. 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 Portals 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.

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

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.

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

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

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

7. Click Activate.
8. Return to the affected record in Career Portal Applications.
9. Click Process Application. flair processes the application and creates the candidate.

Related articles

• Career Portals
• Jobs & Multiposting
• Configure candidate and talent anonymization