> For the complete documentation index, see [llms.txt](https://docs.nuvolos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nuvolos.com/how-to-guides/workflows-for-researchers/invite-collaborators.md).

# Invite collaborators

<mark style="color:$primary;">**Outcome**</mark>\
You invite co-authors and colleagues to your research project with the role that matches their level of involvement.

<mark style="color:$primary;">**Before you start**</mark>

* You are a **Space Administrator** of the project (project creators automatically receive this role).
* You have decided which role each collaborator should hold (Space Administrator vs. Instance Editor - see below).
* You have the email addresses of the collaborators.

Pick the role first, then send the invitation. The two common collaborator patterns:

* **Space Administrator** - gives the collaborator every privilege on the project: editing every instance, inviting more users, creating new instances, and deleting the project. Use for co-authors who need full control.
* **Instance Editor** - limits the collaborator to one specific instance. They cannot create instances, invite users, or modify anything outside that instance. Use for contributors with a defined scope.

For the full role and capability matrix, see [Concepts › Roles, secrets and identity](/concepts/roles-secrets-and-identity.md).

### Invite co-authors as Space Administrators

{% stepper %}
{% step %}
Navigate to the project Space.
{% endstep %}

{% step %}
Click the cogwheel icon and select **Project Users / Instances**.
{% endstep %}

{% step %}
Click **+ INVITE**.
{% endstep %}

{% step %}
Select **Option 2 — Administrator Invitation**.
{% endstep %}

{% step %}
Enter the email addresses of the co-authors.
{% endstep %}

{% step %}
Click **+ INVITE**.
{% endstep %}
{% endstepper %}

### Invite collaborators as Instance Editors

{% stepper %}
{% step %}
Navigate to the project Space.
{% endstep %}

{% step %}
Click the cogwheel icon and select **Project Users / Instances**.
{% endstep %}

{% step %}
Click **+ INVITE**.
{% endstep %}

{% step %}
Select **Option 1 — User Invitation**.
{% endstep %}

{% step %}
Select the Instance and the role you want to assign.
{% endstep %}

{% step %}
Enter the email addresses of the collaborators.
{% endstep %}

{% step %}
Click **+ INVITE**.
{% endstep %}
{% endstepper %}