Tutorial5 min read

How to Use Smart Collections to Automate Test Cycles

Build test suites from rules, requirements and hand-picked test cases that stay current as your Space evolves

Balázs Szakál

Balázs Szakál

Founder & QA Lead at BesTest

Updated October 14, 2026

What Are Smart Collections?

A Smart Collection (a Collection in BesTest) is a reusable set of test cases for building test cycles. It can combine three sources:

  • •
    Rules - a filter on test cases (folder, priority, type, status, custom fields...). New test cases that match are picked up automatically.
  • •
    Requirements - pick requirements, and their linked test cases come along.
  • •
    Test Cases - a hand-picked, fixed set.

Rules and requirements are resolved every time you add the collection to a cycle, so the collection stays current without maintenance. You need BesTest enabled on your Space and a few test cases (see the getting started guide).

Creating Your First Smart Collection

Let's build a regression suite.

  1. 1
    Open BesTest in your Space and go to Collections
  2. 2
    Click "New Collection" and name it "Regression Suite"
  3. 3
    Open the Rules tab and add a Folder Rule: pick your "Regression" folder (tick Include subfolders)
  4. 4
    Add a Field Condition: Priority is High or Critical
  5. 5
    Check Matching Test Cases under the rule - that is what the collection will add today
  6. 6
    Click "Save Test Collection"
Smart Collections in BesTest with rule-based test case grouping
Smart Collections in BesTest with rule-based test case grouping (click to enlarge)

Conditions can be grouped with AND / OR. The same rule can be written in the Visual, Basic or BQL editor - switch to BQL when you want full control.

Rule Examples in BQL

BQL uses camelCase field names and double quotes. A few rules that work as they are:

GoalBQL rule
High-priority, approved testspriority IN ("HIGH", "CRITICAL") AND status = "ACTIVE"
Smoke suite, sorted by nametype = "SMOKE" ORDER BY name
Manual tests onlyautomationStatus = "MANUAL"

Custom fields work too: type the field's key and pick the value from the suggestions. For folders, use the Folder Rule in the Visual editor - BQL stores the folder by its ID. ORDER BY at the end sets the order of the matching test cases (custom fields included). More examples: Filters.

Requirements instead of rules

On the Requirements tab, select requirements (for example everything in your "Billing" folder) and click "Add Selected". When the collection is used, the test cases currently linked to those requirements are added - so the suite grows as the team links new tests.

Using a Collection in a Test Cycle

  1. 1
    Go to Test Cycles and click "New Test Cycle"
  2. 2
    Fill in the General tab
  3. 3
    On the Collections tab, select one or more collections and add them
  4. 4
    Check the Planning tab: test cases are grouped by source, and testers can be assigned (a collection's default assignee from its own Planning tab is filled in)
  5. 5
    Click "Save Test Cycle"

The cycle takes a snapshot when it is created: test cases that match the collection later appear in the next cycle, not this one. A test case that comes from more than one source is added only once (directly added first, then via requirements, then via collections).

Tips and Troubleshooting

  • •
    Empty collection? Look at Matching Test Cases while editing the rule, and remove conditions one by one until results appear. In BQL, check the values against a test case (for example "HIGH", not "High").
  • •
    Too large? Add a narrowing condition (priority, type) or split it by folder into several collections and run them in rotation.
  • •
    One-off cycle? Skip the collection and add test cases directly in the cycle. If you will need the same kind of selection next sprint, make it a collection.
  • •
    Group with fields, not names. Rules work best on folders, priority, type and your own custom fields (for example a Component select field).

Next step: create a cycle from your new collection with the test cycle tutorial.

Frequently Asked Questions

Do Smart Collections update automatically when I add new test cases?

Yes, for rules and requirements. A new test case that matches the rule, or gets linked to one of the collection's requirements, is included the next time the collection is added to a cycle. Hand-picked test cases stay a fixed set.

If I add a collection to a cycle, does the cycle update when the collection changes?

No. A cycle takes a snapshot of the collection's test cases when you add it. Later matches show up in the next cycle you build from the collection.

Can I combine multiple collections in one test cycle?

Yes. Add as many collections as you need on the cycle's Collections tab. A test case that comes from several sources is added only once.

Can a collection select test cases by requirement?

Yes. Add the requirements on the collection's Requirements tab. Every time the collection is added to a cycle, the test cases currently linked to those requirements are included (archived requirements are skipped).

Tags:smart collectionstest cyclesautomationbestesttutorialtest suitesregression testing

Automate Your Test Cycles

Install BesTest and create your first Smart Collection in minutes. Free for up to 10 users.

Install BesTest Free
Getting started

Live in about a minute.

  1. ~30 seconds
    1.Install from the Marketplace

    One click on "Get it now" - no sales call, no signup form, no separate login.

  2. ~1 minute
    2.Enable it on a Space

    Flip it on in Space settings. BesTest shows up in the Space menu, where your team already works.

  3. right away
    3.Run your first test

    Create a requirement, link a test case, hit run. No training course required.

Host your data in the EU, US, or IndiaNo Jira issue bloat - your library stays out of Jira’s wayBuilt on Atlassian Forge