Support links
The no-license screen shows a list of support links - where users go when they hit Synaps without an active subscription. If the defaults do not match your organisation, you can edit them yourself.
For Jira admins only. Other users cannot see the admin page. Both the page and its save endpoint check admin permissions.
01. How to get there
In Jira:
Apps -> Manage your apps -> Synaps -> Settings
By default Synaps ships with three links: "Contact your instance admin", "Installation documentation", and "Open a support ticket". You can keep them, replace them, or extend them.
02. What you can change
For each link you set:
- Label - what the user sees on the no-license screen. Required, up to 60 characters.
- URL - where the link goes. Must start with
https://,http://, ormailto:. Other schemes (javascript:,ftp:, etc.) are refused. - Icon - a small icon shown next to the label. Pick from: email, docs, support, admin, slack, teams, chat, phone, external.
You can have up to 6 links at a time.
[ADD SCREENSHOT/IMAGE: Synaps admin form with one link row expanded — Label text field with a value typed in, URL field below it, and an icon picker dropdown open showing the nine icon choices (email, docs, support, admin, slack, teams, chat, phone, external) in a small grid.]
03. Saving and resetting
- Add link - adds a blank row. The button hides itself once you reach 6.
- Delete - removes a row. The last remaining row cannot be deleted (you need at least one link).
- Save - validates every row and pushes the new list to the backend. A toast confirms success or surfaces an error.
- Reset to defaults - restores the three shipped defaults. A confirmation dialog appears first since it cannot be undone.
Validation runs on every save - typing a malformed URL or leaving a label blank highlights the bad field and prevents the save.
[ADD SCREENSHOT/IMAGE: Admin form showing three or four link rows stacked vertically, an "Add link" button at the bottom, a "Save" primary button and a "Reset to defaults" secondary button in the footer, with a small confirmation dialog overlaid asking "Reset all support links to the shipped defaults?".]
04. When changes take effect
Immediately. The next user who hits the no-license screen sees the updated list - no redeploy, no waiting.
05. Locale and theme
The admin page itself is translated into your Jira language. The links you configure are shown verbatim to all users regardless of their language - translate the labels yourself if you want a multilingual setup.
The page follows your Jira light/dark theme automatically, just like the main Synaps map.
06. Common setups
- Point at your internal wiki. Replace the docs link with a link to your team's onboarding page so questions land in the right place.
- Funnel everything to one inbox. Replace the support ticket link with a
mailto:to your platform team and label it "Email the platform team". - Use Slack or Teams. Add a chat icon link to your dedicated channel so people who hit the no-license screen can ping the right room.