> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Invite Collaborators

## Article: Invite Collaborators

## Article Link: https://dev.wix.com/docs/go-headless/project-management/invite-collaborators.md

## Article Content:

# Invite Collaborators

This article explains how to add collaborators to your headless project, share your frontend code so they can develop, preview, and deploy the project with you, and optionally grant them access to your project's [**Headless Settings**](https://www.wix.com/my-account/site-selector/?buttonText=Select%20Site&title=Select%20a%20Site&autoSelectOnSingleSite=true&actionUrl=https:%2F%2Fwww.wix.com%2Fdashboard%2F%7B%7BmetaSiteId%7D%7D%2Foauth-apps-settings).

## Add collaborators

Invite people to your project and assign them a role that determines what they can access.

1. Open your headless project dashboard.
1. Go to **Settings** > **Roles & Permissions**.
1. Click **Invite People**.
1. Enter the email addresses of the people you want to invite.
1. Select a role to assign them.
1. Click **Send Invite**.

The people you invite receive an email invitation to join your project. Once they accept, they appear in your **Roles & Permissions** list.

> **Note:** Standard roles don't include access to your project's **Headless Settings**. To grant that access, assign a custom role as described in [Grant collaborators permissions to Headless Settings](#grant-collaborators-permissions-to-headless-settings).

## Share your frontend code with collaborators

Adding someone as a collaborator gives them access to your project's dashboard and settings, but not to your frontend code. Your code lives in your own version control, so you share it the same way you'd share any codebase. For example, you can push your code to a GitHub repository and give your collaborators access from there.

Once a collaborator has the code, they can set up the project locally and work on it with you:

1. Get the project code. For example, clone the relevant GitHub repository.
1. Install the project dependencies:

    ```bash
    npm install
    ```

1. Pull the project's environment variables into a local `.env.local` file with the [`wix env pull`](https://dev.wix.com/docs/wix-cli/command-reference/project-commands/env-pull.md) command:

    ```bash
    wix env pull
    ```

After this setup, the collaborator can run [`wix dev`](https://dev.wix.com/docs/wix-cli/command-reference/project-commands/dev.md) to develop and preview the project locally, and [build, preview, and release](https://dev.wix.com/docs/go-headless/wix-managed-headless/project-development/build-and-deploy-with-the-cli.md) it with the Wix CLI, just like you can.

> **Note:** To pull environment variables and deploy the project, a collaborator must be [added to the project](#add-collaborators). For sharing secrets and other environment variables, see [Share Environment Variables with Collaborators](https://dev.wix.com/docs/go-headless/wix-managed-headless/project-development/environment-variables/share-environment-variables.md).

## Grant collaborators permissions to Headless Settings

Most collaborators who work on your frontend don't need this access. Grant it only to collaborators who need to manage your project's [**Headless Settings**](https://www.wix.com/my-account/site-selector/?buttonText=Select%20Site&title=Select%20a%20Site&autoSelectOnSingleSite=true&actionUrl=https:%2F%2Fwww.wix.com%2Fdashboard%2F%7B%7BmetaSiteId%7D%7D%2Foauth-apps-settings), such as OAuth apps, redirect URIs, and API keys.

By default, collaborators can't access your **Headless Settings**. To grant this access, create a custom role with the **Manage headless settings** permission and assign it to your collaborators.

### Step 1 | Create a custom role

1. Open your headless project dashboard.
1. Go to **Settings** > **Roles & Permissions**.
1. Click **Manage Roles**.
1. Click **Create a New Role**. Enter a **Role Title** and optional **Description**.
1. Click **Site Dashboard**, then select **Manage headless settings**.

    ![Permission to grant](images/10782c1e6d8a2cc71c6c5b673cfa11d3.png)

1. Click **Save**.

Your new custom role appears in the **Manage Roles** list.

### Step 2 | Assign the role

You can assign the custom role to existing collaborators or invite new collaborators with that role.

::::tabs

:::Existing-collaborator

1. Go to **Settings** > **Roles & Permissions**.
1. Find the collaborator you want to update.
1. Click **More Actions** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/11e10e4f-b84d-4136-a5a9-6109fab0b7d7/2020/10/25/347cc5c6-bce3-4407-82c3-e211e02cab98/398ced84-9ef5-4f70-87cd-4cb39a66dd65.png) next to their name and select **Change role**.
1. Choose the custom role you created.
1. Click **Save**.

:::

:::New-collaborator

Follow the steps in [Add collaborators](#add-collaborators) to invite the new collaborators. When you get to the step where you select a role, choose the custom role you created.

:::

::::

Now, the relevant collaborators can access your project's [**Headless Settings**](https://www.wix.com/my-account/site-selector/?buttonText=Select%20Site&title=Select%20a%20Site&autoSelectOnSingleSite=true&actionUrl=https:%2F%2Fwww.wix.com%2Fdashboard%2F%7B%7BmetaSiteId%7D%7D%2Foauth-apps-settings).

## See also

- [Share Environment Variables with Collaborators](https://dev.wix.com/docs/go-headless/wix-managed-headless/project-development/environment-variables/share-environment-variables.md)
- [Build and Deploy a Project with the Wix CLI](https://dev.wix.com/docs/go-headless/wix-managed-headless/project-development/build-and-deploy-with-the-cli.md)