> 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/common-workflows/inviting-users.md).

# Inviting users

<mark style="color:$primary;">**Outcome**</mark>\
You invite a user to a space, either to a specific instance with a non-administrative role or to the whole space as an Administrator.

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

* You hold the **Space Administrator** role in the space (the creator of a space automatically has this role).
* You have the email addresses of the users you want to invite.
* You have decided what to invite them to - an individual instance, a shared instance, or the whole space as Administrator.

Inviting a user to a Nuvolos space follows the same click-flow regardless of who you are inviting and why. This page documents the mechanic; the role-specific framing - what you invite people for, whether they get an individual or shared instance, what role to assign - is covered in the role-specific documents.

### The procedure

{% stepper %}
{% step %}
Navigate to the space (course or project) you want to invite the user to.
{% endstep %}

{% step %}
Click the cogwheel icon and select Project Users / Instances (called Course Users / Instances in course spaces - the same option, different label).
{% endstep %}

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

{% step %}
Choose between the two invitation options (see below).
{% endstep %}

{% step %}
For Option 1, additionally choose whether to invite to an existing shared Instance or create individual Instances per invitee.
{% endstep %}

{% step %}
Choose the invitation method (invite link or email).
{% endstep %}

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

### Invitation options

<table data-header-hidden><thead><tr><th valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Option</td><td valign="top">What it does</td></tr><tr><td valign="top">Option 1 - User Invitation</td><td valign="top">Invites the user to a specific instance with a non-administrative role. You pick the instance and the role (typically Instance Editor).</td></tr><tr><td valign="top">Option 2 - Administrator Invitation</td><td valign="top">Invites the user as a Space Administrator with full privileges across the entire space. They can see all instances, invite further users, and create new instances.</td></tr></tbody></table>

Individual instances are typical for course students. Shared instances are typical for group members and co-authors on a research project.

### Invitation methods

* **Invite link** - share a URL; anyone who clicks it joins. Easiest for larger cohorts.
* **Email -** enter specific email addresses. Better for targeted invitations.

{% hint style="warning" %}
When inviting users who already have a Nuvolos account, use the email address listed under their name in the Members list of any space they are already in. If you send the invitation to a different address, they will not be able to accept it with their existing account - they will be forced to create a new one.
{% endhint %}

### Role-specific notes

This page covers only the mechanical click-flow. For role-specific applications:

{% tabs %}
{% tab title="🎓 For instructors" %}
See [How-to › For Instructors › Invite students](/how-to-guides/workflows-for-instructors/invite-students.md) for cohort-scale invitations with individual instances per student, and [How-to › For Instructors › Invite teaching assistants and co-instructors](/how-to-guides/workflows-for-instructors/invite-tas.md) for Administrator invitations.
{% endtab %}

{% tab title="📖 For students " %}
Students typically don't invite other users. The exception is when a student Space Administrator on a group project needs to invite an additional group member; the procedure is the same as above.
{% endtab %}

{% tab title="🔬 For researchers" %}
See [How-to › For Researchers › Invite collaborators](/how-to-guides/workflows-for-researchers/invite-collaborators.md) for Administrator vs. Instance Editor decisions for co-authors, and [How-to › For Researchers › Invite an external reviewer](/how-to-guides/workflows-for-researchers/inviting-a-reviewer.md) for the snapshot-and-Instance-Editor pattern for journal reviewers.
{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.nuvolos.com/how-to-guides/common-workflows/inviting-users.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.