> ## Documentation Index
> Fetch the complete documentation index at: https://help.broadstripes.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage project members from the union portal

> Add members to a project, set their roles and permissions, and deactivate or reactivate memberships from the union portal.

Union admins control who belongs to each project in their group from the union portal. You can add existing group members or brand-new people to a project, choose their role and permissions as you add them, and deactivate or reactivate memberships at any time.

## The project actions menu

Each row in the projects table has an **actions menu** (⋯) next to the project name. It contains the member-management entry points:

<img src="https://mintcdn.com/broadstripes/G1R3JdIXqpp_m7UX/images/admin-guides/union-portal/project-actions-menu.png?fit=max&auto=format&n=G1R3JdIXqpp_m7UX&q=85&s=aa5a25a9aecdbd0b8748b17dbc4fe164" alt="Project actions menu with Edit settings, Manage members, Add members, and Go to project" width="1240" height="258" data-path="images/admin-guides/union-portal/project-actions-menu.png" />

* **Edit settings** -- opens the project's general settings dialog.
* **Manage members** -- opens a panel listing the project's current members, where you can deactivate or reactivate memberships.
* **Add members** -- opens the Add members page for the project.
* **Go to project** -- opens the project itself in a new browser tab.

## Add members to a project

Select **Add members** from a project's actions menu to open its Add members page.

<img src="https://mintcdn.com/broadstripes/G1R3JdIXqpp_m7UX/images/admin-guides/union-portal/add-members-page.png?fit=max&auto=format&n=G1R3JdIXqpp_m7UX&q=85&s=f2af9b9215ec9bd9250aa3ae3f3da216" alt="Add members page with the member search box and selected members area" width="790" height="640" data-path="images/admin-guides/union-portal/add-members-page.png" />

Use the search box to find people. Results only show people who belong to at least one other project in your group and are not already members of this project. Each result shows the person's name, email, and how many of your group's projects they belong to.

### Set the role and permissions

Selecting a person opens the **Assign project membership role** dialog. Your selections apply only to this person's membership in this project.

<img src="https://mintcdn.com/broadstripes/G1R3JdIXqpp_m7UX/images/admin-guides/union-portal/assign-member-role-modal.png?fit=max&auto=format&n=G1R3JdIXqpp_m7UX&q=85&s=5e6010cd9d9c86931ac8c8c809a6fa74" alt="Assign project membership role dialog with Role dropdown and permission checkboxes" width="544" height="895" data-path="images/admin-guides/union-portal/assign-member-role-modal.png" />

* **Role** (required) -- **Admin** or **Basic user**.
* **Create a linked person for this user account** -- checked by default; creates a person record for the user so they can organize. Not available on read-only projects.
* **Permissions** -- once you pick a role, checkboxes appear for communications permissions (sending SMS, setting opt-in/opt-out, managing call center pools, sending bulk emails) and miscellaneous permissions (downloading files, merging contacts, and more). The available options vary by role -- for example, only admins can be given **Can manage members**, and only basic users need **Can manage public forms** or **Can perform data imports** granted explicitly.

Click **Save and add** to stage the person, or **Cancel** to close without adding them.

### Add someone who is new to Broadstripes

To invite a person who doesn't have a user account yet, type their name or email address in the search box and select **Create a new member named "..."**. A short setup wizard walks you through three steps:

1. **Create user account** -- first name, last name, and email address, plus an optional note for the invitation email.
2. **Assign membership role** -- the same role and permission choices described above.
3. **Finish** -- a review of what happens next.

The new person is staged in your selection list; their account isn't created until you save the whole list.

### Save your selections

Staged people appear as removable chips with their role badge, and an amber reminder reads **Pending. Click 'Add members' to save.** Nothing is saved until you click the **Add members** button, which shows a count of how many people you're adding.

When you save, Broadstripes adds the members, emails an activation link to anyone you invited as a new user, and returns you to the union portal dashboard with a confirmation toast.

<Warning>
  If you leave the Add members page with people still staged, your selections are discarded. Broadstripes warns you before you leave.
</Warning>

## Deactivate or reactivate a membership

Removing someone from a project is done by **deactivating** their membership -- memberships are never deleted, so you can always reactivate them later.

Select **Manage members** from a project's actions menu to open the project members panel. It lists each member's name, email, last active date, membership status, and role.

<img src="https://mintcdn.com/broadstripes/G1R3JdIXqpp_m7UX/images/admin-guides/union-portal/manage-members-sheet.png?fit=max&auto=format&n=G1R3JdIXqpp_m7UX&q=85&s=54c5d4421fd605031e799f6822be0eb1" alt="Project members panel with membership status toggles for each member" width="1350" height="480" data-path="images/admin-guides/union-portal/manage-members-sheet.png" />

The **Membership status** column holds a toggle for each member. Switch it off to deactivate the membership, or on to reactivate it. The change takes effect immediately -- there is no confirmation step -- and a toast confirms the update.

## View one person's memberships across projects

From the **Users** tab of the dashboard, hover over a person's **Membership status** cell and click the **View user memberships** icon (<Icon icon="list-ul" iconType="light" color="#545454" />). You can also select a person from the union portal header search.

<img src="https://mintcdn.com/broadstripes/G1R3JdIXqpp_m7UX/images/admin-guides/union-portal/user-memberships-modal.png?fit=max&auto=format&n=G1R3JdIXqpp_m7UX&q=85&s=a68501c01f708f8197c64e96368e17d1" alt="User memberships modal listing projects with status toggles and a Deactivate all memberships button" width="1198" height="330" data-path="images/admin-guides/union-portal/user-memberships-modal.png" />

The dialog lists every project membership the person has in your group, with their role, status, last active date, and who invited them. From here you can:

* Toggle any single membership's **Status** to deactivate or reactivate it, just like in the project members panel.
* Click **Deactivate all memberships** to deactivate the person's memberships in every project at once -- useful when someone leaves your organization.

<Note>
  This dialog is for reviewing and deactivating only. To add the person to another project, use that project's **Add members** page.
</Note>
