Filters
Filters are the foundation of Beautiful Assets. Every display macro on a page gets its data from a filter.
A filter macro queries Jira Assets using AQL (Assets Query Language) and makes the results available to other macros. You can have multiple filters on a single page, and they can even reference each other.
Basic vs Advanced Mode
Filters support two configuration modes:
Basic Mode
Build your query visually by selecting a schema, object type, and adding rules. No AQL knowledge required. This is the default mode for new filters.
Advanced Mode
Write raw AQL queries directly. This gives you full control over the query, including the ability to reference other filters using {Filter Name} syntax.
Learn more about Advanced Mode
Object Selection
When a filter returns multiple objects, you can enable an object selection dropdown. This lets page viewers browse through results, and all connected macros update automatically.
Learn more about Object Selection
Key Concepts
- Each filter has a unique name on the page
- Filters run their queries live on every page load, so data is always current
- Display macros select which filter to use and which attribute to show
- Multiple macros can share the same filter
- Filters can reference each other for cascading data (see Advanced Mode )