> 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="/files/6ZTfUM0vMCeUFyHtKu7Q" 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="/files/ySBCRBEDHEzOjr0ezM0a" alt="Products icon" data-size="line"> → <img src="/files/zKTZ6Dn3KsOlOa4U7Hzf" 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.