# How to publish a GTM App in GTM One and finish setting it up

> Learn how to publish a GTM App, name it, and choose what to do once it is live.

**Date:** 2026-11-02  
**Source:** https://gtm.ai/docs/gtm-one/apps/publish-an-app

---

Learn how to publish a GTM App, name it, and choose what to do once it is live.

## Overview

A GTM App starts as a draft that only you can open in the builder. Publishing makes it live, so you can share it, pin it to your navigation, and open it from the **Apps** page like any other GTM App. A newly published GTM App is private to you until you share it.

You can publish a GTM App you own. For how to start a GTM App, see [How to Create and Manage a GTM App in GTM One](/docs/gtm-one/apps/browse-apps).

## Publish a GTM App

1. In the left navigation panel, click **Apps**.
2. Click the GTM App's card to open it in the builder.
3. Click **Publish** in the top-right corner of the builder.
4. Click **Yes, Publish** to confirm.
5. Wait while GTM One publishes the GTM App. The screen reads "Publishing" with the GTM App name, and publishing usually takes under a minute.

When publishing finishes, the screen changes to "&lt;app name> is live" with the message "It's published and ready. Here's what you can do next."

## Finish setting up the GTM App

The steps on the live screen are optional. The screen says "These steps are optional. Do them now or later." You can come back to them from the GTM App.

- **Name & describe**: Give the GTM App a clear name and description for the gallery. The name is required. The description appears on the GTM App's card. Click **Generate description** to have GTM One write one from your build chat, then review and edit it. If you leave without saving, GTM One asks "Discard your changes?" Click **Keep editing** to stay or **Discard** to leave.
- **Share with your team**: Add people or open the GTM App to your organization. See [How to share a GTM App or widget in GTM One](/docs/gtm-one/apps/share-an-app-or-widget).
- **Add to sidebar**: Pin the GTM App to your navigation for one-click access, and choose an icon.
- **Choose a thumbnail**: Pick how the GTM App looks on its gallery card. See [How to change a GTM App's thumbnail and description in GTM One](/docs/gtm-one/apps/change-an-apps-thumbnail-and-description).

If you have not shared the GTM App yet, the live screen reminds you that only shared people can open it and offers a **Share first** link.

## Publish later changes

After you edit a published GTM App, the builder shows **Publish changes** in place of **Publish**.

1. On the GTM App's card, open the menu and click **Edit** (clicking a published GTM App's card opens the GTM App itself), then make your changes in the chat.
2. Click **Publish changes** in the top-right corner.
3. Confirm when asked.

Every change you publish updates the live GTM App for everyone who can open it. The GTM App's card shows the status "Unpublished changes" until you do.

## If you see an error

- "Publishing didn't finish". Your preview is live, but publishing did not complete. Click **Retry publish** on the GTM App to try again.
- "Publishing is taking longer than expected - your preview is live. You can retry publishing." Publishing is slow. Wait a moment, then click **Retry publish** if the GTM App does not go live.
- "Couldn't apply your last change". The builder could not apply your most recent request, but the GTM App still has a usable preview. Send the request again with an updated description.
- "Failed to save changes. Please try again." The name or description did not save. Click save again, and check that the name is not empty ("Name is required").

## Resources

- [How to Create and Manage a GTM App in GTM One](/docs/gtm-one/apps/browse-apps)
- [How to share a GTM App or widget in GTM One](/docs/gtm-one/apps/share-an-app-or-widget)
- [How to change a GTM App's thumbnail and description in GTM One](/docs/gtm-one/apps/change-an-apps-thumbnail-and-description)