Prioritization Rules: How to customize inbox priorities

The Priority inbox uses pre-built logic to evaluate the priority of items related to you. The default logic we provide may not always fit your development workflow or you might want to track/untrack specific items based on a number of conditions to improve the overall accuracy of your inbox.

Well, we've got you covered with Prioritization Rules.

Prioritization rules are matching filters allowing you to override the default priority classification provided by Keypup. They can be used to improve the overall accuracy of priorities in your inbox as well as to create reminders on items that must be actioned.

Creating prioritization rules

To get started with prioritization rules head to  Settings > Prioritization Rules.

prioritization rules
Example of prioritization rules

Add a prioritization rule by clicking on New rule

new prioritization rule

When creating a rule the following details should be specified:

  • Name: just a way to keep your rules organized
  • Precedence: items match rules on a first-match basis. You should put more restrictive rules at the top and less restrictive rules at the bottom.
  • Hint: a short sentence that will appear on items to remind you why they have been assigned this priority.
  • Priority: the priority to assign to items matching this rule.
  • Matching rules: a series of AND/OR conditions on fields used to match pull requests and issues.

Hit Save and your prioritization rule will be applied immediately. You can head to Reports > Priority Inbox to see the results of your rule.

Prioritization rules you create are only applied to your own account - so there is no risk to impact team members when you start playing with rules.

#roadmap we do not support company-wide rules at this stage. This feature is however on our roadmap.

Always consider exit conditions

Remember that items matching your rules will stay in your inbox until their attributes change and do not match the rule anymore.

Therefore you should always think about practical "exit conditions" for each rule, otherwise you'll end up with many non-actionable items filling your inbox.

An exit condition means "How will items disappear from my priority inbox?".  Exit conditions can typically be based on:

  • State: my item should appear in my inbox until it's merged/closed.
  • Time range: my item should appear in my inbox only if it was created/updated/merged within the last 24 hours.

E.g. Tracking untriaged items

Let's say you want to prioritize issues with label triage-required to ensure you check each of them and assign labels/assignees.

A basic filter would look like: if label includes triage-required then assign priority IMPORTANT

This might work alright for you depending on the number of issues you have to triage. But if you have a high number of issues you might prefer to only prioritize new untriaged items for one day. This would allow you to get a heads up every day on new items, address the important ones and leave the non-addressed ones for the next monthly review.

Your filter might become something like: if label includes triage-required AND created_at > 24 hours ago AND created_at < 0 hours ago then assign priority IMPORTANT

The filter above would give you a nice reminder on new untriaged items without filling up your inbox growingly if you don't take the time to triage items.


The Prioritization Rules feature will immensely help you shaping your Priority inbox to match with the way you work. You will definitely get satisfying results !

Tell us what you think about this feature and we're happy to hear what you want to see on Keypup !

Don't have a Keypup account yet ? Try Keypup now

Don't miss these stories: