Study guide
9.3 Filter Permissions, Shared Filters & Filter Subscriptions
Atlassian Certified Professional - Jira Administration for Cloud ACP-120
Track your progress as you read
Finished sections get a check mark.
1 Chapter 1: Exam Overview, Blueprint & Jira Cloud Fundamentals
1.1 ACP-120 Exam Structure, Blueprint & Testing Strategy 1.2 Jira Cloud Architecture, Products & Admin Hierarchy
2 Chapter 2: Organizations, Managed Accounts & Global Access
2.1 Atlassian Organizations, Domain Verification & Managed Accounts 2.2 Atlassian Guard, SAML SSO, SCIM & Authentication Policies 2.3 Site Access, Product Access Tiers & Global Permissions 2.4 User Directory Architecture: Groups vs. Project Roles
3 Chapter 3: Project Permissions & Issue-Level Security Schemes
3.1 Permission Scheme Mechanics & Critical Project Permissions 3.2 Permission Troubleshooting, Additive Permissions & Permission Helper 3.3 Issue Security Schemes, Security Levels & Access Containment
4 Chapter 4: Project Configuration, Types, Versions & Boards
4.1 Company-Managed vs. Team-Managed Project Architecture 4.2 Project Templates, Project Keys & Project Categories 4.3 Project Components, Component Leads & Default Assignees 4.4 Versions, Fix Versions, Release Lifecycles & Project Archiving 4.5 Scrum and Kanban Board Configuration, Board Filters & Columns
5 Chapter 5: Issue Types, Custom Fields, Screens & Schemes
5.1 Standard vs. Sub-task Issue Types & Issue Type Schemes 5.2 Custom Field Types, Global vs. Project Contexts & Options 5.3 Field Configurations, Renderers, Hiding & Required Fields 5.4 Screens, Screen Schemes & Issue Type Screen Schemes
6 Chapter 6: Workflows — Company-Managed and Team-Managed
6.1 Statuses, Status Categories, Direct & All-to-One Global Transitions 6.2 Transition Rules: Conditions vs. Validators 6.3 Post Functions, Execution Order & Resolution Management 6.4 Workflow Schemes, Editing Active Workflows & Status Migration 6.5 Team-Managed Workflows, Statuses & Workflow Rules
7 Chapter 7: Jira Cloud Automation
7.1 Automation Engine, Rule Architecture & Event Triggers 7.2 Automation Conditions, Smart Values & String/Date Expressions 7.3 Branch Rules, Related Issues, Sub-tasks & Parent Epics 7.4 Rule Scopes, Automation Usage, Audit Logs & Error Handling
8 Chapter 8: Notifications, Events, Personal Settings & Mail Handlers
8.1 Jira Events, System Events & Notification Schemes 8.2 Notification Recipients, Custom User Fields & Deduplication 8.3 Team-Managed Notifications, Personal Settings & Troubleshooting Missing Email 8.4 Mail Handlers: Creating Issues and Comments from Email
9 Chapter 9: JQL, Filters, Dashboards & Bulk Operations
9.1 JQL Fundamentals, Clauses, Operators & History (WAS / CHANGED) 9.2 Advanced JQL Functions & Dynamic Date Searches 9.3 Filter Permissions, Shared Filters & Filter Subscriptions 9.4 Dashboard Layouts, the Default Dashboard, Sharing & Essential Gadgets 9.5 Bulk Operations: Edit, Move, Transition, Delete & Watch
10 Chapter 10: System Administration
10.1 Global UI Features: User Defaults, Look and Feel, Announcement Banner & Default Dashboard 10.2 Statuses, Resolutions, Priorities & Sub-tasks: Global Configuration 10.3 Global Settings: Time Tracking, Issue Linking, Attachments & Application Links 10.4 System Backup, Restore & Data Import
9.3 Filter Permissions, Shared Filters & Filter Subscriptions
Key Takeaways Explain This Topic AI
Filters can be shared as private, with users, groups, projects or project roles, with everyone logged in (My organization), or publicly if a Jira admin has enabled public sharing.
Sharing a filter or dashboard requires the 'Share dashboards and filters' global permission; viewers don't need it, and each viewer only sees issues they're allowed to browse.
Group subscriptions need 'Manage group filter subscriptions', can only target a group the subscriber belongs to, and evaluate results (including currentUser()) for each recipient.
A board or gadget built on a private filter fails for everyone but the owner, so share the underlying filter.
Jira admins reassign or delete shared filters in Settings > System > Filters; changing the owner keeps the filter ID, so boards and gadgets keep working.
Last updated: September 2026
9.3 Filter Permissions, Shared Filters & Filter Subscriptions
Quick Summary: In Jira Cloud, a saved filter is a reusable JQL query stored in the database with a unique numeric ID. Saved filters represent the architectural foundation for agile boards, dashboard gadgets, cross-project reports, and automation rules. If a filter's permissions are misconfigured, downstream dashboards break with "Filter Not Found" errors. Jira Administrators must master filter visibility scopes, the global permissions governing who can share objects, the security mechanics of personal vs. group email subscriptions, and the administrative lifecycle for transferring filter ownership when staff depart.
Saved Filters Architecture & Dependencies
When a user executes a search in Filters > Advanced issue search , the search results are transient. Clicking Save filter (or Save as ) prompts the user for a Filter Name and optional description, persisting the query as a global entity with a unique ID (e.g., filter=10450 ). +--------------------------------------------------------------------------+
- | SAVED FILTER DEPENDENCY GRAPH |
- +--------------------------------------------------------------------------+
- | |
- | +-----------------------+ |
- | | SAVED JQL FILTER | |
- | | (Filter ID) | |
- | +-----------------------+ |
- | | | | |
- | +-------------+ | +-------------+ |
- | v v v |
- | +-----------------+ +-----------------+ +-----------------+ |
- | | Agile Boards | | Dashboard Gadget| | Email Scheduled | |
- | | (Scrum/Kanban) | | (Pie, Filter) | | Subscription | |
- | +-----------------+ +-----------------+ +-----------------+ |
- | |
- +--------------------------------------------------------------------------+
- The Relationship Between Filters and Downstream Assets
Agile Boards: Every Scrum and Kanban board in Jira Software is powered by an underlying board filter. If the creator of the filter restricts its visibility, team members lose access to the entire board.
Dashboard Gadgets: Gadgets such as Filter Results , Pie Chart , and Two-Dimensional Filter Statistics reference a saved filter ID rather than embedded JQL.
Email Subscriptions: Scheduled email alerts evaluate the filter's JQL on a cron cadence and dispatch matching issues to subscribers.
Editing JQL vs. Filter Definition: If a user modifies the JQL text of a saved filter in the search interface, Jira displays the filter name with an asterisk ( *FilterName ). The changes do not take effect on downstream boards or dashboards until the user explicitly clicks Save .
Filter Sharing Scopes & Permissions
Filter owners (and editors) set Viewers and Editors in the filter's details. Atlassian lists these sharing targets:
- Share With Who Can See the Filter
- Private Only the owner
- User A specific person
- Group Members of a Jira group
Project (optionally narrowed to a project role ) Members of one or more projects, or only those in a given role
My organization / Open Anyone logged in to the Jira site
Public Anyone on the internet, including people who aren't logged in. Only available if a Jira admin has turned on Public sharing (Settings > System > General configuration). Free sites can't share publicly
A filter can have several sharing entries at once (for example, a project role and two groups). Owners can also grant edit access to users, groups, or projects so others can maintain the JQL.
Sharing a filter never shares issues. Each viewer only sees the issues their own permissions allow. Two people opening the same shared filter can get different results.
Default access for new filters comes from the admin's user default settings (Private or Public). Changing that default doesn't share any existing filter.
Prerequisites for Sharing: Global Permissions
Global Permission Required For
Share dashboards and filters Sharing a filter or dashboard with anyone beyond yourself. Without it, users can only keep private filters and dashboards
Manage group filter subscriptions Creating (and deleting) filter subscriptions that email a group
The person sharing needs Share dashboards and filters . The people viewing a shared filter don't.
Filter Subscriptions: Personal vs. Group
A Filter Subscription is an automated service in Jira that executes a saved filter on a scheduled basis and emails the resulting issue list as an HTML or text digest to subscribers. +--------------------------------------------------------------------------+
- | PERSONAL VS. GROUP FILTER SUBSCRIPTIONS |
- +--------------------------------------------------------------------------+
- | Parameter | Personal Subscription | Group Subscription |
- | -------------------- | ------------------------- | ---------------------- |
- | Target Audience | The individual user | An entire Jira Group |
- | Required Permission | View permission on filter | 'Manage group filter |
- | | | subscriptions' global |
- | Execution Context | Subscriber's permissions | Individual recipient's |
- | | | permissions respected |
- | Email Suppression | Optional (can email 0) | Optional (can email 0) |
- | Scheduling Engine | Daily, Weekly, Cron | Daily, Weekly, Cron |
- +--------------------------------------------------------------------------+
- 1. Personal Subscriptions
Any user who has permission to view a saved filter can create a personal subscription for themselves ( Filter details > Subscriptions > Add subscription ):
Schedule Options: Daily (at a chosen time), Days per week, Days per month, or Advanced Cron expressions.
Zero-Issue Notifications: Users can check the box "Email this filter, even if there are no issues found" . This is a powerful administrative auditing tool. For an escalation filter ( priority = Blocker AND status = Open ), an engineer leaves this unchecked so they are only alerted when blockers arise. For a compliance filter ( resolution is EMPTY AND duedate < now() ), a manager might leave it checked to receive daily confirmation that zero tickets are overdue.
2. Group Subscriptions
Group subscriptions email a filter's results to every member of a Jira group:
Mandatory privilege: the person creating it needs the Manage group filter subscriptions global permission.
Group membership: you can only choose a group you are a member of as the recipient.
Results are specific to each recipient. Jira runs the filter for every member separately, respecting their project permissions and issue security. A member who can't browse Project X gets an email without Project X's issues.
currentUser() is evaluated as the recipient. A filter like assignee = currentUser() AND resolution is EMPTY sent to a group gives each person their own open work. (This doesn't apply when the "recipient" is a distribution-list email address rather than a Jira group.)
Troubleshooting Filter Subscriptions
Symptom Likely Cause
A group member gets an empty or partial email They lack Browse Projects or issue security access for some results
Someone can't pick the group as recipient They aren't a member of that group, or lack Manage group filter subscriptions
No email arrives when nothing matches Email this filter, even if there are no issues found is unchecked (working as designed)
Emails arrive as plain text The user's email format (or the site default) is text rather than HTML
Every recipient gets the same list despite currentUser() The subscription targets a distribution-list address, not a Jira group
Filter Governance & Managing Orphaned Filters
A major operational challenge in enterprise Jira administration occurs when an employee departs the company. When their Atlassian account is deactivated:
The saved filters they owned remain in the system.
If the filter was shared, other users can still view it, but no non-admin user can edit the JQL or update filter sharing .
If a team lead needs to modify a board filter owned by a departed user, they cannot do so without administrative intervention.
Administrative Transfer of Ownership
Jira admins can manage and reassign shared filters in Settings > System > Filters :
Search Shared Filters: Administrators can search by filter name or filter owner (including inactive accounts).
Change Owner: Clicking the action menu ( ... ) next to any filter allows the administrator to select Change owner and transfer ownership to an active project lead or manager.
Delete Filter: Deleting a filter breaks any board or dashboard gadget that uses it, so check with the owner and consumers first.