> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useagents.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Reviewing Changes

> Review and compare draft changes against the current deployment before deploying to the registry.

Use the **Changes** page to review everything that differs between your draft and the live version of a tool before you deploy.

## Open the Changes page

1. Go to the [dashboard](https://useagents.site/dashboard).
2. Open a tool.
3. Click **Changes** in the sidebar.

A red dot appears next to **Changes** when you have pending updates.

## What creates changes

Changes are created when you edit fields on **Edit Tool**:

| Group             | Fields                                                                |
| ----------------- | --------------------------------------------------------------------- |
| **Tool identity** | Name, tagline, description, image                                     |
| **Agent usage**   | Quickstart (per language), input shape, output shape, common pitfalls |
| **Discovery**     | Tags, categories, languages, frameworks                               |
| **Sources**       | Website, repo URL, docs URL                                           |

Edits are saved to a **draft**. The Changes page compares that draft to the **published** version, or to nothing if the tool has never been deployed.

See [Editing Your Tool](/developers/editing-tools) for a full field reference and limits.

## If there are no changes

If your draft matches the published version, you will see **No Pending Changes**.

## Change categories

Changes are grouped by type:

| Category      | Description                                                             |
| ------------- | ----------------------------------------------------------------------- |
| **Tool Info** | Metadata changes such as name, description, links, tags, and categories |

Each change shows **Previous** (published) and **Current** (draft) values. Click a change to see full details in a side panel.

## Undo a change

You can discard a single pending edit without resetting the whole draft:

1. Hover a change row to reveal **Undo change** on the far right of the preview, or
2. Open the change detail sheet and click **Undo change**.

Undo restores that field to the last deployed value (or clears it on a brand-new tool). Other pending changes stay intact.

## Required fields before deployment

Before deploying, required readiness fields must be complete:

* **Name**
* **Slug** (at least 3 characters)
* **Tagline** (10 to 160 characters)
* **Description** (max 500 characters)
* **Quickstart** (at least one language with usage code)
* **Categories** (at least one)

If any are missing, the page shows a warning with a link to **Edit Tool**.

## Deploy changes

1. Review the changes on the page.
2. Click **Deploy** in the alert or sidebar.
3. Optionally add a commit message describing the changes.
4. Confirm to start the deployment.

The deployment runs in the background. Check **Deployments** for status.

## New tools vs. updates

* **New tool**: The page shows all draft fields as changes. Deploy to publish for the first time.
* **Published tool**: The page shows only the differences between your draft and the live version.

## Next steps

* [Editing Your Tool](/developers/editing-tools) to update metadata
* [Publishing & Deployments](/developers/publishing) to understand deployment flow