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.

Add collaborators

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

1. Open your headless project dashboard.
2. Go to Settings > Roles & Permissions.
3. Click Invite People.
4. Enter the email addresses of the people you want to invite.
5. Select a role to assign them.
6. 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.

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.

2. Install the project dependencies:

   Copy

3. Pull the project's environment variables into a local .env.local file with the wix env pull command:

   Copy

After this setup, the collaborator can run wix dev to develop and preview the project locally, and build, preview, and release it with the Wix CLI, just like you can.

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, 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.

2. Go to Settings > Roles & Permissions.

3. Click Manage Roles.

4. Click Create a New Role. Enter a Role Title and optional Description.

5. Click Site Dashboard, then select Manage headless settings.

   

6. 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.

Now, the relevant collaborators can access your project's Headless Settings.

See also

• Share Environment Variables with Collaborators
• Build and Deploy a Project with the Wix CLI