mintlify__docs/workflows/enable.mdx

---
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://app.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="settings" /> 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://app.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.

## Improve docs from assistant chats

The **Improve docs from assistant chats** workflow reviews recent trends in [assistant](/assistant/index) questions and opens targeted documentation updates that address gaps your users hit.

Use this workflow when you want the agent to triage assistant activity for you and propose changes that answer the questions users actually ask.

This workflow runs on a schedule. It does not require trigger repositories or extra context configuration. Enable it from the [Workflows](https://app.mintlify.com/products/workflows?tab=workflows) page and pick whether updates merge automatically or open a pull request for review.

## Improve docs from feedback

The **Improve docs from feedback** workflow reviews recent [page feedback](/optimize/feedback) and opens targeted documentation updates based on the issues users report.

Use this workflow when you collect thumbs ratings or contextual feedback and want the agent to convert that signal into concrete docs changes.

When a run completes, the run detail in your dashboard includes the specific feedback citations the agent used. Each citation links to the feedback in your [analytics dashboard](https://app.mintlify.com/products/analytics/v2/feedback) so you can verify the context that drove the update.

This workflow runs on a schedule and requires that feedback collection is enabled on the [Add-ons](https://app.mintlify.com/products/addons) page. It does not require trigger repositories or extra context configuration.

<GitlabWorkflowSetup />