Skip to content

Settings

Spotlight’s configuration lives on the Settings page - open Apps → Spotlight and pick Settings in the left-hand navigation. The page is Jira-admin only: non-admins opening it see a notice saying so (the current configuration is not shown to them).

The Settings page is a group × capability matrix: one row per Jira group, one checkbox column per capability.

Capability What it controls
Publish Who may save a spotlight with “Shared with the team” visibility (and edit their shared spotlights).
View Who sees the Team spotlights section of the gallery.

How the matrix behaves:

  • Empty means everyone. A capability with no groups checked is open to the whole site - this is the default. Checking one or more groups restricts that capability to their members.
  • Jira admins always retain both capabilities, regardless of the matrix - so a configuration mistake can never lock admins out.
  • Use the search field to filter large group lists; up to 50 groups can be checked per capability.
  • Click Save permissions to apply. Changes take effect on the next gallery load.

A common setup: leave View open to everyone, restrict Publish to a jira-reporting or team-leads group - everyone benefits from the gallery, a small group curates it.

AI drafting is included with the app, with monthly fair-use caps: 150 drafts per user plus a shared site budget of 1,000 AI calls (a draft normally uses one call, occasionally two when Spotlight automatically retries). When a cap is hit, Spotlight says which one; templates and the manual builder are never limited. Details in Draft with AI.

Spotlight persists to Forge storage (KVS) inside your Atlassian tenant:

Data Contents
Your private spotlights Definition (settings/JQL/plan), title, your description, dates
Shared spotlights The same, plus the author’s account ID
Permission settings The group lists for Publish and View
AI usage counters Monthly draft counts (site and per-user) for fair use

Issue data is never stored - every render fetches live from Jira. Nothing is sent to external services. See security for details.

Sensible roadmap items that aren’t in the current build:

  • Changing a spotlight’s visibility in place (today: delete and recreate)
  • Per-group or adjustable AI quotas
  • Custom fields as chart groupings (today: the seven built-in groupings)
  • Site-wide default visibility

If any of these block you, tell us at support@bytera.tech.