Build and manage a Career Portal

Create a branded Career Portal for your open jobs and application forms. This guide covers its layout, fields, job selection, source tracking, and website embed.

Who can use this?

Recruiters and HR Admins in the flair Recruiting app in Salesforce. Website administrators use the embed code on the company website.

Create a Career Portal

1. In the flair Recruiting app, open Career Portals Setup from the navigation bar, App Launcher, or Setup Assistant → Go to Settings.
2. If no portal exists, click Create. Otherwise, click New.
3. Enter a name.
4. Enter a unique slug. Use lowercase characters without spaces or special characters; flair replaces spaces with hyphens.
5. Confirm that the generated URL is available. For example, the slug flair demos produces https://flair-demos.careers.flair.hr.
6. Click Create. flair reserves the URL and opens the builder.

note

To keep a legacy Career Portal URL, finish the new portal and ask your flair Customer Success Manager or flair Support to activate the old URL.

Design the portal layout

1. In Career Portals Setup, open Layout & Appearance.
2. Select a card in the left menu to edit it while reviewing the preview.
3. Use the eye icon to hide a card or the pencil icon to edit it.
4. Use the trash icon to remove a card.
5. Drag the handle next to a card name to change its position.
6. Click Add New Section to add another card.

The default layout provides these cards:

Card	What it displays
Hero Card	A title, subheading, description, three images, and Company Highlights.
Open Positions Card	Published jobs, search, optional grouping and sorting, pagination, and configurable job-field filters. The default filters are Department, Location, and Type of Employment.
Perks & Benefits Card	Benefits with an icon, name, and short description. Three appear at a time, with arrows for more.
Our Team Card	Team-member photos and captions.

Design job description pages

1. In the left menu of Layout & Appearance, open Job Description Page.
2. Keep the mandatory Job Header and Job Details and Application cards at the top.
3. Add any other sections beneath the mandatory cards.

Show header fields on job listings

The Open Positions Card shows the fields configured for a job's Job Header card as icon chips beneath the job title, matching what applicants see on the job's own page. Previously, every card always showed Location, Type of Employment, and Time Commitment, regardless of the Job Header configuration.

The listing search box also matches these values. An applicant can find a job by any header field shown on its card, such as a location or a custom field, not only by the job title.

Configure job header fields

The Job Header card shows a portal-wide default set of fields as chips. Configure the default set, then override it for individual jobs where needed.

1. In Layout & Appearance, open Job Description Page.
2. Select the Job Header card and click the pencil icon to edit it.
3. Click Add field, choose a job field, and repeat for up to 8 fields.
4. Drag fields to reorder them.
5. Save the card.

Override header fields for one job

1. In the flair Recruiting app, open Jobs and select the job.
2. Open Publishing Details.
3. On the Header Fields card, select Customize for this job.
4. Add, remove, or reorder fields the same way as the portal default.
5. Save your changes.

Select Use portal default to remove the override and follow the portal's default fields again.

Sort jobs on listings

1. In Layout & Appearance, select the Open Positions Card and click the pencil icon to edit it.
2. Set Sort jobs by to Default, Name, Created Date, or Display Order.
3. Set Sort direction to Ascending or Descending.
4. Save the card.

Each Open Positions Card on the portal can use its own sort configuration. To rank jobs manually, choose Display Order sorting and set a job's Display Order field; flair lists lower numbers first.

Configure Career Portal details

In Career Portals Setup, open Details and configure the portal information:

Setting	What it controls
Basic company information	The company details displayed on the portal.
Company logo	The logo displayed with your brand.
Brand color	The portal's brand color.
Default language	The initial portal language.
About Us	The company introduction.
Website, social media, and privacy policy links	The external links available to applicants.
Application confirmation message	The message shown after an applicant submits the form.
Default Allowed File Extensions	The file extensions accepted for uploads when a field doesn't set its own list.

Require double opt-in

Double opt-in asks applicants to verify their email address and consent to extended data retention.

1. From the App Launcher (⋮⋮ grid icon), search for career.
2. Open Career Portals and select the portal.
3. Open Details.
4. Select Double Opt In.
5. In Privacy policy URL, enter the privacy-policy link.
6. Click Save. The application form shows the data-retention consent checkbox and flair sends a verification email after submission.

Verify double opt-in

1. Open a job on the Career Portal.
2. Complete the application form.
3. Select the data-retention consent checkbox.
4. Submit the application.
5. Confirm that the applicant receives the verification email.

Control organic job posting

