mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
f14cca3b52
* Standardize style: 'Click' to 'Select' for Mintlify UI; split long sentences Generated-By: mintlify-agent * Revert 'select' back to 'click' for UI interactions Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * Fix select→click for UI elements across docs Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
78 lines
4.2 KiB
Plaintext
78 lines
4.2 KiB
Plaintext
---
|
|
title: "Enable workflows"
|
|
description: "Enable workflows on your Mintlify project. Configure GitHub or GitLab triggers, add context repositories, set schedules, and turn on automerge for the agent."
|
|
keywords: ["cron", "push trigger", "automerge"]
|
|
---
|
|
|
|
import GitlabWorkflowSetup from '/snippets/gitlab-workflow-setup.mdx';
|
|
|
|
## 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)
|
|
|
|
## Enable workflows
|
|
|
|
1. Open the [Workflows](https://dashboard.mintlify.com/products/workflows?tab=workflows) page in your dashboard.
|
|
2. Click the toggle beside a workflow to enable it.
|
|
<Frame>
|
|
<img src="/images/workflows/workflows-dashboard-light.png" alt="The workflows dashboard." className="block dark:hidden" />
|
|
<img src="/images/workflows/workflows-dashboard-dark.png" alt="The workflows dashboard." className="hidden dark:block" />
|
|
</Frame>
|
|
|
|
If the workflow can run with default settings, it activates immediately. Otherwise, the settings modal opens so you can choose any required configurations.
|
|
<Frame>
|
|
<img src="/images/workflows/workflow-settings-light.png" alt="The configuration options for the codebase updates workflow." className="block dark:hidden" />
|
|
<img src="/images/workflows/workflow-settings-dark.png" alt="The configuration options for the codebase updates workflow." className="hidden dark:block" />
|
|
</Frame>
|
|
3. If the modal opens, fill in the required fields and click **Turn on workflow**.
|
|
|
|
To change settings for an active workflow, click the <Icon icon="gear" /> settings button beside it. Use the toggle in the modal header to enable or disable the workflow without leaving the settings view.
|
|
|
|
## Configurations
|
|
|
|
### Trigger repositories
|
|
|
|
For workflows that run on push events, specify the repositories to watch. You can specify up to 10 repositories per workflow.
|
|
|
|
For GitHub repositories, you must install the Mintlify GitHub App on each repository. Add repositories on the [GitHub app](https://dashboard.mintlify.com/settings/organization/github-app) settings page.
|
|
|
|
### Update mode
|
|
|
|
Each workflow has a default mode for how it makes updates, either by directly updating your content repository or by opening a pull request.
|
|
|
|
If you want to require reviews before a workflow updates your content, click **Require review**.
|
|
|
|
<Note>
|
|
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.
|
|
</Note>
|
|
|
|
### Trigger
|
|
|
|
Each workflow has a default for when it runs, either in response to changes in your content repository, in response to changes in a trigger repository, or on a schedule.
|
|
|
|
If you want to change the default, select a different trigger.
|
|
|
|
### Instructions
|
|
|
|
Add optional instructions appended to the workflow's base prompt. Use these instructions to adjust the style, tone, or other aspects unique to your project.
|
|
|
|
### Target languages
|
|
|
|
When you enable the **Translate content** workflow, select one or more languages you want 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 change the target languages at any time by opening the workflow's settings and editing the **Translate to** field.
|
|
|
|
#### Run a translation immediately
|
|
|
|
After saving the workflow, click **Translate now** to run it on demand using the currently saved target languages. The workflow must be enabled to trigger a manual run. Manual runs do not affect the workflow's regular trigger.
|
|
|
|
<GitlabWorkflowSetup />
|