> For the complete documentation index, see [llms.txt](https://docs.diaflow.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.diaflow.io/workflow-builder/publish-a-workflow.md).

# Publish a workflow

Publish your workflow to make it live for use or sharing.

Publish a workflow when it is ready for real use.

Click **Publish** in the top-right corner.

{% hint style="warning" %}
Before you publish, make sure the workflow runs without errors.
{% endhint %}

After publishing, the workflow becomes active.

What happens next depends on the workflow type.

<figure><img src="https://3864624312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRdo1pkMnofwxf3lpWftw%2Fuploads%2FrZUv59NqVkgDyxtnT8sG%2FPublishWorkflow.gif?alt=media&amp;token=a23df795-0d81-4ba5-958f-f409e9fe6191" alt=""><figcaption></figcaption></figure>

## Publish Tools and Chats

After publishing a **Tool** or **Chat**, you can usually use it in 3 ways:

* share an **internal link**
* share a **public link**
* run it via **API**

<figure><img src="https://3864624312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRdo1pkMnofwxf3lpWftw%2Fuploads%2Fo2oe3rVNgVkJiKrD6eO5%2FShareLink.png?alt=media&amp;token=75b3e1ef-c141-4953-982f-8b080aed0927" alt=""><figcaption></figcaption></figure>

### Share with an internal link

Use an internal link when access should stay inside your workspace.

Signed-in users can open the workflow from that link.

<figure><img src="https://3864624312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRdo1pkMnofwxf3lpWftw%2Fuploads%2FfNAg2yBagtYJfBGOKRY3%2Frounded-image%20(1).png?alt=media&amp;token=b53a02ec-73d3-4d5e-b182-6ae9f2d28019" alt=""><figcaption></figcaption></figure>

### Share with a public link

Use a public link when people outside your workspace need access.

You can copy the link and share it directly.

<figure><img src="https://3864624312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRdo1pkMnofwxf3lpWftw%2Fuploads%2FLDrLUeh2SwwXbjwIKfws%2Frounded-image%20(2).png?alt=media&amp;token=87500ab3-c3cf-4ce0-91d8-e696852f5715" alt=""><figcaption></figcaption></figure>

### Customize the public experience

For public Tools or Chats, you can update the shared page settings.

You can adjust:

* general details such as title, subtitle, logo, cover, color, and style
* input and output settings
* security, including public access or password protection

<figure><img src="https://3864624312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRdo1pkMnofwxf3lpWftw%2Fuploads%2FhbiGjky4ZFNc0IcxKnVe%2FAppearance.gif?alt=media&amp;token=30cd6b0e-e2cc-4c17-bea0-3a4f65f52774" alt=""><figcaption></figcaption></figure>

### Run via API

Use **API Docs** when you want to connect the workflow to another system.

Available examples include:

* Python
* JavaScript
* cURL

<figure><img src="https://3864624312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRdo1pkMnofwxf3lpWftw%2Fuploads%2FNsKCwZiGXgrS4WkBDB6E%2FRunViaAPI.gif?alt=media&amp;token=2e558552-8d48-49b9-a052-8279534fa858" alt=""><figcaption></figcaption></figure>

### Publish Automation

Publishing also makes an **Automation** workflow active.

Automation does not use public sharing links like Tools and Chats.

### Tips

* Publish only after testing with real inputs.
* Use an internal link before switching to a public link.
* Use API access when the workflow needs to run from another app.

### Next steps

* Learn how to [manage a workflow](/workflow-builder/manage-a-workflow.md).
* Learn how to [unpublish a workflow](/workflow-builder/unpublish-a-workflow.md).