Skip to main content
Quick Summary: The Settings area gives administrators full control over the structural foundations of SkillsDB — including how skills are graded, who can search for what, how training resources are categorized, how your organizational hierarchy is defined, and other platform-wide behaviors.

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.
Note: All settings in this area are organization-wide and apply to every user in your SkillsDB instance. Only administrators can access and modify settings. Some rows appear only when the related feature is enabled for your organization.

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
Company Settings page listing settings rows including Hide Manager Grades, Hide Library Sections, Enable Skill Flags, Flags, Enable System Emails, and Email Notifications

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. Some categories appear only under certain conditions:
  • 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.
Note: The General category’s settings are not editable yet. The categories you see also depend on your role — most categories are Global Admin only.

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:
Important: Once any grade has been used in an assessment, that grade’s number is permanently locked and cannot be edited or deleted. You can always update the descriptions of a grade at any time, even after the grade has been used.

Adding a new grade

1

Open the grading scale

Open Settings, then go to Skills & Assessments and open Grading Scale.
2

Add a new grade

Select + Add new Grade. A confirmation modal appears showing the next available grade number (for example, “Are you sure to add new grade level 6?”).
3

Enter descriptions

Enter a Short Description (required, maximum 100 characters). Optionally enter an Extra Description to provide additional details or examples for this grade level.
4

Confirm

Select Confirm to save the new grade.
The new grade immediately appears in the grading scale table and becomes available for use in assessments throughout SkillsDB.

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

Tip: Set up your complete grading scale before launching assessments. Once grades are used, their numbers are locked. Most organizations use a 1–5 scale, though SkillsDB supports up to grade 10.

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. Search Permissions page showing the Role-Based Permissions matrix with Admin, Full Access, Manager, and Employee columns

Understanding roles and access levels

Search permissions are configured across four columns representing security groups:

Permission types

The permissions table contains the following rows: Each filter can be set to No Access, Full Access, or Chain of Command for each role. The Admin column is always locked at Full Access.

People Search Access levels

Important: When the Manager role’s People Search Access is set to Chain of Command, all filter options for that role are automatically limited to No Access or Chain of Command. Filters cannot be set to Full Access for a manager who only has chain of command people search access.

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:
1

Open the attribute drawer

Open Settings, then go to Learning & Training. Select Manage on the attribute type you want to configure.
2

Add, edit, or delete items

In the drawer that opens, you can:
  • 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
3

Save and close

Select Save to persist changes, then Close to return to the Training Library Settings page.
Tip: Set up training library attributes before adding resources to the library. Attribute values set here appear as selectable options when administrators create or edit training resources.

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: Each tab shows a count of total and active items, a search bar for filtering, and an Add button.

Adding a new org structure item

1

Select the tab

On the Org Structure page, select the tab for the attribute type you want to manage.
2

Add the item

Select the Add button (for example, + Add Business Unit). In the modal, enter the item Name (required). Confirm the Active checkbox is checked if the item should be immediately available.
3

Save

Select Save. The new item appears in the list and is immediately available for assignment to employee profiles.

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.
Important: Deactivating an org structure item does not remove it from existing employee profiles — historical assignments are preserved. The item is simply no longer available as a selectable option for new assignments.
Tip: Build out your full org structure before running your initial People import. Org structure values in the import file are matched against existing items, and consistent naming prevents duplicates.

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. Changes to the role selections and the switch save immediately. For the Documents library itself, see Knowledge Documents.

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

Settings (this article) covers the organizational configuration areas: grading scale, search permissions, training library attributes, org structure, file types, and other structural settings. These define the data and rules SkillsDB operates on.Page Settings covers feature toggles and page visibility controls — such as whether library sections are shown, whether skill flags are enabled, and whether system emails are sent. See Page Settings for details.
Some categories appear only when the related feature is enabled for your organization. Activity, AI Assistants, API, Import, and Documents appear only when those features are available to your organization, and Billing & Plan appears only when self-serve billing is enabled. Most categories are also Global Admin only. If you expect a category and do not see it, contact your SkillsDB account manager. You can also type in the Find settings… box to confirm whether a category is present for your workspace.
You can always add new grades and update grade descriptions. However, grade numbers that have been used in at least one assessment are permanently locked — their numeric value cannot be changed, and they cannot be deleted. Plan your grading scale thoroughly before assessments begin. Most organizations use a 1–5 scale, though SkillsDB supports up to grade 10.
Deactivating an org structure item preserves all existing assignments. Employees whose profiles reference the deactivated item are not affected — the item continues to appear on their profile. The deactivated item is simply removed from dropdown menus so it cannot be selected for new assignments.
Yes. Each filter permission (skill grades, certifications, career levels, etc.) is configured independently per role. You can grant employees full access to the careers filter while restricting managers to chain of command visibility, or any other combination that matches your organization’s privacy policy.
Yes, partially. If a manager’s People Search Access is set to Full Access, you can independently restrict individual filters (such as setting the Skill Grades Filter to No Access). However, if People Search Access is set to Chain of Command, filters cannot be set above Chain of Command level — they are automatically capped.
Adding new attributes has no effect on existing resources. Deleting an attribute that is currently used on training resources is not recommended and may affect filtering — review current usage before removing any attribute. You can also drag items to reorder how they appear in dropdown menus.
Admin permissions are locked because administrators always have full visibility across SkillsDB. The Full Access role’s People Search Access is also locked at full access because the Full Access role is specifically designed for users who need unrestricted people search capability.

Related Articles

Page Settings

Configure feature toggles, library visibility, and page-level controls

Skill Flags

Set up skill flags and configure trainer designations

People Flags

Create and manage people-specific flags

Labels

Configure organization-wide labels for filtering and tagging

AI Assistant Connections

Govern employee AI assistant access and review connections

Import/Export

Bulk-import employees using org structure fields defined here

Need Help?

If you run into any issues or have questions, reach out to your organization’s SkillsDB administrator or contact SkillsDB Support.