Skip to main content

Filtering pull requests in your Pipeline

How to use the filter menu to quickly find the pull requests you care about on your Pipeline environment.

Written by Sam Wilson
Updated this week

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.

Screenshot: Filter menu open on the Pipeline environment

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.

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.

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.

Did this answer your question?