> 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 
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 
→ 
**Settings**.\ :chevrons-right: 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.\ :chevrons-right: 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://developer.collibra.com/workflows/managing-workflows-in-collibra/publish-a-workflow.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.