Dynamic View Filter

Dynamic view filters with auto-populated dropdown menus, build filter columns, and parameter-based run matching for Jenkins.

Imagine you have hundreds of Jenkins jobs organized in folders, different projects, platforms, and environments. Normally you'd scroll through all of them or create dozens of separate views manually.

This plugin lets you:

• Add dropdown menus at the top of any view that automatically populate with values extracted from your job names or build parameters. Select "production" from an environment dropdown and instantly see only production jobs.
• Show only relevant build results in columns. If you filter by a parameter (e.g., region=east), the Status, Last Success, and Last Failure columns update to reflect only matching builds — not just the latest build regardless.
• Works with all job types. The upstream BuildFilterColumn from View Job Filters can break with Pipeline (Jenkinsfile) jobs. This plugin handles Pipeline, FreeStyle, Matrix, and any other job type reliably.

In short, dynamic dropdowns that filter both your job list and the build data shown in columns, with no manual maintenance.

Filter bar at the top with horizontally arranged dropdowns, Reset button, and Filters toggle.

With a filter applied (Project = plugins), only matching jobs are shown:

Collapsed state, only the toggle icon remains:

Filter bar as a sidebar on the right with vertically stacked dropdowns.

With a filter applied (Project = jenkins), only matching jobs are shown:

Collapsed state, sidebar collapses to a compact icon strip:

Add dropdown definitions with Job Name Regex or Build Parameter source types.

Choose where the filter bar appears: top or sidebar.

Extract dropdown values from job folder paths using a regex capture group.

Populate dropdown values from actual build parameter values.

Configure Dynamic Build Filter Column and Parameter Build Filter Column.

Add Parameter Run Matcher Filter to the Job Filters section.

Wraps a standard column (Status, Weather, etc.) and filters build data through the view's job filters.

Self-contained column that filters builds by parameter name and value regex, with delegate column selection.

View-level job filter for matching builds by parameter name, value, and description regex.

The View Job Filters plugin provides BuildFilterColumn for filtering build data in list view columns. However, it relies on stored XStream back-references and runtime proxying that can break with Pipeline jobs and Job DSL configurations.

This plugin provides robust alternatives that:

• Resolve the parent view at render time from the Stapler request context (no stored back-references)
• Filter at the generic Job/Run API layer (works with any job type)
• Add parameter-based filtering at both the column and view level
• Provide a configurable Dropdown Filter View with auto-populated dropdown menus

A custom view type that extends ListView with configurable dropdown filters at the top. Dropdowns auto-populate their options from the jobs in the view.

Two source types:

Multiple dropdowns combine with AND logic. All standard ListView features (columns, job filters, regex include) are preserved.

Important: The Dropdown Filter View is a ListView — it only sees jobs that match the view's Include jobs by regex field. You must configure a regex pattern (e.g., .*) and enable Recurse in subfolders in the view configuration for the dropdowns to discover and filter jobs. The dropdown regex/parameter filters narrow down from this base set.

The filter bar can be positioned in two modes, configurable in the view settings:

• Collapsible: Click the Filters toggle to collapse or expand the filter bar. The state is persisted in localStorage — it remembers your preference across page loads.
• Auto-submit: Selecting a value in any dropdown immediately applies the filter (no submit button needed).
• Reset: Resets all dropdowns to "-- All --" and resubmits.
• Only actual jobs shown: Folder items are automatically excluded from the job table — only Job items (Pipeline, FreeStyle, Matrix, etc.) appear in the filtered results.

Here is an example with the PROJECT dropdown set to jenkins — only matching jobs are shown:

The Include jobs by regex field and the Job Name Regex dropdown source work together but serve different purposes:

The include regex must be broad enough to cover all jobs you want the dropdowns to filter. The dropdown regex then extracts specific segments as dropdown values.

A drop-in replacement for BuildFilterColumn. Wraps any standard column (Status, Weather, Last Success, Last Failure, etc.) and filters the build data through the view's RunMatcher job filters before the delegate renders.

