> 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/gyk2kTbte32WAuS5I2on" 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/M6nz1hzJEDs6R4z6SoGf" alt="Products icon" data-size="line"> → <img src="/files/enFqaM2f7lPrOzgBCLEP" 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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.collibra.com/workflows/managing-workflows-in-collibra/publish-a-workflow.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.