Portal Banners for JSM – Admin Setup Guide
How to set up Portal Banners for JSM: create templates, show them in the header, below the header or footer of chosen portals and pages, schedule them and let customers close them.
- Overview
- Documentation: Modules
- Documentation: Pages
- Documentation: Service Desks
- Documentation: Template Type
- Privacy Policy
Portal Banners puts your own notices on the Jira Service Management help center: a maintenance warning, a how-to with a diagram, contacts in the footer. You write a template once and choose where customers see it.
How to read the pictures. Every screenshot comes from a real Jira site. The red boxes with numbers show where to look or click. Number 1 in the picture is step 1 in the text, number 2 is step 2, and so on.
Get started in 2 minutes
- Install Portal Banners from the Atlassian Marketplace (a Jira admin; free for up to 10 users).
- Open Jira settings → Apps → Portal Banners — the Templates tab.
- Create template → Planned maintenance: the starter fills in the text and the notice style; replace the
<placeholders>and save. - Show to customers: Header, All service desks, All pages — and the notice is on your portal. Add Show until and it disappears on its own.
Overview
Portal Banners shows content you write to the customers of your Jira Service Management help center and portals — announcement banners, maintenance notices, how-tos, diagrams, contacts. You write templates in Jira’s admin area and show them in the header, below the header, in the footer or in a dialog of the portal pages you choose.
Customers need no Jira licence; a public help center shows the content to anonymous visitors too. The app runs on Atlassian Forge, stores templates in your Atlassian site and loads nothing from other websites.
The four parts of a showing have their own pages: where on the page, service desks, pages and template types.
Install and open
- Install Portal Banners from the Atlassian Marketplace.
- Open Jira settings → Apps → Portal Banners (also Configure or Get started in Manage apps). Only Jira admins and site admins see it.
The page has two tabs: Templates and Where templates are shown. Until you press Got it, one line says how it works: 1 Create a template → 2 Show to customers → 3 See it on the portal.
- In Jira settings, open Apps and choose Portal Banners in the sidebar.
- The two tabs: Templates and Where templates are shown.
- Create template starts a new one.
- How it works sums up the three steps. Guide opens this page.
1. Create a template
Start from a ready template
Create template first offers ready templates: Planned maintenance, Outage, Support hours, How to raise a request, Request flow (Mermaid), Video and Blank. A starter fills in the type, the text and the notice style; replace the <placeholders> with your own. The template types are tiles, each with one line about it.

- Click a starter, for example Planned maintenance. The form opens already filled in.
- Or pick Blank to start from an empty form.
- Cancel closes the list.
The form
Create template (or Blank) opens one form:
- Template name — up to 70 characters.
- Project folder (optional) — only for finding templates later; it does not decide where they are shown.
- Template type — Markdown, Video link, HTML, Website link, Flowchart (Mermaid), Rich text (Atlassian editor) or Several templates. The open list shows one line about each type; see template types.
- Size and position — Width (number with % or px), Height (px or auto) and Position (Left, Center, Right).
- The type’s input, with Preview.
Save template stores it. While something is missing it says what (“Write the Markdown.”, “Enter a template name first.”).
- Type the Template name. Customers do not see it; it is for you.
- Pick a Project folder if you want to find the template faster later.
- Click a Template type. Markdown is the usual choice.
- Size and position sets the width, height and left, center or right.
- Notice style colours the notice: plain, blue info, yellow warning or green success.
- Add a button with its text and link if customers should open a page.
- Click the microphone to dictate the text instead of typing.
- The toolbar adds bold, italics, links, lists, headings, formulas and diagrams.
- Write the text. Replace every
[placeholder]with your own words. - Pick a Preview tab to see the template in that place.
- The preview shows exactly what customers will see.
- Press Save template.
2. Show it to customers
Show to customers on a template’s card decides where customers see it. Once it is shown, the same button is called Change where it’s shown.
- Click a place on the page sketch. Header is the top of every portal page.
- The other places are Below the header, Dialog (a pop-up) and Footer. You can choose several.
- Check the preview.
- All service desks, or switch it off and pick the desks.
- All pages, or switch it off and pick the pages.
- When: now, tonight, this weekend, or Custom dates. After the end, customers no longer see it.
- Customers can close it gives them a ×.
- Where on the page — Header, Below the header, Footer and Dialog; several at once. A small sketch of a portal page lights the places you chose.
- Service desks — All service desks, or the ones you choose.
- Pages — All pages, or Help center, Portal home, Create request, View request, Profile and My requests.
- Show from / Show until (optional) — customers see the template only in that window: a maintenance notice that appears and disappears on its own. The time zone is named under the fields.
- Customers can close it — customers get a × on the template. Show again chooses never (until the content changes), on every visit, after a number of hours or days, or at most a number of times. It is remembered in each customer’s browser.
One template per place and page: showing replaces what was there, and the dialog warns first (‘Replaces “Welcome” shown here.’). Show to customers is enabled once a place, a service desk and a page are chosen.
- Show again decides when a closed notice comes back: never, on every visit, after some hours, or at most a number of times.
- Read the summary: one sentence that says where and when customers see it.
- Press Save (or Show to customers for a new template).
- Stop showing takes it off the portal. The template stays.
3. See it on the portal

