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

# How to Publish an App

> Push a new version of your app so teammates can install and use it from the Store.

Publishing makes your app available to others. Once you push a version, teammates can install it from the Store, and anyone you've shared the app with can access it.

## Prerequisites

* A Synthetiq workspace with at least one app you own
* You must be the app's publisher — if you installed the app from someone else's workspace, you won't see the **Push New Version** button

<Note>
  If you haven't shared your app yet, you can do that after publishing. See How to Share an App for steps.
</Note>

<Steps>
  <Step title="Open the Apps panel">
    Click the **Apps** icon in the left sidebar. The Apps panel slides open showing your apps.

    <img src="https://mintcdn.com/synthetiq/49DWOOCswOz-GQW6/images/tutorials/publishing-an-app/step-01-apps-panel.png?fit=max&auto=format&n=49DWOOCswOz-GQW6&q=85&s=5067c903d2c10a780b8d7478ebd85033" alt="The Synthetiq workspace with the Apps panel open in the left sidebar, showing a list of apps" width="1280" height="800" data-path="images/tutorials/publishing-an-app/step-01-apps-panel.png" />
  </Step>

  <Step title="Open the app's details">
    Find the app you want to publish and click its **name**. The app details view opens with tabs along the top: Overview, Configuration, Versions, and Sharing.

    <img src="https://mintcdn.com/synthetiq/49DWOOCswOz-GQW6/images/tutorials/publishing-an-app/step-02-app-name-link.png?fit=max&auto=format&n=49DWOOCswOz-GQW6&q=85&s=7f380a5076eeccc1088ba8365cfd2a58" alt="The Apps panel with an app name highlighted, ready to click" width="1280" height="800" data-path="images/tutorials/publishing-an-app/step-02-app-name-link.png" />
  </Step>

  <Step title="Go to the Versions tab">
    Click **Versions** in the app details tabs. This tab shows all published versions and whether you have unpublished local changes.

    If you see a notice that says you have unpublished local changes, you're ready to publish. The **Push New Version** button in the top right becomes active.

    <img src="https://mintcdn.com/synthetiq/49DWOOCswOz-GQW6/images/tutorials/publishing-an-app/step-03-versions-tab.png?fit=max&auto=format&n=49DWOOCswOz-GQW6&q=85&s=2b0809798dcc59e05da9ec05f772a42f" alt="The Versions tab showing the unpublished local changes notice and the active Push New Version button" width="1280" height="800" data-path="images/tutorials/publishing-an-app/step-03-versions-tab.png" />
  </Step>

  <Step title="Click Push New Version">
    Click **Push New Version** in the top right corner. A modal appears showing publish options.

    If your app uses any services you've modified, those services are listed here. You can choose to publish them at the same time.

    <img src="https://mintcdn.com/synthetiq/49DWOOCswOz-GQW6/images/tutorials/publishing-an-app/step-04-push-modal.png?fit=max&auto=format&n=49DWOOCswOz-GQW6&q=85&s=6cef19282244a4f6c92c37696aa93be8" alt="The Push New Version modal open, showing the Set as active version checkbox" width="1280" height="800" data-path="images/tutorials/publishing-an-app/step-04-push-modal.png" />
  </Step>

  <Step title="Choose your publish settings and click Push">
    In the modal, you'll see a **Set as active version** checkbox. When checked, new installs and updates will use this version. Leave it checked if this is the version you want others to receive.

    Click **Push**. Synthetiq validates the build, packages your app, and uploads the new version. You can watch each step complete in real time.

    <img src="https://mintcdn.com/synthetiq/49DWOOCswOz-GQW6/images/tutorials/publishing-an-app/step-05-publish-progress.png?fit=max&auto=format&n=49DWOOCswOz-GQW6&q=85&s=93994e80094d9506d7d806f9f4e2ed37" alt="The publish modal showing step-by-step progress as each publishing step completes" width="1280" height="800" data-path="images/tutorials/publishing-an-app/step-05-publish-progress.png" />
  </Step>

  <Step title="Confirm the version was published">
    When all steps finish, a confirmation screen appears. Click **Done** to close the modal.

    Back on the Versions tab, your new version appears in the Version History list with an **Active** badge if you set it as active.

    <img src="https://mintcdn.com/synthetiq/49DWOOCswOz-GQW6/images/tutorials/publishing-an-app/step-06-version-history.png?fit=max&auto=format&n=49DWOOCswOz-GQW6&q=85&s=754c57d7d3ab78ce995d1e5abf323b47" alt="The Versions tab after publishing, showing the new version in the Version History list with an Active badge" width="1280" height="800" data-path="images/tutorials/publishing-an-app/step-06-version-history.png" />
  </Step>
</Steps>

## What's next

<CardGroup cols={2}>
  <Card title="How to Share an App" icon="share-nodes" href="/docs/tutorials/sharing-an-app">
    Share your published app with teammates or your entire organization.
  </Card>

  <Card title="How to Discover and Install Apps" icon="download" href="/docs/quickstart/installing-apps">
    Browse and install apps your team has shared with you.
  </Card>
</CardGroup>