Scheduled pipelines

Use scheduled pipelines to run GitLab CI/CD pipelines at regular intervals.

Prerequisites

For a scheduled pipeline to run:

  • The schedule owner must have the Developer role. For pipelines on protected branches, the schedule owner must be allowed to merge to the branch.
  • The CI/CD configuration must be valid.

Otherwise, the pipeline is not created. No error message is displayed.

Add a pipeline schedule

Scheduled pipelines for tags

To add a pipeline schedule:

  1. On the top bar, select Menu > Projects and find your project.
  2. On the left sidebar, select CI/CD > Schedules.
  3. Select New schedule and fill in the form.

Edit a pipeline schedule

Introduced in GitLab 14.8, only a pipeline schedule owner can edit the schedule.

The owner of a pipeline schedule can edit it:

  1. On the top bar, select Menu > Projects and find your project.
  2. In the left sidebar, select CI/CD > Schedules.
  3. Next to the schedule, select Edit () and fill in the form.

The user must have the Developer role or above for the project. If the user is not the owner of the schedule, they must first take ownership of the schedule.

Run manually

To trigger a pipeline schedule manually, so that it runs immediately instead of the next scheduled time:

  1. On the top bar, select Menu > Projects and find your project.
  2. On the left sidebar, select CI/CD > Schedules.
  3. On the right of the list, for the pipeline you want to run, select Play ().

You can manually run scheduled pipelines once per minute.

Take ownership

Scheduled pipelines execute with the permissions of the user who owns the schedule. The pipeline has access to the same resources as the pipeline owner, including protected environments and the CI/CD job token.

To take ownership of a pipeline created by a different user:

  1. On the top bar, select Menu > Projects and find your project.
  2. On the left sidebar, select CI/CD > Schedules.
  3. On the right of the list, for the pipeline you want to become owner of, select Take ownership.