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

Bug Reports
1

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

2

Hi @doughlass — thanks for the detailed write-up and mockup, really helpful context!

I’ve created a feature request on your behalf in our Ideas portal. Feel free to add a vote and comment there — it’s the best way for others to show support and for us to track demand. If it gains enough traction, it’ll move up in prioritization, and you’ll be automatically notified when it ships.