Overview
The Settings area is the administrative backbone of SkillsDB. Administrators define the organizational rules and structures that underpin every other feature in the platform — from how proficiency is measured to which users can find each other in search. You open Settings from the workspace menu at the top of the left sidebar. Select your organization’s name and avatar, then select Settings. Settings opens in its own mode: the main navigation rail is replaced by a settings sidebar that lists every settings category, grouped by purpose, with a Find settings… search at the top and a Back to SkillsDB row to return to the product. Each category opens as its own page, rather than every setting living on one long page. This article gives you a map of the settings categories and covers the structural configuration areas in depth: Grading Scale, Search & Visibility, Learning & Training, and Org Structure. Categories that have their own article link to it instead of repeating it here. On/off visibility switches — such as hiding manager grades and hiding library sections — are covered in Page Settings.Prerequisites
Before you begin, you need:- Permission level: Administrator role
- Access: Open the workspace menu at the top of the left sidebar, then select Settings
Settings Categories at a Glance
The settings sidebar organizes every category into six groups. Each category opens as its own page. You can also type in the Find settings… box at the top of the sidebar to jump straight to a category.- Activity, Documents, AI Assistants, Import, and API appear only when the related feature is enabled for your organization.
- Billing & Plan appears only for Global Admins when self-serve billing is enabled for your workspace.
Configuring the Grading Scale
The grading scale defines the proficiency levels used throughout SkillsDB — in self-assessments, manager assessments, skills matrices, and gap analysis. Every skill assessment in your organization uses the grades you define here. Open Settings, then go to Skills & Assessments and open Grading Scale to manage the grading scale.Understanding grade structure
The grading scale table has four columns:Adding a new grade
Open the grading scale
Add a new grade
Enter descriptions
Confirm
Editing an existing grade
Click directly on any description field in the table to start editing — an edit icon appears on hover. Press Enter or click outside the field to save. Press Escape to cancel. Descriptions are always editable, even for grades that are in use. Grade numbers that are in use cannot be changed.Deleting a grade
Grades can only be deleted if they have never been used in an assessment. To delete a grade, select the delete icon in the Actions column for that row. Grade 0 cannot be deleted. It can only be deactivated (see below).Deactivating grade 0
Grade 0 is the system’s default “not yet assessed” state. It cannot be deleted, but it can be deactivated to hide it from assessments and grading views. Toggle the switch in the Actions column for Grade 0 to deactivate or reactivate it. When grade 0 is deactivated, it is not shown as a selectable option in assessments.Grade status reference
Configuring Search and Visibility
The Search & Visibility category controls which user roles can search for people within SkillsDB, what information they can filter by, and who sees the chips on a skill’s page. These settings let you balance visibility and privacy across your organization. Open Settings, then go to Search & Visibility to manage search permissions.
Understanding roles and access levels
Search permissions are configured across four columns representing security groups:Permission types
The permissions table contains the following rows:People Search Access levels
Saving and discarding changes
When you modify any search permission value, Save Changes and Discard Changes buttons appear at the top of the page.- Select Save Changes to persist all changes you have made to the permissions table.
- Select Discard Changes to revert all unsaved modifications back to their last saved state.
Access level definitions
A reference section at the bottom of the page explains each access level:- No Access: Feature is hidden/disabled for this access type
- Full Access: Users can see all people matching the search criteria
- Chain of Command: Users can only see people in their reporting hierarchy that match the search criteria
- Above Grade: People search will only return users above the specified grade level when searching based on skills
Configuring Learning and Training
The Learning & Training category lets administrators define the metadata attributes that categorize and describe training resources in your library. Consistent metadata makes it easier for employees to find relevant training and for administrators to organize and filter the library. Open Settings, then go to Learning & Training to manage these attributes. There are five attribute types you can configure, each managed through its own drawer:Managing a training attribute
The workflow is the same for all five attribute types:Open the attribute drawer
Add, edit, or delete items
- Add a new item by selecting + Add Type, entering a name, and selecting Save
- Edit an existing item by clicking on it
- Delete an item that is no longer needed
- Reorder items by dragging them to a new position
Save and close
Managing Org Structure
The Org Structure settings let you define and maintain the organizational hierarchy used across SkillsDB. These values populate fields on employee profiles, drive search and filtering, and enable targeted settings scoping. Open Settings, then go to Org Structure (under People & Access) to open the Org Structure management page.Available org structure attributes
SkillsDB supports twelve organizational attribute types, each managed on its own tab. The tabs appear in this order:Adding a new org structure item
Select the tab
Add the item
Save
Editing an org structure item
Select the edit (pencil) icon on the item’s row. Update the Name or Active status as needed, then select Save.Deactivating an org structure item
Deactivating an item hides it from selection on new employee profiles while preserving its historical associations on existing records. Select the edit icon for the item, then uncheck the Active checkbox. If the item is currently assigned to employees or other records, a warning dialog appears showing where the item is in use. Review the usage details, then confirm deactivation or cancel.Additional Settings
The Settings page includes several other configuration rows beyond the four structural areas above.Skill Page Chips
A skill’s page shows three chips in its header: People assigned, Experts, and Trained. Each chip links to a list of the people it counts. The Search & Visibility category controls which roles see each chip. Open Settings > Search & Visibility to find the skill chip controls — a table with one row per chip and one column per role: Admin, Full Access, Manager, and Employee. Check or clear a box to show or hide that chip for that role. The Admin column is locked, because administrators always see every chip. When you hide a chip from a role, people in that role also cannot open the chip’s linked list of people.Files
Configure the file types available when users upload files to their profile. Open Settings > Shared Lists to manage file types. See Files for how employees upload files.Skill Assignment Dates
Configure whether users see the date of assignment for each skill in their assessment. Open Settings > Skills & Assessments and find the Skill Assignment Dates control. It has separate switches for the Employee Assessment and the Manager Assessment.Team Skill Overall Progress
The Team Skill Overall Progress control configures the Team > Skills Overall Training Status page. Open Settings > Skills & Assessments to find it. It opens a dialog with two areas:- Default Home Page — When on, users who can access Team > Skills and have no career assignment land on the Overall Training Status page as their home screen.
- Progress Breakdowns — Choose which breakdowns appear on the page: Progress by Label, Progress by Section, and Progress by Skill Group.
Saved Defaults & Saved Pages
Manage saved page defaults and saved pages across the system. Administrators can set default page states for all users and create saved pages that appear as sub-pages under their parent page in navigation. Open Settings > Saved Views to manage them. See Saved Views for details.AI Assistants
Control whether employees can connect their own Claude, ChatGPT, or Microsoft Copilot to their SkillsDB data. Open Settings > AI Assistants to govern read and write access and to review or revoke connections. This category appears only when the AI Assistant feature is enabled for your account. See AI Assistant Connections for details.Documents Settings
The Documents category controls the Documents library. It appears only when the Documents library is available to your organization. Open Settings > Documents to manage these rules. If the Documents page is hidden under Sections & Pages, the Documents settings are locked until you turn the page back on.SSO & SCIM
Open Settings > Sign-In & Provisioning to manage Single Sign-On connections, SCIM provisioning, password login, and SCIM group configurations. See Identity & Provisioning for the full setup.API Credentials
When the public API is enabled for your organization, open Settings > API. API Credentials lets you create, scope, rotate, and revoke REST API keys, and API Usage lets you monitor request volume. A key can never do more than the person it acts as. See API Authentication for details.Common Questions
What is the difference between Settings and Page Settings?
What is the difference between Settings and Page Settings?
Why don't I see some categories that this article describes?
Why don't I see some categories that this article describes?
Can I change my grading scale after employees have completed assessments?
Can I change my grading scale after employees have completed assessments?
What happens to an employee's profile if I deactivate an org structure item they are assigned to?
What happens to an employee's profile if I deactivate an org structure item they are assigned to?
Can managers and employees have different search filter access for the same filter type?
Can managers and employees have different search filter access for the same filter type?
Can I give managers full search access while restricting what they can filter by?
Can I give managers full search access while restricting what they can filter by?
Do training library attribute changes affect existing training resources?
Do training library attribute changes affect existing training resources?
Why can't I change the Admin or Full Access search permissions?
Why can't I change the Admin or Full Access search permissions?