Add external links
External links appear as cards in the dialog, below HTML (top). Use them to point customers to related resources, such as a public FAQ or your company website. You can add any number of links. If you use dialog variants, each variant has its own links.
Before you start
Work on the master instance. Secondary instances show this configuration but don’t let you edit it.
Steps
In Jira, select the cog icon and go to Marketplace apps > UniPortal > Configuration.
If you use dialog variants, open the Dialog variant field and select the dialog you want to edit.
On the General settings tab, go to the External links section.
Select Add link. UniPortal adds an empty card at the end of the list.
Enter a title in the name field of the new card. The title is required.
Enter the address in the Enter URL field. The URL is required and must be a valid URL.
Optionally, enter a description in the text area below the title.
Optionally, add an icon: select the empty icon tile next to the title and upload an SVG, GIF, JPG, JPEG, or PNG file. UniPortal has no predefined icons. The tile then shows a preview of the image.
Select Save changes.
Change or remove an icon
- Select the icon tile of the link.
- Select Replace icon to upload another image, or Remove icon to remove it.
- Select Save changes. If you select Cancel instead, the icon stays as it was.
Removing an icon needs no confirmation and doesn’t delete the link. The card then appears in the dialog without an icon.
Reorder or delete links
To change the order of the cards, drag a link by its handle on the left. To remove a link, select the trash icon on its card. Both changes take effect when you select Save changes.
Result
Each link appears as a card in the dialog, with its icon, title, and description. A link without an icon appears without one. The cards are arranged in a grid of up to five per row. If you add no links, the block doesn’t appear.
A link to the customer portal of a connected instance appears only for customers who have access to that portal. Every other link appears for all customers. For more about what customers see, see View on Customer Portal.