What is a dashboard template?
A dashboard template is a ready-made dashboard that you can install into your own space. It contains the layout, the widgets and the configuration of the metrics, but no data. When you install a template, Indicate creates a normal dashboard in your space and connects it to your own Insights.
You can also publish one of your own dashboards as a template, either publicly or for selected spaces only.
Template or duplicate?
There are two ways to reuse a dashboard in Indicate. Pick the one that fits how much control the receiving side should have.
Template: The receiving space stays in control. A template has revisions. Every space that installed it sees when a newer revision exists and decides on its own whether to update. Use a template when other teams should start from your dashboard and then own their version.
Duplicate: The source dashboard stays in control. Resyncing overwrites all changes made in a copy. Use a duplicate when you maintain the same dashboard for several hotels or spaces yourself and want them all to stay identical. See Duplicate a dashboard.
Dashboard templates are not the catalogue of integrations under
Data sources. That catalogue lists the systems you can connect.
When do I need this?
You want to start with a proven dashboard instead of building every widget yourself.
You run several spaces, for example one per property, and want the same dashboard in each. Each space decides when to take updates.
You built a dashboard that other spaces should be able to install, for example inside your hotel group.
How do I install a template?
You find the templates under Analytics ā Templates. The page Dashboard templates has four tabs:
Marketplace: All templates you can install.
Favorites: The templates you marked with a heart.
My templates: The templates you created.
Groups: The audiences you own and the groups you were invited to.
Installing a template creates a new dashboard in your space. On the tab Marketplace, you can filter by Shared through, Tags and KPI collections, or search by name.
Open
AnalyticsāTemplates.
On the tab Marketplace, click the template you want. A detail view opens with the description and, under Included data, the KPI collections the template needs.
Click Use this template.
Enter a Dashboard name.
Under Project, click the project the dashboard should belong to.
Under Data, pick the matching Insight of your space for each entry in the column Template. You can only pick an Insight built on the same KPI collection. Click Skip to leave an entry unmapped. Its widgets then stay empty.
Click Create dashboard. The dashboard opens with its widgets filled with your own data.
The installed dashboard is a normal dashboard. You can rename it, edit its widgets or delete it without affecting the template.
How do I update an installed dashboard?
Every dashboard installed from a template shows the button Template in its toolbar. The publisher releases revisions, and you decide if and when your dashboard follows.
An update rebuilds the dashboard: Widgets you added yourself are removed, and edits to the template's widgets are reverted. This cannot be undone. Your Insights and their data never change. If you customised the dashboard and want to keep it, do not update.
Open the installed dashboard. When a newer revision exists, the button Template carries the badge Update.
Click Template. The dialog shows the installed revision, the latest revision and two tabs.
On the tab Changelog, read what the publisher changed. Revisions newer than the one you installed are marked New.
On the tab Remapping, check which of your Insights each source of the template reads from. A source the publisher added is marked New and needs a target. A source the publisher removed is marked Removed.
Click Update to the latest revision. If you only changed the mapping, click Remap & rebuild. If you are already on the latest revision and want to undo local changes, the button reads Restore from the latest revision.
In the confirmation dialog, turn on I understand this dashboard's local changes will be lost and confirm.
If the publisher took the template off the marketplace, the dialog shows Archived. You can still rebuild from the last revision. If access to a private template was withdrawn, the dashboard keeps working but can no longer be updated.
What is Insights mapping?
Insights mapping connects a template to your data. It appears when you install a template, under Data, and on the tab Remapping of the dialog Template.
The column Template lists the KPI collections the template was built on. In the column This space, you pick the Insight of your space that delivers this data. A template built on Re:Guest Communication needs an Insight in your space that is based on the same KPI collection.
Only the configuration of a template is published. The data always comes from your own space, which is why this mapping is needed.
How do I create my own template?
You build a template from scratch or turn an existing dashboard into one. Either way, the template stays a draft until you publish it, and nobody else sees it in the marketplace before that.
Option 1: Build the template from scratch
Open
AnalyticsāTemplates, click the tab My templates and click New template.
In the dialog New dashboard template, enter a Display name.
Under Description, describe what the dashboard shows. This text appears on the marketplace card.
Under Categories, type a category, for example Sales, and press
Enter. Repeat this for further categories.Turn on Private if only selected groups should see the template. Leave it off to list the template publicly.
Click Create template. The template editor opens with the status Draft.
Click Add your first widget and build the widget as on a normal dashboard. Add further widgets with Add widget until the template is complete.
Option 2: Create the template from an existing dashboard
In the left sidebar, hover over the dashboard and click the three-dot menu
ā®that appears next to its name. Or open the dashboard and click the three-dot menuā®at the top right of the toolbar.Click Create template.
Enter the Display name, Description and Categories, and turn on Private if needed.
Click Create template. The dashboard is copied into a new template and saved as a draft under My templates. Later changes to the template do not affect the dashboard it came from.
How do I add a preview screenshot and edit the template details?
The preview screenshot is what other spaces see on the marketplace card, so a template without one is often overlooked.
Open the template and click the tab Settings.
Under Preview screenshot, click Upload screenshot and choose your image. Use Replace or Remove to change it later.
Adjust Display name, Description or Categories if needed.
Click Save changes. Changes go live the next time you publish.
How do I decide who can see my template?
You set this on the tab Settings under Audience, or by clicking the audience badge in the header of the tab Canvas. With Private off, every space can see and install the template. With Private on, only the groups you pick can see it. Without a group, the template is private and shared with nobody.
Open the template and click the tab Settings.
Under Audience, set the switch Private.
If Private is on, turn on every group that should get access under Groups.
Click Save audience. Changes to the audience apply immediately, without publishing again.
How do I create a group?
A group is a named audience. You invite spaces into it and can then share private templates with the whole group. You can have several groups.
Open
AnalyticsāTemplatesand click the tab Groups.Under Groups you own, click New group.
Enter a Name, for example Key accounts, and optionally a description that says which spaces belong in this group.
Click Create group.
How do I invite a space to a group?
An invited space can see the private templates you share with the group.
Open
AnalyticsāTemplatesand click the tab Groups.Click the group in the list to open it.
On the tab Spaces, click Invite a space.
Search for one of your own spaces by name, or paste the space ID of the other space. An admin there finds the ID under
SettingsāGeneral, and on their tab Groups under Your space ID.Click Send invitation. The space appears with the status Pending until an admin there accepts. Accepted spaces show Active, declined ones Declined. Use Invite again to ask a second time.
The invited space sees the invitation on its own tab Groups under Invitations and accepts or declines it there.
How do I publish or update a template?
Publishing makes the current state of the template available in the marketplace. Every publish is recorded as a revision, and spaces that installed the template see the new revision as an Update.
Open the template and click Publish at the top right. After the first publish, the button reads Publish changes.
In the dialog Publish to the marketplace, check the KPI collections used by the template.
Under Change summary, describe what changed, for example Added churn breakdown and fixed revenue totals. Other spaces read this in their changelog before they update.
Click Publish. The status changes from Draft to Published.
When you edit a published template, its status changes to Unpublished changes until you publish again. The Revision history on the tab Settings lists every published revision, newest first.
To take a template off the marketplace, open it and click Unpublish at the top right. Dashboards that other spaces already installed keep working.
Only the configuration of your dashboard is published. None of your data is shared. Publishing a new revision never changes an installed dashboard by itself: The other spaces decide when to update.
Troubleshooting
Why does my installed dashboard show no data?
- The Insights mapping is missing or points to the wrong Insight. Open the dashboard, click Template in the toolbar, fix the mapping on the tab Remapping and click Remap & rebuild. If your space has no Insight on the same KPI collection, connect that source first.
Why doesn't the button Template appear?
The button only appears on dashboards installed from a template. Duplicated dashboards do not have it. They are updated by the owner of the source dashboard instead.
With the Reader role, the button is greyed out. Updating needs at least the User role.
Why did I lose my own widgets after an update?
- An update rebuilds the whole dashboard from the template. If you want to keep local changes, do not update, or duplicate the dashboard first and update only the original.
Why can't the other space see my private template?
Check the group first: It has to be turned on under Audience in the settings of the template.
Then check the invitation: The space has to be invited to that group, and the invitation must no longer be Pending. An admin of the other space has to accept it.
Why is my template not on the tab Marketplace?
- Templates you create are listed under My templates. Also check the status: Draft means the template was never published, and Unpublished changes means the marketplace still shows the previous revision.
Why can't I find the space I want to invite?
- The search only lists spaces you are a member of. For any other space, ask an admin there for the space ID and paste it into the search field.