Customizing the homepage template
Introduced in 2024.2
Updated in 2025
The Homepage Template section lets you define the layout and content of your Self Service Portal's homepage. This dashboard gives users quick access to essential features like knowledge base search, ticket submission, service requests, and various widgets showing open tickets, recent activity, or pending approvals.
The template controls the structure of the homepage, including the number of columns and where widgets appear. Combined with visual settings like the Color Theme, , it shapes the overall look and usability of your portal.
Customize the layout
Use the built-in JSON editor to fine-tune widget properties, layout, and behavior.
For example:
-
Hide or show the Find a Solution search box by setting the
visibleparameter for the "search" item totrueorfalse -
Adjust the
itemCountfor specific widgets to change the number of shown items
About widget texts and localization
Widget titles and descriptions are stored in localization files. The homepage template only references them.
For example, the Ticket Submit widget uses the localization keys FRAME_TITLE.TICKET_SUBMIT for the title and FRAME_TITLE.TICKET_SUBMIT.DESC for the description:
{
"type": "TicketSubmit",
"title": "FRAME_TITLE.TICKET_SUBMIT",
"description": "FRAME_TITLE.TICKET_SUBMIT.DESC"
}
You can use these localization keys to change widget texts by editing the localization files. To do this, first export the desired language, make the necessary changes, and then upload the modified language pack. For more details, seeConfiguring languages for the Self Service Portal.
TIP: If you're not using multiple languages in the Self Service Portal, you can modify these texts directly in the template. This approach is not recommended, as changes made in the template will appear in all languages and override localized versions.
Save and reuse templates
The homepage template is a JSON file that you can save, reuse, or transfer between environments.
-
To save your custom template, use the Export option. This creates a JSON file that can be backed up or reused.
-
To apply a saved configuration, use Import to upload the JSON file. This allows you to replicate homepage layouts across multiple portal instances.
Restore the default homepage
Homepage changes, like all other portal settings, can be reset to their default state at any time.
-
To restore the default homepage layout at any time, click Restore Default.