> For the complete documentation index, see [llms.txt](https://docs.umbraco.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.umbraco.com/umbraco-cloud/build-and-customize-your-solution/handle-deployments-and-environments/deployment/deploy-dashboard.md).

# Deploy Settings

From the Deploy Settings, you can see your Umbraco Deploy installation and perform Deploy operations.

This article shows the different sections under **Deploy** in the **Settings** section and how they can be used.

The layout of the Deploy settings changed with **Umbraco Deploy 18**. Where the steps or screens differ, this article shows both versions in tabs. Check which version your project is running and follow the matching tab.

{% hint style="info" %}
Not sure which version you're on? Check the **Version** shown at the top of the **Deploy Status** page, or your project's Umbraco version in the Umbraco Cloud Portal.
{% endhint %}

## Accessing the Deploy Settings

To access the Deploy settings in the Umbraco backoffice, follow these steps:

1. Log in to the [Umbraco Cloud Portal](https://www.s1.umbraco.io/).
2. Select your project from the project list.
3. Choose the environment you want to work with.
4. Click **Backoffice** to open the Umbraco backoffice for that environment.

![Backoffice link in the Portal](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-e3d019a689a7a23018082b00209ddd0c6f46fab6%2FPortal-backoffice-link.png?alt=media)

5. Navigate to the **Settings** section in the Backoffice.

{% tabs %}
{% tab title="Version 18+" %}
Locate the **Deploy** section in the **Settings** tree.

![Deploy settings in the Backoffice](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2FTlX1AhDRMCsyKf24A9Ng%2Fdeploy-settings-pages.png?alt=media\&token=d2fe3a49-65b5-44c6-b784-59960b57350f)
{% endtab %}

{% tab title="Earlier versions" %}
Locate the **Deploy** dashboard.

![Deploy settings in the Backoffice](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-73fab4416e17ddfc8062a2c0fc32b2b9c97fd811%2FDeploy-settings-v17.png?alt=media)
{% endtab %}
{% endtabs %}

## Status

Here you can see whether the latest deployment has been completed or failed. You can see the version of Umbraco Deploy you are running and the last time an operation was run.

{% tabs %}
{% tab title="Version 18+" %}
**Status**, **Schema**, and **Configuration** are separate pages. You can access each page from the Deploy section in the Settings tree.

![Umbraco Deploy status and operations](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2FPvJbnF57gyyVBlPbUsSl%2Fdeploy-status.png?alt=media\&token=6049bc4b-6214-404f-afb2-d774d19128a9)
{% endtab %}

{% tab title="Earlier versions" %}
The Deploy dashboard contains information about the Deploy status, Deploy operations, Download Deploy artifacts, the Schema comparison table, and Configuration details.

![Umbraco Deploy status](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-73fab4416e17ddfc8062a2c0fc32b2b9c97fd811%2FDeploy-settings-v17.png?alt=media)
{% endtab %}
{% endtabs %}

### Deploy Operations

The Deploy operations provide the option to run different operations.

Below, you can read what each operation will do when run through the dashboard.

#### Update schema

Running this operation will update the Umbraco Schema based on the information in the `.uda` files on disk.

#### Verify schema

This operation deletes the schema from your current environment if it does not have a matching UDA file. It manually deletes each item in the Schema Comparison overview with an exclamation mark in the 'File Exists' column.

#### Export schema

Running this operation will extract the schema from Umbraco and output it to the `.uda` files on disk.

#### Clear signatures

Running this operation will clear the cached artifact signatures from the Umbraco environment. This should not be necessary; however, it may resolve reports of schema mismatches when transferring content that has been aligned.

#### Set signatures

This operation will set the cached artifact signatures for all entities within the Umbraco environment. Use this when signatures have been cleared, and you want to ensure they are pre-generated before attempting a potentially longer restore or transfer operation.

#### Cleaning up export archives

After running an export, exported zip archives are stored temporarily on the environment. You can delete them from here once you no longer need them.

{% tabs %}
{% tab title="Version 18+" %}
On the Status page, a **Delete export archives** card appears after at least one export archive exists. The card lists the current number of stored archives.

![Delete export archives card](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-159b1587d4c930815a59953b9a0055de4850a386%2Fdelete-export-archives-v18.png?alt=media)
{% endtab %}

{% tab title="Earlier versions" %}
On the Deploy dashboard, a **Delete all exported ZIP archives** section appears after at least one export archive exists. The section shows the number of stored archives.

![Delete all exported ZIP archives section](https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-b6eb1f0c8e6ed0543cd745a97bc5e21fe103b121%2Fdelete-export-archives-v17.png?alt=media)
{% endtab %}
{% endtabs %}

## Schema

On the Schema page, you get an overview of the state of the schema in your environment.

{% tabs %}
{% tab title="Version 18+" %}
The first thing you'll see is a summary of the state of the schema. It'll show how many entities were found across how many entities, and it will also highlight if any items require attention.

<figure><img src="https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2FzxDzn0G809TXPVJbUdu7%2Fschema-comparison-summary.png?alt=media&amp;token=ae5f39c4-5a7c-493a-b239-807347a731aa" alt=""><figcaption><p>Schema Comparison</p></figcaption></figure>

The following table gives you a full comparison between the information that is held in Umbraco and the information in the `.uda` files on disk.

You have the option to hide the schema that is up-to-date, and use quick-links to zoom in on specific types of schema.

<figure><img src="https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2FLpeQRVSM7QpmQIfHmGNX%2Fschema-comparison-table.png?alt=media&amp;token=4eacbce1-5f61-4daa-ba81-313e5cc2c843" alt=""><figcaption><p>Document type schema comparison</p></figcaption></figure>

The table shows:

* The name of the schema.
* The file name.
* Whether the item exists in Umbraco.
* Whether the file exists on disk.
* Whether the file is up-to-date.

You can also view details about a certain element by clicking on either the ellipses or the loop.

This will show the difference between entities stored in Umbraco and the `.uda` file stored on disk.

<figure><img src="https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2FkbrZSc5tbEmJszWxnY4N%2Fschema-comparison.png?alt=media&amp;token=c5b56abf-7ea2-487c-bb90-adba38d7353c" alt=""><figcaption><p>Showing a Schema Comparison for the Data Type Approved Color.</p></figcaption></figure>
{% endtab %}

{% tab title="Earlier versions" %}
The Schema comparison table is further down the Deploy dashboard. It shows a short description followed by **Jump to** quick-links per schema kind, and a **Hide up to date** toggle.

<figure><img src="https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-1e4683b0f80c5bb901874ed9b9a17551b389d6de%2Fschema-comparison-v17.png?alt=media" alt=""><figcaption><p>Schema Comparison</p></figcaption></figure>

The table shows:

* The name of the schema.
* The file name.
* Whether the item Exists in Umbraco.
* Whether the File exists on disk.
* Whether the file is Up to date.

Each row has a **View details** dropdown with two actions: **Create file** and **Delete item**.
{% endtab %}
{% endtabs %}

## Configuration

{% tabs %}
{% tab title="Version 18+" %}
In the Configuration page, you can see how Deploy has been [configured](https://docs.umbraco.com/umbraco-deploy/getting-started/deploy-settings) for your environment. You get an overview of the configuration options, the current value(s), and notes that help you understand each of the settings. Updates need to be applied in the `appsettings.json` file.

<figure><img src="https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2FXxsolQd7xDnId5G1j1zi%2Fdeploy-settings-configuration.png?alt=media&amp;token=56e3acc6-8124-4838-ba92-0ee0491ce29f" alt=""><figcaption><p>Example of Umbraco Deploy configuration.</p></figcaption></figure>
{% endtab %}

{% tab title="Earlier versions" %}
The Configuration details table is further down the Deploy dashboard, below the Schema comparison table. It shows how Deploy has been [configured](https://docs.umbraco.com/umbraco-deploy/17.latest/getting-started/deploy-settings) for your environment. It displays a Setting options column, the Current value(s), and Notes with a Read more link for further detail on each setting. Updates need to be applied in the `appsettings.json` file.

<figure><img src="https://3739769070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPzKn70Piyd2fd5UkYZGf%2Fuploads%2Fgit-blob-427d66e21660c54ee77015f6de7107fd39babc09%2Fconfiguration-details-v17.png?alt=media" alt=""><figcaption><p>Example of Umbraco Deploy configuration.</p></figcaption></figure>
{% 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.umbraco.com/umbraco-cloud/build-and-customize-your-solution/handle-deployments-and-environments/deployment/deploy-dashboard.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.
