> For the complete documentation index, see [llms.txt](https://developer.collibra.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.collibra.com/workflows/managing-workflows-in-collibra/publish-a-workflow.md).

# Publish a workflow

You publish a workflow when you upload the workflow definition or exported Workflow Designer app to Collibra Platform.

You can upload a workflow in ZIP, BPMN, and bpmn20 XML format.

Starting with Collibra Platform version 2023.05, you can also publish workflow apps directly from the Workflow Designer to the connected environment.

## Prerequisites

You have a global role with the **Workflow Administration** or the **System administration** global permission, for example Sysadmin.

## Steps

{% tabs %}
{% tab title="Direct publishing" %}
{% stepper %}
{% step %}
In Workflow Designer, open a workspace.
{% endstep %}

{% step %}
For the app you want to publish, select <img src="https://2208542399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAeKwSsP1BP6lDDArkTO2%2Fuploads%2Fgit-blob-d85e2bfd7e0cf578d5fa5a9cc8000a159b4bbdca%2FMoreIcon.svg?alt=media" alt="More icon" data-size="line"> more → Publish
{% endstep %}

{% step %}
Click **Publish App** to confirm and upload the workflow to the target environment.
{% endstep %}
{% endstepper %}

{% hint style="success" %}
The target environment is the Collibra environment you used to access the Workflow Designer.
{% endhint %}
{% endtab %}

{% tab title="Manual upload" %}
{% stepper %}
{% step %}
On the main toolbar, click <img src="https://2208542399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAeKwSsP1BP6lDDArkTO2%2Fuploads%2Fgit-blob-c495609e46095abc7bbc4b08bd4d0e0beebb917a%2FProductsIcon.svg?alt=media" alt="Products icon" data-size="line"> → <img src="https://2208542399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAeKwSsP1BP6lDDArkTO2%2Fuploads%2Fgit-blob-268a786d787f353b92e094a60945df32bf9cb208%2FCogwheelIcon.svg?alt=media" alt="Cogwheel icon" data-size="line"> **Settings**.\ <i class="fa-chevrons-right">:chevrons-right:</i> The **Settings** page opens.
{% endstep %}

{% step %}
Click **Workflows** → **Definitions**.
{% endstep %}

{% step %}
Click **Upload a file** and select the workflow definition you want to publish or drag and drop your workflow in the upload section.\ <i class="fa-chevrons-right">:chevrons-right:</i> A progress bar displays the upload progress. In case the update fails, you see an error message.
{% endstep %}
{% endstepper %}
{% endtab %}
{% endtabs %}

{% hint style="danger" %}
Uploading a workflow with the same process ID as an existing workflow in Collibra replaces the existing workflow.
{% endhint %}

{% hint style="info" %}
Collibra does not accept two workflows with the same display name.
{% endhint %}

## What's next

After a successful workflow publishing, [edit the workflow definition settings](/workflows/managing-workflows-in-collibra/view-and-edit-workflow-definition-settings.md) in Collibra.