> ## Documentation Index
> Fetch the complete documentation index at: https://www.mintlify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Manage workflows
> Enable, disable, trigger, and delete workflows from your dashboard. Configure GitHub or GitLab triggers, schedules, context repos, and automerge.
## Prerequisites
* A Mintlify project connected to a GitHub or GitLab repository
* For GitHub: the [Mintlify GitHub App](/deploy/github) installed on every repository you plan to use in the workflow
* For GitLab: a connected GitLab account (see [GitLab setup](#gitlab-setup) below)
You can also create, list, and delete workflows from the terminal with [`mint workflow`](/cli/commands#mint-workflow). The CLI is useful for scripting and CI; the dashboard is the easiest way to configure and monitor workflow runs.
## Enable a workflow
1. Open the [Workflows](https://app.mintlify.com/products/workflows?tab=workflows) page in your dashboard.
2. Click the toggle beside a workflow to enable it.
If the workflow can run with default settings, it activates immediately. Otherwise, the settings panel opens so you can fill in any required configurations.
3. If the settings panel opens, fill in the required fields.
4. Click **Turn on workflow**.
To change settings for an active workflow, click the settings button beside it. Use the toggle in the modal header to enable or disable the workflow without leaving the settings view.
## Configurations
### Trigger
Each workflow has a default trigger that controls when it runs. To change the trigger, select a different option in the settings panel.
* **Content update**: Runs whenever you push content to your project repository, including pull request merges and direct pushes.
* **Code change**: Runs when a pull request merges in a connected source code repository. You must specify at least one source repository.
* **Custom schedule**: Runs on a recurring schedule you define. Workflows queue within 10 minutes of the scheduled time.
### Update mode
Each workflow has a default mode for how it makes updates. Either directly merging changes into your content repository or opening a pull request for review.
To require a review before the workflow updates your content, select **Require review** in the settings panel.
For GitHub repositories, automatic updates require the Mintlify GitHub App to have bypass permissions on every ruleset targeting your deploy branch, including organization-level and repository-level rulesets. See [Configure automerge](/guides/configure-automerge) for setup instructions.
For GitLab repositories, automerge uses the GitLab OAuth connection and requires at least the Maintainer role on each project.
### Context repositories
For custom workflows and some predefined workflows, you can add context repositories—additional source code repositories the agent reads when the workflow runs. This is useful when your workflow prompt references code, APIs, or other content that lives outside your project repository.
You can add up to 10 context repositories per workflow. For each GitHub repository, install the Mintlify GitHub App. Add repositories on the [GitHub App settings](https://app.mintlify.com/settings/organization/github-app) page.
### Integrations
For custom workflows and the **Update from code changes** workflow, you can enable connected [agent integrations](/agent/integrations) so the agent can pull context from tools like Slack, Notion, or Linear when the workflow runs.
To enable integrations for a workflow, open its settings and select the integrations you want the agent to use in the **Available integrations** section. Only integrations already connected for your organization appear in the list. See [Agent integrations](/agent/integrations) for more information on connecting integrations.
### Instructions
Add optional instructions that append to the workflow's base prompt on every run. Use these to adjust the style, tone, or other project-specific behaviors without changing the core workflow logic.
### Target languages
When you enable the **Translate content** workflow, select one or more languages to keep in sync with your source content.
* Mintlify reads the [languages](/organize/navigation#languages) defined in your `docs.json` to identify your default language and preselects any already configured target languages.
* You must select at least one target language to save the workflow.
* You cannot select the source language as a target.
You can add target languages at any time by opening the workflow's settings and editing the **Translate to** field.
## GitLab setup
To use GitLab repositories in a workflow, connect each project through the [GitLab OAuth](https://app.mintlify.com/settings/organization/gitlab-oauth) settings page. Connect every repository the workflow touches—your documentation repository and any trigger or context repositories. You must have at least the Maintainer role on each project.
Workflows require a paid GitLab tier. The agent uses short-lived project access tokens for repository access, which GitLab's Free plan does not support.
## Disable a workflow
1. Go to the [Workflows](https://app.mintlify.com/products/workflows?tab=workflows) page in your dashboard.
2. Click the toggle beside a workflow to disable it.
When you re-enable a scheduled workflow, Mintlify recalculates the next run time from the current time.
## View run history
Each workflow keeps a log of past runs, including the status and a summary of changes made.
1. Go to the [Workflow Runs](https://app.mintlify.com/products/workflows) page in your dashboard.
2. Use the dropdown menus to filter by specific workflows or status.
## Related topics
- [Workflows overview](/docs/workflows/index.md)
- [Work with branches](/docs/guides/branches.md)
- [Editor overview](/docs/editor/index.md)