mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
cef5ca3fdc
- Updated organize/hidden-pages.mdx - Updated customize/custom-domain.mdx - Updated workflows/enable.mdx - Updated index.mdx - Updated ai-native.mdx - Updated quickstart.mdx - Created images/Screenshot-2026-05-19-at-3.40.12-PM.png - Updated docs.json Mintlify-Source: dashboard-editor
101 lines
4.4 KiB
Plaintext
101 lines
4.4 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"]
|
|
---
|
|
|
|
<br />
|
|
|
|
<Steps>
|
|
<Step>
|
|
<Frame>
|
|
|
|
</Frame>
|
|
</Step>
|
|
<Step>
|
|
</Step>
|
|
</Steps>
|
|
|
|
<br />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
|
|
alt="The workflows dashboard."
|
|
className="block dark:hidden"
|
|
src="/images/workflows/workflows-dashboard-light.png"
|
|
/>
|
|
<img
|
|
alt="The workflows dashboard."
|
|
className="hidden dark:block"
|
|
src="/images/workflows/workflows-dashboard-dark.png"
|
|
/>
|
|
</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
|
|
alt="The configuration options for the codebase updates workflow."
|
|
className="block dark:hidden"
|
|
src="/images/workflows/workflow-settings-light.png"
|
|
/>
|
|
<img
|
|
alt="The configuration options for the codebase updates workflow."
|
|
className="hidden dark:block"
|
|
src="/images/workflows/workflow-settings-dark.png"
|
|
/>
|
|
</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 /> |