Feature Request: Custom Workflow/Pipeline Labels in the Web UI

Feature Request: Custom Workflow/Pipeline Labels in the Web UI

When running pipelines tailored to specific domains, environments, or regional targets within a single repository, identifying the specific context of a run requires digging into workflow details or individual job logs. While our immediate use case involves distinguishing pipelines by jurisdiction (e.g., region/country), this applies broadly to any pipeline metadata.

Proposed Solution

Introduce a native label (or tags) parameter in the .circleci/config.yml at the workflow level. This label should be rendered prominently in the main Pipelines UI view and provide filtering capability in the dashboard.
While region/country is a primary example, workflow labels could be used for any custom categorisation, such as:

  • Target Jurisdiction / Region: US, EU, APAC

  • Environment: staging, production, sandbox

  • Test Scope: e2e, smoke, performance

  • Component / Microservice: auth, billing, notifications

Example Configuration (.circleci/config.yml):

workflows:
  run-system-tests:
    label: US # Proposed key-value or simple string tag
    jobs:
      - run-tests

UI Mockup / Expected Behavior

  1. Pipeline List View: Display a badge next to the commit/pipeline details showing the defined label (e.g., US).

  2. Filtering: Allow users to filter the Pipelines view by label or tag values to quickly locate regional test runs or specific deployment targets.

Screenshot 2026-09-21 at 10.08.40