Care gap rules
Turn screening, vaccine and chronic-care checks on or off, edit who they apply to and what meets them, and add your own.
Care gap rules decide which screenings and checks each patient is due for. The gaps show on the patient’s chart and in care gap lists. Your practice starts with a set of starter rules based on public guidelines (USPSTF, CDC, ADA). Have a clinician review them before relying on them.
What’s included
Rules are grouped by kind: Cancer screening, Screening, Diabetes care, Vaccines, Hormone therapy and Other. Starter rules include:
- Cancer screening: colorectal, breast (mammogram), cervical (21–29 and 30–65), lung (low-dose CT).
- Screening: bone density, abdominal aortic aneurysm ultrasound, prediabetes and diabetes, cholesterol, hepatitis C, HIV, depression.
- Diabetes care: A1c, diabetic eye exam, diabetic foot exam, urine albumin (ACR), kidney function (eGFR), LDL cholesterol.
- Vaccines: flu (this season), Td/Tdap booster, shingles (2 doses), pneumococcal, RSV, hepatitis B series, COVID-19 (this season).
- Hormone therapy: hematocrit, testosterone level and PSA for patients on testosterone.
Most starter rules are on. The COVID-19 vaccine rule and the three testosterone rules start off; turn them on if they fit your practice.
How to turn a rule on or off
- Go to Practice admin › Clinical and open the Care gaps tab (titled Care gap rules).
- Use the switch beside the rule. You’ll see, for example, “Colorectal cancer screening switched off.”
Rules are never deleted. Switch off the ones you don’t use.
How to edit a rule
- Select Edit on the rule.
- Change Name or Kind if needed.
- Under Who it applies to:
- From age and To age (blank for no limit).
- Sex at birth: Any, Female or Male.
- Minimum BMI, if the check depends on weight.
- Only with these problem-list codes (ICD-10, any match; blank = everyone), for example E11 for diabetes rules.
- Not with these problem-list codes, to leave out patients the check doesn’t fit (for example, after a hysterectomy).
- Under What meets it (any one), each option is one way to satisfy the rule:
- Choose its kind: Screening, Lab test, Vaccine, Vaccine group or Form completed.
- Add an item to option 1 (for example Colonoscopy, or a specific lab test).
- Every (months): how often it’s needed. Leave it blank for once.
- Doses, for vaccines that need more than one.
- Tick Needs all of these (not any one) when an option has several items that are all required.
- Tick Once per season (from August 1) for seasonal vaccines.
- Select Another way to meet it to add an option. For example, colorectal screening is met by a colonoscopy every 10 years, or a FIT every year, and so on.
- Optionally add a Note shown on the gap (optional) (up to 200 characters).
- Keep On for this practice ticked, then select Save rule.
How to add your own rule
Select Add rule and fill in the same fields. Your own rules show a Custom badge.
How to undo your changes to a starter rule
Open the rule’s menu (More for the rule) and choose Reset to starter values. Custom rules don’t have this option.
Good to know
- Rules are practice-wide: a change applies to every patient the rule covers, and a rule that’s switched off no longer shows gaps.
- A completed form can count as meeting a rule (for example, a depression screening questionnaire).
- Staff with Provider, Clinical staff or Front desk roles see care gaps. Only Owners and Practice admins can change the rules.
Troubleshooting
| What you see | What it means | What to do |
|---|---|---|
| Each way to meet the rule needs at least one item. | An option under What meets it has no items. | Add an item, or remove that option. |
| Check the rule and try again. | A value is missing or out of range. | Check the name (2–80 characters), ages and months. |
| Care gap rules couldn’t be loaded. | The page couldn’t load. | Refresh the page. |
Related
Still stuck? Contact support and we’ll help. Please don’t include patient information.
Checked against the app on November 14, 2026