Sync GitHub Labels

April 12, 2026 · View on GitHub

Sync GitHub labels from a configuration file. Creates, updates, or deletes labels to match the config, ensuring consistent labeling across repositories.

Inputs

NameDescriptionRequiredDefault
config-fileURL or path to the labels config filedevantler-tech labels
delete-other-labelsWhether to delete labels not in the configtrue

Usage

Default config

steps:
  - name: Sync labels
    uses: devantler-tech/actions/sync-github-labels@main

Custom config

steps:
  - name: Sync labels
    uses: devantler-tech/actions/sync-github-labels@main
    with:
      config-file: "https://raw.githubusercontent.com/my-org/configs/main/labels.yaml"

Preserve existing labels

steps:
  - name: Sync labels
    uses: devantler-tech/actions/sync-github-labels@main
    with:
      delete-other-labels: "false"