- Open your portal: the notice is at the top, under the welcome text.
- Customers close it with ×. With Show again: Never it stays closed in their browser until you change the template.
The portal asks for the template shown on this service desk and page — the desk’s own first, otherwise the one shown on all service desks — and shows it with its width, height and position. Links open in a new tab. When nothing is shown, the place takes no room; when a template cannot be read or the licence is inactive, customers see nothing, never an error.
A Markdown template can mix a how-to with a diagram, here below the header of the IT Help Desk portal:

- A Markdown template below the header with three numbered steps.
- The same template draws a diagram from Mermaid text.
And a footer with contacts and links on every page of the help center:

- The footer template: contacts and links at the bottom of every page.
Manage templates
- The tiles count templates by state. Click one to see only those.
- Search by name, or pick what to Show.
- Each card says its state, type and where it is shown. The small drawing lights up the places.
- Change where it’s shown opens the dialog from step 2.
- ⋯ has Preview, Edit, Stop showing, Duplicate and Delete.
Templates as cards
- Four tiles on top — Showing now, Scheduled, Ended and Not shown — each with its count; a tile also filters the list.
- A card per template: a small drawing of a portal page that lights the places it is shown in, its title, state, type and where it is shown in words (“Shown: Header · all service desks”), Show to customers, and ⋯ with Preview, Edit, Duplicate and Delete.
- Preview opens the template as customers see it; Edit changes it (renaming renames it everywhere). A template that is showing has Save and Stop showing in its dialog.
- Search templates filters by title; Delete asks first, and customers stop seeing it everywhere it is shown.
Where templates are shown
The second tab lists every service desk of the site in one table — All service desks first — with a search over all of them, and every showing by place and page:
- All service desks comes first. Stop showing everything clears it.
- Header: the template, its pages and its state.
- Below the header: here only on the Create request page.
- Footer: on all pages.
Every service desk follows with its own showings.
Stop showing removes one showing; Stop showing everything, under a service desk’s name, clears that desk. Both ask first. The template itself stays. Clean up ended removes the showings whose Show until has passed.
Permissions and data
- Who changes templates: only Jira admins, from the admin page — the app asks Jira on every change.
- Who sees them: customers and visitors of the help center and portals, on the service desk and page they are on. The portal can read only the templates that are shown.
- What is stored: templates (title, type, content, size and position), the project folders’ names and avatars, and where each template is shown — in the app’s Forge storage inside your Atlassian site. Nothing about customers, requests or users.
- Nothing from other sites: video and website templates show a button that opens the link in a new tab; in HTML and Markdown, frames and media from the web become links. Scripts and forms are removed before customers see anything.
See the privacy policy.
Troubleshooting
- Customers don’t see a template — check Where templates are shown: the service desk may show its own template at that place, the showing may be scheduled for later or have ended, or the customer closed it.
- “Choose at least one page.” next to Show to customers — tick a page or All pages.
- All pages is unticked when I choose service desks — Help center, Profile and My requests belong to the whole help center, so they need All service desks.
- “Banners & Content needs an active licence.” — a Jira admin renews it in Manage apps.
Still stuck? Contact support.
Related apps
- SLA Reports & Compliance Dashboard for JSM — weekly SLA compliance, breaches and trends.
- Speech to Text & Voice Dictation for Jira — customers dictate requests on the portal.