Attributes are flexible labels that you can assign to individual workers. They can make filtering and segment creation easy to set up and maintain.
Create New Attributes from Settings
To set up a new worker attribute, follow these steps:
Click your company logo in the left side panel and then Settings.
Click the Worker Attributes settings link.
Click the Add attribute button in the top right corner.
In the Add Attribute pop-up that appears, fill out the following fields:
Attribute Label: The label of your attribute that will be shown when you add it to a worker's profile and give it a value (ex. 'Date of Birth' or 'Years of Experience')
Attribute Type: This dictates what kind of values you can enter in the attribute, when adding it to a worker:
String (plain text): Free-text values
Number: Numerical values
Date: A specific date (month, day, and year)
Boolean: True or False
Select: Choose from a list of options
Address: Enter a business or residential address
Media: Upload a file or document
Signature: Tied to Document Signature templates
Compliance Document: Tied to a compliance check document
Optionally, select the Protect attribute checkbox if you would like for the value of this attribute to be hidden by default in the worker's profile
This can be useful for attributes whose values may contain sensitive data that should be hidden to start, such as Social Security Numbers or bank account details
Attributes with this option selected will display like this (until a user selects the Edit button to view/update the attribute value):
Click Add to save your new attribute
This new attribute will be added to the Worker Attributes table, which lists all attributes available for your company. Each row shows the attribute's type, its section, when it was last updated, and its UUID, with a copy button for use in integrations.
Sync Data Keys from Hire
Sync from Hire creates Worker Experience worker attributes from the Hire Data Keys on your account. It is a bulk action that Fountain describes as destructive, and the dialog asks you to confirm you understand that before running it.
Click your company logo in the left side panel and then Settings.
Click the Worker attributes settings link.
Click Sync from Hire. The Sync Data Keys from Hire dialog opens.
Optionally turn on Use Hire label as the worker attribute label.
Click Sync, or Cancel to close without syncing.
Syncing Overwrites Existing Worker Attributes
Syncing is destructive and affects applicants being migrated over. After a sync, resync your Hire Webhook attribute mappings, or values may stop landing on the attributes you expect.
Turn on Use Hire label as the worker attribute label to name new attributes after the Hire data key's readable title, such as "Years of experience", rather than its snake_case key, such as years_of_experience. It applies as follows:
New attributes take the readable label.
Existing attributes are relabelled only if their current label still matches their key, meaning nobody has renamed them by hand.
Any attribute whose new label would collide with an existing one is skipped.
Edit an Existing Attribute
Once an attribute has been created, you can take three actions on it from the More Actions menu, the … button at the end of the attribute's row:
Edit: edit the label of an attribute, and if it's a protected value (note: you can't change the type of attribute after it's been created)
Delete: deletes the attribute entirely, including from worker profiles
Manage Webhooks: configure a webhook to be triggered on any custom attribute. The webhook URL that is configured here will be triggered when the value of this attribute changes for any worker.
Attributes marked Read-only offer only Manage Webhooks. Fountain manages their labels and values, so they cannot be edited or deleted.
Deleting An Attribute Removes Its Stored Values
Deleting an attribute removes it from every worker profile along with any values recorded against it. Assigning the attribute to No section hides it from a section without destroying data; deleting does not.
Create an Attribute from a Worker Profile
These same steps can also be taken from directly within a worker profile. This does two things at once: creates a new attribute, and adds it directly to the selected worker's profile for you to add in a value. To do so:
Go to the Worker Profiles page
Select any worker from the table by clicking on their name
In the window that opens, click the Add button in the top right
Fill out the Attribute Label and Attribute Type fields
Optionally select the protect attribute checkbox if you want values for this attribute to be hidden by default
Click Add to create your new attribute and add it to this worker's profile at the same time
To add a value for an attribute, click the Edit button (pencil icon) next to the attribute in the worker's profile.
View a Worker's Attributes
You can view a specific Worker's attributes via their Worker Profile. To do so:
Go to the Worker Profiles page
Select any worker from the table by clicking on their name
The Attributes tab will appear on the right side
Group Attributes into Sections
A company with dozens or hundreds of worker attributes has a long Attributes tab on every worker profile. Sections group related attributes, so a profile can be scanned rather than read end to end.
Sections are optional and are configured once for the whole company. With no sections configured, each worker profile shows a single flat list of attributes.
Set Up Sections
Click your company logo in the left side panel and then Settings.
Click the Worker Attributes settings link.
Click Manage sections in the top right corner. The Attribute sections dialog opens.
Click New section, type a name in the field that appears, then click Save.
Repeat for each group you want, then click Done.
Start From The Suggested Section Set
With no sections configured, the Attribute sections dialog offers Add starter set.
It creates several sections drawn from common Fountain setups, such as: Personal & Contact, Compliance & Eligibility, Availability & Scheduling, Experience & Skills, and Application Details.
Assign an Attribute to a Section
Sections are empty until attributes are assigned to them. Assign attributes one at a time from the attributes table:
Click your company logo in the left side panel and then Settings.
Click the Worker attributes settings link.
Find the attribute you want to assign. On a long list, use the Search box above the table to narrow it down.
Click the Section dropdown on that attribute's row.
Choose a section from the list. The assignment saves immediately, with nothing further to confirm.
The dropdown lists No section followed by every section configured for your company. An attribute belongs to one section at a time.
To move an attribute to a different section, choose the new section from the same dropdown.
To take an attribute out of every section, choose No section. It returns to the unassigned group on the worker profile.
Read-Only Attributes Cannot Be Assigned
Some attributes are managed by Fountain and marked Read-only in the Privacy column. These show an em dash in the Section column instead of a dropdown and cannot be assigned to a section.
Order, Rename, and Delete Sections
Click Manage sections to change existing sections. The dialog lists one row per section:
Drag the handle on the left to set the order sections appear in on the worker profile.
Select Collapse to start that section closed on every worker profile. Leave it cleared and the section starts open.
Click the pencil to rename the section. The name becomes an editable field with Save and Cancel.
Click the trash icon to delete the section.
The number beside a section name is the count of attributes assigned to it.
Deleting A Section Keeps Its Attributes
Deleting a section removes the grouping only. The attributes and the values stored against them stay on worker profiles and return to the unassigned group, ready to be assigned to another section.
Two groups, Applicant Attributes and Hidden, sit under SYSTEM · PINNED TO BOTTOM at the foot of the dialog. Fountain manages both. They are always collapsed on the worker profile and cannot be renamed, reordered, or deleted.
If a section name is refused, one of these messages appears:
Message | What to do |
Enter a section name | The name field was left empty. Type a name and try again. |
A section with this name already exists. Enter a different name. | Another section already uses that exact name. Note that the check is case-sensitive, so Driving and driving would both be accepted — give sections clearly different names to avoid confusing your team. |
Read Sections on the Worker Profile
Go to the Worker Profiles page, click a worker, and select the Attributes tab. Sections appear as cards, in the order set in Manage sections:
Click a section header to open or close that card.
The number beside a section name counts the attributes shown in that section for this worker.
A section with nothing to show for a worker is left out entirely, so profiles carry no empty headers.
Attributes that are not assigned to a section appear last, in a group called Other.
A toolbar sits above the section cards:
Search attributes narrows the tab to attributes whose name matches what you type.
Sort A to Z sets the order attributes are listed in.
Add creates a new attribute and adds it to this worker's profile in one step.
Hide empty hides attributes with no value for this worker. Any section left with nothing to show disappears along with them. Clear the checkbox to see every attribute in every section.