Organic job posting distributes your published jobs for free across a network of job boards and partner websites, separate from paid flair Advertising campaigns. It requires a subscription that includes organic job posting; if it is unavailable, a job's Organic card shows Request feature instead of a campaign status.

Disable organic posting for a portal

1. In Career Portals Setup, open Details for the portal (see Configure Career Portal details).
2. Select Disable Organic.
3. Click Save. flair stops distributing this portal's jobs through the organic feed.

Exclude a job from organic posting

1. In the flair Recruiting app, open Jobs and select the job.
2. Open Campaigns.
3. On the Organic card, open the menu and select Exclude this job from organic campaign.

To include the job again, open the same menu and select Include this job in organic campaign.

flair also removes a job from the organic feed automatically when you close it, so you do not need to exclude jobs you close.

Configure application fields

1. In Career Portals Setup, open Fields.
2. Enable the fields applicants should complete, such as a cover letter, earliest start date, or salary expectations.
3. Set each field as mandatory or optional.
4. Drag fields to change their order.
5. To collect another file, click Add New File Field.
6. Enter the label and description, then choose whether the field is mandatory.
7. Optional: In Allowed File Extensions, enter a comma-separated list of extensions without dots, such as pdf,doc,docx, to override the portal's Default Allowed File Extensions for this field.

warning

Salesforce limits every uploaded file to 4 MB. The limit applies separately to each file when an applicant uploads several files. flair also rejects an uploaded file whose extension isn't in the portal's Default Allowed File Extensions, checking the file's actual content so a renamed file can't bypass the restriction.

For other information, an admin can add custom fields and picklists in Salesforce Setup.

Create a multi-step application

1. In Career Portals Setup, open Fields.
2. Add a second application step.
3. Put the basic required information, such as name, contact details, and CV, in the first step.
4. Put the additional information in the second step.

flair submits the first step before prompting the applicant to continue, so the applicant can return to the additional fields later.

Override fields for one job

1. In the flair Recruiting app, open Jobs and select the job.
2. Open Fields.
3. Click Override. The Career Portal's default fields appear.
4. Add, remove, or update fields for this job.
5. In Career Portal Setup, click Force Update to publish the changes.
6. Refresh the job page.

To restore the portal defaults, click Reset To Career Portal on the job's Fields tab.

Force a portal update

• In the Career Portal Setup header, click Force Update. flair clears the portal cache and publishes pending design or field changes.

Last Forced Update shows when the cache was last cleared.

Choose jobs for the portal

Include jobs by location, department, and entity

1. In the flair Recruiting app, open Career Portals.
2. Select the portal, then open Segmentation.
3. Click Add segment.
4. Select a location, a department, and an entity.
5. To include current and future jobs from every location, department, or entity, select All Locations, All Departments, or All Entities.
6. Click Add segment.

Include a specific job

1. In Career Portals, open the portal.
2. Open Segmentation.
3. Click Add a specific job.
4. Select the job.
5. Click Add job.
6. Open Jobs, then verify that the job is connected to the portal.

Remove a job

• In the portal's Career Portal component, remove the job.

You can remove individual jobs only when the portal's segmentation does not use both All Departments and All Locations.

Track candidate sources

1. Copy the Career Portal URL or a specific job URL.
2. Add ?origin= to the end.
3. Add the source name, such as ?origin=linkedin.
4. Keep the source spelling and capitalization consistent because the value is case-sensitive.
5. From the App Launcher (⋮⋮ grid icon), open Career Portal Applications.
6. Open the candidate and review Career Page Origin.
7. Use Career Page Origin in reports to compare recruiting channels.

note

organic is reserved and can't be used as a custom source name. flair tags an application as organic automatically when a candidate applies from a job posting distributed through organic job posting, so those applications don't need a manual ?origin= link. The job's Organic card on its Campaigns tab shows the resulting candidate count.

Link an external job ad to flair

1. Create a flair Career Portal.
2. In the flair Recruiting app, create the job.
3. Confirm that the job matches the portal's location and department segmentation.
4. On the job record, find Career Portals and copy the portal link.
5. Use the link as the destination for the external ad's application action. Applicants open the flair form, and submitted details appear in Candidates.

Embed the portal on a website

1. Copy the Career Portal home-page URL, such as https://companyname.careers.flair.hr.

2. Add /?embed=true to hide the portal header and footer.

3. In the website code, add the iframe and replace the example URL:

   <iframe src="https://companyname.careers.flair.hr/?embed=true" style="height:40rem" title="Embed career portal"></iframe>

4. Optional: Change the width and height styles to fit the website.

5. Publish the website.

Related articles

• Create and advertise jobs
• Manage candidates
• Configure a Career Portal