# Manage Mentors

**Important:** Only program administrators can access and manage mentors for their mentorship program. Users must have an LFID (Linux Foundation ID) to be invited. If they already have a mentor profile, they will be added with **Approved** status. If they don't have a mentor profile yet, they will be added with **Pending** status and receive an email to create their mentor profile.

1. Log in to Mentorship, click the **My Mentorships** tab.
2. Select the program for which you are an administrator. Click the program card.
3. On the program details page, click the **Mentors** tab to view the list of all mentors associated with the program.

![](https://3411187760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2DCN9UgoRgMEkgnLyP-887967055%2Fuploads%2Fgit-blob-d44b5e8764f9351de3cdc52b1576854f0666699c%2Fmanage-mentors.png?alt=media)

Please note the following mentor statuses:

* **Pending**: The mentor has been invited to the program but has not yet accepted or declined the invitation. The invitation is awaiting their response.
* **Approved**: The mentor has accepted the invitation and is actively participating in the mentorship program.
* **Declined**: The mentor has declined the invitation to participate in the program.
* **Withdrawn**: The mentor has voluntarily withdrawn from the program. Mentors can change their status to Withdrawn at any time, even after an administrator has approved or declined their status.

The Mentors section contains the following information:

| Name                             | Description                                                                                                                                                                         |
| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Mentor**                       | Mentor name and avatar. Click the mentor name to view their public profile page in a new tab.                                                                                       |
| **Status**                       | Indicates mentor status (Pending, Approved, Declined, or Withdrawn). Use the dropdown to change the status. Note that mentors can change their own status to Withdrawn at any time. |
| **Invitation/Application Dates** | **Created:** Date when the mentor was first invited to the program.                                                                                                                 |
| **Profile Created?**             | Indicates whether the mentor has created their LFID profile: **YES** (green) or **NO** (red).                                                                                       |
| **+ Invite**                     | CTA button to invite new mentors to the program                                                                                                                                     |
| **Search**                       | Search box to filter mentors by name                                                                                                                                                |
| **Page Size**                    | Dropdown to select the number of mentors displayed per page (10, 20, 50, or 100)                                                                                                    |
| **Previous Page / Next Page**    | Navigation buttons to move through paginated mentor lists                                                                                                                           |

### Inviting Mentors

1. Use the **Search and select mentors...** dropdown to find mentors by email or LFID username.
2. Select a mentor from the search results. The dropdown displays:
   * Mentor avatar
   * Mentor name
   * LFID username
3. Click the **+ Invite** button to send an invitation to the selected mentor.
4. The system will process the invitation based on the mentor's profile status:
   * **If the LF user has a mentor profile**: The mentor will be added to the program with status **Approved**.
   * **If the LF user does not have a mentor profile**: The mentor will be added with status **Pending**, and an email will be sent to them requesting that they create a mentor profile first. Once they create their mentor profile, they can then accept or decline the invitation.

**Note:** The search results only display users who have an existing and verified LF Account. If a user has not verified their LF Account via email, they will not appear in the mentor search results. If the user you are looking for has a verified LF Account but has not yet set up a mentor profile, they will still appear in the search results and can be invited — they will automatically receive an email prompting them to create their mentor profile before they can accept or decline the invitation.

### Searching Mentors

Use the search box at the top of the page to filter mentors by name. The search is case-insensitive and updates the mentor list in real-time. Click the × icon to clear the search filter.

### Managing Mentor Status

1. Locate the mentor in the list whose status you want to change.
2. Click the status dropdown in the **Status** column.
3. Select the new status (Pending, Approved, or Declined).
4. A confirmation dialog will appear asking you to confirm the status change.
5. Click **Yes** to confirm or **Cancel** to abort the change.

**Important:**

* You cannot change the status of mentors who have not yet created their LFID profile. The status dropdown will be disabled with a tooltip explaining this requirement.
* After changing a status, please wait for the update to complete. Do not refresh the page while the status is being updated.
* **Note:** Mentors can change their status to "Withdrawn" if they do not want to accept the invitation, even after an administrator has approved or declined their status. This allows mentors to voluntarily withdraw from the program at any time.

### Pagination and Page Navigation

The mentor list supports pagination to handle large numbers of mentors:

* Use the **Page Size** dropdown to select how many mentors to display per page (10, 20, 50, or 100).
* Use the **Previous Page** and **Next Page** buttons to navigate through the mentor list.
* The current page number and range of displayed mentors are shown (e.g., "Page 1 (1 - 10)").