A self-contained column that filters builds by parameter name and value regex. No separate view-level filter required — configure the parameter matching directly on the column itself.

A view-level job filter implementing RunMatcher. Add it once to a view's Job Filters section and every DynamicBuildFilterColumn in that view will filter builds through it.

Supports:

• Name regex, value regex, description regex
• Default value vs. actual build value matching
• Multi-build scanning with configurable limits
• In-progress build matching
• Include/exclude modes (4 combinations)

1. Create a new view and select Dropdown Filter View (or use a standard List View)
2. Add Dynamic Build Filter Column wrapping your desired columns (Status, Last Success, etc.)
3. Optionally add Parameter Run Matcher Filter to the Job Filters section
4. For Dropdown Filter View, add dropdowns with regex patterns or parameter names

Dynamic Build Filter Column — wraps a delegate column with view-level RunMatcher filtering:

<columns>
  <io.jenkins.plugins.dynamic_view_filter.DynamicBuildFilterColumn>
    <delegate class="hudson.views.StatusColumn"/>
  </io.jenkins.plugins.dynamic_view_filter.DynamicBuildFilterColumn>
</columns>

Parameter Build Filter Column — self-contained per-column parameter filtering:

<columns>
  <io.jenkins.plugins.dynamic_view_filter.ParameterBuildFilterColumn>
    <delegate class="hudson.views.LastSuccessColumn"/>
    <paramName>region</paramName>
    <paramValueRegex>east</paramValueRegex>
  </io.jenkins.plugins.dynamic_view_filter.ParameterBuildFilterColumn>
</columns>

Dropdown Filter View — view with auto-populated dropdown filters:

<io.jenkins.plugins.dynamic_view_filter.DropdownFilterView>
  <name>My Filtered View</name>
  <includeRegex>projects/.*/.*</includeRegex>
  <recurse>true</recurse>
  <filterPosition>top</filterPosition>
  <dropdowns>
    <io.jenkins.plugins.dynamic_view_filter.DropdownDefinition>
      <label>Project</label>
      <sourceType>jobNameRegex</sourceType>
      <jobNamePattern>projects/([^/]+)/.*</jobNamePattern>
      <parameterName/>
    </io.jenkins.plugins.dynamic_view_filter.DropdownDefinition>
    <io.jenkins.plugins.dynamic_view_filter.DropdownDefinition>
      <label>Environment</label>
      <sourceType>buildParameter</sourceType>
      <jobNamePattern/>
      <parameterName>env</parameterName>
    </io.jenkins.plugins.dynamic_view_filter.DropdownDefinition>
  </dropdowns>
</io.jenkins.plugins.dynamic_view_filter.DropdownFilterView>

DynamicBuildFilterColumn filters build data through all RunMatcher filters configured on the view — not just dropdown selections. If you have a Parameter Run Matcher Filter in the view's Filters section (e.g., LAB=remote), every build that doesn't match that filter will be excluded, and the columns will show N/A.

To diagnose:

1. Go to Edit View → Job Filters section
2. Check if any Parameter Run Matcher Filter is configured with restrictive criteria
3. If the jobs don't have matching parameter values, all builds get filtered out

To fix:

• Remove or adjust the Parameter Run Matcher Filter if it's too restrictive
• Or use Parameter Build Filter Column instead — it applies its own filter independently without requiring a view-level filter

Tip: DynamicBuildFilterColumn + Parameter Run Matcher Filter is a global approach (affects all wrapped columns). Parameter Build Filter Column is a per-column approach (each column filters independently). Choose based on whether you want uniform or independent filtering.

• Jenkins 2.528.3 or newer
• View Job Filters plugin

See docs/USAGE_SCENARIOS.md for detailed walkthroughs covering common setups like multi-environment dashboards, dropdown-driven project views, Pipeline job filtering, and more.

See GitHub Releases for the changelog.

Refer to CONTRIBUTING.md for development setup, build commands, and pull request guidelines. For build details, see docs/BUILD.md.

Licensed under the MIT License.