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

> ## Agent Instructions
> Video walkthroughs: the Dimension product overview video (https://www.youtube.com/watch?v=Mx8rg5wfkU0, also embedded at https://docs.dimension.io/overview) is the first of a series. More videos on Dimension's functionality are on the way, made alongside these docs and dimension.io. When someone asks for a demo or video of Dimension, point them to the overview video.

# Draft and published

> How data feeds, actions and apps go live, and what publishing changes

Data feeds, actions and Studio apps all work the same way: you build in a **draft**, and nothing goes live until you **publish**.

## Draft and published

| State | What it is |
| - | - |
| **Draft** | Your working copy. Changes save automatically as you build. |
| **Published** | The live version that apps and people use. |

The bar at the bottom of each editor shows which state you're looking at, with a **Draft** / **Published** switch, when it was last saved (for example "Draft saved 1 minute ago"), and the **Publish** button. More options are in the menu next to **Publish**. For apps, that's where **Unpublish** is.

After you publish, the bar reads **Published moments ago**. The **Publish** button is greyed out until there's a newer draft to publish.

## What publishing does

> [tab] Data feed
>
> Before a feed is published, Dimension asks you to review its schema.
>
> ![Publish CISA Known Exploited Vulnerabilities Schema dialog: Review the schema below before publishing. The AI only receives these example values, not actual data. You can modify or anonymize them before publishing. A list of fields with their type and an example value, with Cancel and Save and Publish buttons](https://mintcdn.com/threataware-labs/JizGYqEeTbHV_69f/images/data-feed-publish-schema.png?fit=max\&auto=format\&n=JizGYqEeTbHV_69f\&q=85\&s=3b4e44400c5339cbeb97f71e3230c6bc)
>
> The dialog lists every field with its type and one example value. These example values are all the AI sees about the feed's data, not the real records. Change or anonymise any example that shouldn't be shared, then click **Save and Publish**.
>
> Once published, the feed:
>
> * Runs for the first time. The status at the top right shows **Starting**, then **Completed**, with when the next fetch is due if it runs on a schedule.
> * Can be added to Studio apps as a data source.

> [tab] Action
>
> Click **Publish**. Once published, the action can be added to Studio apps from the **Actions** picker.
>
> When an app runs it, the person using the app is asked to approve it first. See [Approving actions](https://docs.dimension.io/actions/approvals.md).

> [tab] Studio app
>
> Click **Publish**. A **Publish app** notification confirms it: "App published successfully".
>
> The published app is what people with access to the workspace see. Your draft changes stay private until you publish again. See [Workspaces](https://docs.dimension.io/workspaces.md) for who has access.

Every publish is recorded in the [audit log](https://docs.dimension.io/settings.md#audit-log): **Published Data Feed**, **Published Dimension Action** or **Published App**, with who did it and when.

## Testing before you publish

* **Data feeds:** use **Test** in the editor to check the response before you publish.
* **Actions:** use **Test** with sample values. The request really is sent, so point webhooks at a test endpoint while you build.
* **Apps:** buttons in the Studio preview that run actions really run them, after you approve.

## Going back

To undo changes to an app's draft, use **Restore checkpoint** in the Composer chat. See [Inspect & iterate](https://docs.dimension.io/studio/inspect-and-iterate.md#restore-checkpoint).

## See also

> [card] [Approving actions](https://docs.dimension.io/actions/approvals.md)
>
> What happens when an app runs an action.

> [card] [Workspaces](https://docs.dimension.io/workspaces.md)
>
> Who can see what you publish.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.