> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.pipelaunch.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# How to Configure Access to the MySolution Skills Object Structure for Recruitment Users

This guide explains how to adjust permissions so that non-admin users with the Recruitment permission set can access and manage the MySolution Skills object structure.
To grant the appropriate access to the skills tree, global categories, and contact skills, you will need to adjust their object and field-level permissions.

## Configuration Options
You have two ways to apply these permissions to your users:
1. **Create a New Permission Set:** Create a dedicated "MySolution Skills Access" permission set and assign it to the relevant users. This is the best practice as it keeps your security model flexible and prevents unwanted changes to base profiles.
2. **Update the Default Profile:** Modify the default profile assigned to your Recruitment users. Keep in mind that this will affect *all* users assigned to that profile.

## Required Object and Field Permissions
Regardless of whether you choose to use a Permission Set or edit a Profile, you must apply the following specific Object and Field permissions to enable full functionality.

### 1. Skill Object (`msf__Skill__c`)
This object represents the individual skills and their hierarchy ("parent" skills) in the tree.

* **Object Permission:** Read

| **Field API Name** | **Read** | **Edit** | **Description** |
| `msf__Skill_Definition__c` | ✔️ |  | The "global category" the skill belongs to |
| `msf__Order__c` | ✔️ |  | Ordering/sorting value |
| `msf__Skill__c` | ✔️ |  | The "parent" skill in the hierarchy tree |


An example of correctly configured minimum object permissions for `msf__Skill__c`:

![](https://storage.crisp.chat/users/helpdesk/website/-/3/4/8/a/348acba567d60c00/image_dzezmb.png)
![](https://storage.crisp.chat/users/helpdesk/website/-/3/4/8/a/348acba567d60c00/image_doisut.png)

| We suggest enabling "View All Records" object permission to give users access to all new and existing skills, provided there are no access restrictions requiring more granular control.

### 2. Skill Definition Object (`msf__Skill_Definition__c`)
This object represents the global categories (which act as tabs on the skills page).

* **Object Permission:** Read

| **Field API Name** | **Read** | **Edit** | **Description** |
| `msf__Use_for_Candidates__c` | ✔️ |  | Indicates if this category is usable for Contacts/Candidates |

An example of correctly configured minimum object permissions for `msf__Skill_Definition__c`:

![](https://storage.crisp.chat/users/helpdesk/website/-/3/4/8/a/348acba567d60c00/image_1yjlxij.png)
![](https://storage.crisp.chat/users/helpdesk/website/-/3/4/8/a/348acba567d60c00/image_1loc8le.png)
### 3. Contact Skill Object (`msf__Contact_Skill__c`)
This is the master-detail junction object that links a Contact (Candidate) to a specific Skill.

| By creating and deleting these junction objects, users are able to link skills to / unlink skills from a Candidate (Contact)

* **Object Permission:** Read, Edit (Write)

| **Field API Name** | **Read** | **Edit (Write)** | **Description** |
| `msf__Contact__c` | ✔️ | ✔️ | Lookup to the Contact |
| `msf__Skill__c` | ✔️ | ✔️ | Lookup to the Skill |


| Because `msf__Contact_Skill__c` is a master-detail junction object, users will also need the appropriate sharing access to the parent `Contact` records to create or edit these junction records successfully.

An example of correctly configured minimum object permissions for `msf__Contact_Skill__c`:

![](https://storage.crisp.chat/users/helpdesk/website/-/3/4/8/a/348acba567d60c00/image_5uirht.png)

![](https://storage.crisp.chat/users/helpdesk/website/-/3/4/8/a/348acba567d60c00/image_t7clql.png)


### Steps to Apply via a New Permission Set

If you choose the recommended Permission Set route, follow these steps:
1. Navigate to **Setup** > **Users** > **Permission Sets**.
2. Click **New**, name it *MySolution Skills Access*, and save.
3. Go to **Object Settings** within the new Permission Set.
4. Locate the three objects listed above (`msf__Skill__c`, `msf__Skill_Definition__c`, `msf__Contact_Skill__c`), enable the required Object permissions, and check the specific Field permissions as outlined in the tables.
5. Save your changes and click **Manage Assignments** to assign this Permission Set to your Recruitment users.