# Users

On Umbraco Cloud, users work in almost the same way as on a normal installation of Umbraco. However, there are a few more settings available for the backoffice users on Umbraco Cloud.

In this article, we will show how users work, as well as explain the different settings for users on Umbraco Cloud.

## Umbraco ID

Umbraco ID is a centralized login for all users on Umbraco Cloud, both team members and Umbraco Backoffice users. It is to log in to the Umbraco Cloud Portal, projects, as well as cloning down a project to your local machine.

When working locally the initial login will go through Umbraco ID and the online login flow. After the initial login, you can set a password on your user or create a new local login for the backoffice.

## Adding users on Umbraco Cloud

There are two ways of adding a user to your backoffice on Umbraco Cloud.

You can add them as a [team member](https://docs.umbraco.com/umbraco-cloud/begin-your-cloud-journey/project-features/team-members)) from the project portal on Umbraco Cloud.

By default, when added as a team member, they are added as users to the backoffice of all the environments as administrators.

Users can also be invited directly from the backoffice of your Umbraco Cloud project, from where you can give them different permissions.

Check out the [Users article](https://docs.umbraco.com/umbraco-cms/fundamentals/data/users) for an in-depth explanation about Umbraco users in general.

{% hint style="info" %}
Users are environment-specific on Umbraco Cloud. This means that users are not transferred over when doing a deployment to the next environment. They need to be added to each environment on Umbraco Cloud where their access is needed.
{% endhint %}

## Invite User through the Umbraco backoffice

As mentioned, it is possible to invite new Users to your Umbraco Cloud project through the backoffice.

To invite a User you need to do the following:

1. Go to the backoffice of your Umbraco Cloud project.
2. Go to the **Users** section in the backoffice.
3. Click on the **Invite User** button.
4. Enter the **Name**, **Email**, add a User Group to assign access and permissions, and enter a new **Message** for the invitation.

![Invite User](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-02be07ae66ce109c4b3e616545283b1077a9ae94%2Finvite_user.png?alt=media\&token=745caa18-8aba-43cb-90b1-8a9a65c8bb96)

### Accept invitation

Once the User has been invited they will receive an invitation for the project.

If the invited person already has a user on Umbraco Cloud they will see the invitation in the project portal under "Project Invites".

If the User being invited does not have a User on Umbraco Cloud, they will receive an email asking them to create one.

![New User Invitation](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-4ea717c9b81caf3464a610a527000677667a3e53%2FNew_user.png?alt=media\&token=dac40575-df8f-4258-9b33-f51960e3b303)

Once the User has been created, it is now possible for them to log in to the Umbraco Cloud portal.

From here they will be able to see a pending invitation to the project they have been invited to.

Once the invitation has been accepted, they can now access the project through the Umbraco Cloud portal and access their site from there.

<figure><img src="https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-8cdfca15ca306ce51adeba5372a699d2211c9989%2Fimage.png?alt=media" alt="Project overview"><figcaption><p>Project overview</p></figcaption></figure>

## User group permissions for transfers and restores

On Umbraco Cloud, it is possible to control which users have access to transferring and restoring content and media on your Umbraco Cloud project.

This can be done when creating a new User Group or when editing an existing group.

You can decide whether a specific User Group has permission to do restores and queue content for transfer to the next environment.

It is also possible to get Granular control on a per-node basis to restrict restores and transfers of specific content on your site. This can help avoid mistakes and ensure that the proper workflows are followed.

### Set up Permissions for transfers and restores

There are two ways that you can set up these permissions:

* Create a new User Group
* Edit an existing one

To create a User Group, go to the **Users** section of the backoffice.

1. Click on "Groups" in the right corner, from here you are able to either create a new User Group or edit an existing one.

![User Groups](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-c68dc75c5fda0051a1f3e6ad1c82a7b3a6b4c5c1%2FUsers.png?alt=media\&token=7e5a78a1-39b6-43f7-9294-08352ba51260)

2. Click "Create group"
3. Scroll down and go to the "Content" heading in the "Default permissions" section. Here you can see three options:

![User Groups](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-64f12a8a00b0fdb9ffe13d88e4ff4df0513a77a7%2Fdefault_permisions-v10.png?alt=media\&token=29980058-7bb3-441d-a1d0-425066a5f2aa)

4. Decide whether the users in the new User Group can restore items for the whole workspace, restore items for a tree, or partially restore items and click **Save**.

To edit an already existing User Group:

1. Go to the User Group you want to edit, e.g Editors or Writers.
2. Update the permissions and click **Save**.

### Granular Permissions

It is also possible to set Granular permissions for a specific content node on your Cloud project.

You can set the permission when you are creating or editing an existing User Group.

1. Add the setting for Granular permission for your content nodes at the bottom of the User Group.

![Granular permission](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-efb53f05ba59100e42610803e55cf8f2f1426997%2FGranular.png?alt=media\&token=e34afd19-53ee-42cc-91bf-f25096c542da)

2. Click "Add".
3. Choose the content node which you want to set the Granular settings for.

![Granular content node](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-b9aff49dbd8f0687b58a641c9ba516fb5406df5b%2FGranular_node.png?alt=media\&token=45b6d7bb-f0a5-4467-aa34-85705dc963c6)

4. Set permissions for restore, partial restore, and queueing content for transfer.

![Granular permission](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-1b1c3c92374d335cb50bd84fd1b300b4b460260e%2FGranular_permission-v10.png?alt=media\&token=5a1aaeba-bb7e-4a59-b405-c1f2bfbf5bb8)


---

# Agent Instructions: 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:

```
GET https://docs.umbraco.com/umbraco-cloud/begin-your-cloud-journey/project-features/users-on-cloud.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
