As the number of open pull requests on your Pipeline grows, it can become harder to find the ones that need your attention. The filter menu on each Pipeline environment lets you narrow down your list of open PRs so you can focus on what matters most.
Using the filter menu
To filter pull requests on a Pipeline environment, click the Filter button at the top of your open pull requests list.
This will open a dropdown with several filter categories you can use to refine which pull requests are shown.
Status
Filter by the current state of each pull request:
Failed checks shows pull requests that have failed their merge conflict check or validation against the target org. These are the PRs that need your attention before they can be promoted.
Pending checks shows pull requests that are still waiting for their checks to complete. This includes PRs where merge conflict detection or validation is still running.
Ready to promote shows pull requests where all checks have passed and the PR is good to go. These are the ones you can promote straight away.
Age
Recently opened
If you want to focus on the newest pull requests, you can filter by how recently they were opened against the environment:
Last 7 days
Last 14 days
Stale
On the flip side, if you want to find pull requests that have been sitting around for a while, you can filter for stale PRs:
More than 7 days old
More than 14 days old
More than 30 days old
This is really useful for keeping your Pipeline tidy and making sure nothing gets forgotten about. If a PR has been open for weeks, it might be worth checking in with the person who created it.
Promotion type
You can also filter by the type of promotion:
Forward promotions shows standard pull requests that are moving changes forward through your Pipeline towards Production.
Back promotions shows back propagation pull requests, which sync changes back to earlier environments in your Pipeline. If you find that back propagation PRs are cluttering your view, this filter lets you either isolate them or filter them out.
Show validations
With this option selected, both validations and promotions will appear in the queue. Without it, only promotions will be shown.
Story filters
Various filters that allow the list of PRs to be restricted to those that match the criteria selected. There are several layers in this menu.
If the pipeline has multiple ticket systems configured then the first choice is to select the ticket system.
Next is choosing the category:
Project - Applies to all ticket systems except Salesforce custom objects. This also restricts the options that appear in the other categories. For example, selecting project 'ABC' would mean that ticket status and release versions will only appear if they were part of that project.
Release version - Only used for Jira tickets. This maps to the 'fix version' assigned in Jira.
Ticket status - Applies to all ticket systems.
Combining filters
You can select multiple filters at once to narrow your results further. For example, you could filter for pull requests that have Failed checks and are More than 14 days old to find long-standing issues that need resolving.
When you select a filter, it is applied immediately to the list of pull requests shown on the environment. You can clear your filters at any time by reopening the Filter dropdown and deselecting your choices.
Search
Alongside the filter menu, there is also a search bar that lets you search for a specific pull request by name or number. You can use search and filters together to quickly track down exactly the PR you are looking for.