Site admin settings
Foundation’s admin settings page is where site admins configure the app for everyone on the Jira site. Regular users never see it — only accounts with Jira Administer Jira permission can open the page.
Use it to tune styling, manage announcements, reset onboarding, and check how the app is running.
Open admin settings
Section titled “Open admin settings”- In Jira, go to Apps > Manage your apps > Foundation.
- Click Configure, or open the Foundation admin page directly from the Jira left navigation if it’s pinned for you.
- If you don’t see the page, you’re probably not a site admin — ask an admin to check your Jira group membership.
What’s on the page
Section titled “What’s on the page”Usage stats
Section titled “Usage stats”A summary panel shows:
- Number of lenses across the site.
- Number of unique lens owners.
- Cached issue count.
- API points used against the Jira rate limit in the last hour.
- Last successful event-handler run.
Use these as a health sanity check before escalating to support.
CSS overrides
Section titled “CSS overrides”Foundation uses Atlassian Design System tokens so it inherits your site theme. If your team has custom branding that goes further, the CSS overrides editor lets you tweak design-token values — for example, the primary accent colour or focus ring colour — without patching Foundation’s source. Changes apply to every user on the next page load.
Announcement management
Section titled “Announcement management”Admins can preview upcoming announcement popups before they go live, and force-clear a user’s dismissed list if someone needs to re-see a notice. See Announcements for the user-facing behavior.
Onboarding reset
Section titled “Onboarding reset”Click Reset tour to re-enable the first-run welcome and five-step tour for a specific user, or for everyone on the site. Useful after a major release when you want staff to rediscover new sections.
Cache controls
Section titled “Cache controls”Quick buttons for:
- Refresh all caches — re-pulls every cached issue from Jira.
- Purge cache — clears the entire local issue cache.
See Cache & refresh for when to use each.
- Changes to CSS overrides and onboarding settings are live immediately; users may need to refresh to pick them up.
- The admin page does not accept edits to individual lenses. Use Foundation Home for that — admins own nothing by default, they just have global configuration access.
- If the page fails to load, check that you have Administer Jira permission on this site (Jira Settings > User management).