Skip to main content
Unlisted page
This page is unlisted. Search engines will not index it, and only users having a direct link can access it.

Welcome to the flair Developer Hub

What Is flair?​

flair is a flexible HR and recruiting platform, helping organizations to centralize their people data and simplify their people processes. Leveraging the Salesforce platform, we have designed flair to be customizable, configurable, and extensible.

What Can You Find in the Developer Hub?​

In our Developer Hub, you will find:

  • Guides to help you setup and configure flair
  • Tips for customizing various parts of the platform
  • A changelog containing release notes.

Who Is the Developer Hub For?​

The content in our Developer Hub is aimed at Salesforce admins, developers, and HR admins. You will require admin permissions in flair to carry out the majority of the processes described here.

📘 For guides and tutorials explaining how to use flair as an employee, manager, or other user without admin rights, please visit our Help Center.

Salesforce Login Troubleshooting​

If you are unable to log in to Salesforce, check the following common causes.

Incorrect Login Credentials​

  • Wrong username or password (case-sensitive)
  • Account locked: After multiple failed attempts, your user may be locked out
  • Password expired: You may be prompted to reset it

Authentication and Security Issues​

  • Two-factor authentication (2FA) is enabled, but you did not receive the code (e.g., SMS or authenticator app)
  • IP restrictions: You may be trying to log in from an unapproved IP address
  • Login hours restrictions: Your login attempt may be outside allowed hours

Technical Issues​

  • Browser cache problems: Try clearing cookies or using incognito/private mode
  • Outdated browser: Salesforce supports only modern browser versions
  • Network issues (e.g., VPN, firewall, or proxy blocking Salesforce access)

User Status and Permissions​

  • Your user account may have been deactivated (e.g., due to inactivity or admin action)
  • License removed or changed, which could revoke your access

System-Wide Problems​

What You Can Do​

  1. Try resetting your password
  2. Contact your Salesforce admin to check your user status
  3. Check the Salesforce status page
  4. Test a different browser or incognito mode
  5. Check your IP address or VPN connection

Enabling Lightning Web Security (LWS)​

Lightning Web Security (LWS) is Salesforce's latest security architecture, designed to improve both the security and performance of Lightning components. It helps isolate components, ensuring they interact safely and predictably without interfering with one another or the broader platform.

For certain flair features, such as the flair Inventory module, flair relies on newer Salesforce components that require LWS to be enabled.

If LWS is disabled, the following issues may occur:

  • UI components may not render correctly or may appear broken
  • Core features might become unresponsive or function inconsistently
  • Integration with other Salesforce elements could fail

While disabling LWS does not always lead to problems, it is frequently linked to issues. Enabling LWS has resolved these issues for several customers, and Salesforce recommends enabling it to ensure future compatibility.

Enabling Remote Site Settings​

Remote Site Settings must be active for flair to communicate with external services. To enable them:

  1. Click on Setup in Salesforce
  2. In the Quick Find box, type Remote Site Settings
  3. Click on Remote Site Settings
  4. Click Edit next to Flair API
  5. If not already active, select the Active checkbox
  6. Click Save

Adding Components to the Employee Record Page​

You can add related lists and other components to the Employee record page using the Lightning App Builder.

  1. Navigate to Employees and click on any employee record
  2. Click the Setup gear icon in the top right
  3. Click Edit Page to open the Lightning App Builder
  4. Drag the desired component (e.g., Related List - Single) into the page layout
note

To proceed with certain component configurations, you may need to switch to Dynamic Forms.

  1. Ensure that you have completed all the mandatory fields for the component
  2. Click Save
  3. Click Activation to assign the page layout
  4. You can save the new page layout as an org default, app default, or assign it to specific apps, record types, or profiles
  5. Click Close, then Save again

Personalizing the Salesforce Navigation Bar​

The Salesforce navigation bar allows you to quickly find the features and data you need in your flair HR and Recruiting apps. While the default navigation bar is set by your Salesforce admins, you can customize the bar yourself, choosing the pages and features you use most often.

To customize your navigation bar:

  1. Click the pencil icon on the right side of the navigation bar
  2. A window will pop up showing you the full list of navigation items currently shown in your bar
  3. Click and drag items to change the order, or click the x to remove an item (you cannot remove items that your admin has specified for the app)
  4. Click Add More Items to see the full list of available navigation items for your flair HR or Recruiting app
  5. Select the items you want to add, then click Add Nav Items
  6. Rearrange items as needed, then click Save