Templates help teams efficiently and confidently recreate their common analyses and share best practices with just a few clicks. Have you ever wanted to reuse a past analysis you had created? Or perhaps you are releasing a new version of your mobile app and want to evaluate how it performs based on the same set of reports you used to evaluate your last release?
You can create templates from any saved charts or dashboards and choose any events, properties, cohorts, dates, projects, or titles appearing in those charts to templatize. You and your teammates can create new dashboards from these templates.
Use this feature to standardize team reporting by turning best practices into templates. Save time when repeating common analyses and make it simpler for new team members to measure impact:
- Create a standard A/B Test methodology so anyone can see and evaluate the results
- Establish a common set of analyses for new releases to measure performance and adoption
- Roll out regional dashboards for leadership and local teams with just a few clicks
- Replicate KPI measurements across accounts, platforms, and core features
What You Will Learn in This Article
This article is an in-depth guide of how to use Templates. Amplitude provides users the ability to visit the Template Gallery in Amplitude and select from an existing template or create a new one to get started. We will cover the steps to create a template and how you can use an existing template. We will also highlight use cases and current capabilities of Templates.
Prerequisites
Before you start reading this article, we recommend that you have a look at the prerequisites list below. The information presented in this list will help you out with useful information and best practices:
- This feature is only available to Growth and Enterprise plans.
- This feature is relatively new and updates are being added regularly - please see Current Capabilities.
- This feature only applies to Charts and Dashboards for now.
- Permissions function similarly to Dashboard permissions - please see Permissions section.
- Use cases between Templates and the “Bulk Filter” feature on Dashboards are different - please see Use Cases section.
Table of Contents
- Template Gallery
- Creating and Editing a Template
- Using an existing Template
- Use Cases
- Permissions
- Current Capabilities
Template Gallery
A new section called Templates is available on the navigation bar. This opens the Template Gallery where users can create new templates and use existing templates. All users are able to create Templates but only Members, Managers, and Admins can publish templates to the Gallery for others to find.
Creating and Editing a Template
Begin by clicking on “New Template”. This will open up the set-up page to create the new template. The set-up consists of three steps:
- Choose Charts
- Set Template Variables: Properties, Events, and Projects
- Configure Dates and Titles
Step 1: Choose Charts
Start by selecting the charts and/or dashboards you want to include in this template. You can add or remove these charts in the future by editing your template.
Note: Adding charts to the template will not affect the originals and any edits made to the original charts will not impact your template. If you would like to make changes to the charts in your template later on, click into them directly from your template and make changes.
Step 2: Set Template Variables
Here you will choose the property values, event types, and projects. Choose any elements you would like users to be able to “find and replace” in your selected charts from step one.
Note: The elements shown in this step all appear in the charts you selected. You cannot customize elements that do not already appear in these charts.
For example, if you were creating a template to track how each new version of your app affects key engagement metrics, you might select a user property called “version id”. Selecting this property would allow you to create a new dashboard for each new “version id” you have, while keeping all other properties and events in your charts the same.
Step 3: Configure Dates and Titles
Finally, choose any dates or chart titles you would like to templatize.
Here are the items you can customize in more detail:
- Properties and events - Templatizing a property or event makes it replaceable in every chart it is in. Unselected events or properties will be kept the same. You may also write in a description above these sections to let users know how to use your template.
- Projects - You may also know a Project as a data source. For example, your company may have an “Android” and an “iOS” project. Templatizing a project will allow all events and properties associated with that project to be swapped to another project. Only use this in the case where you have projects with similar event and property names.
- Chart Titles - Think of this as a “find and replace” function for chart titles. You can type any part of a chart title and make it replaceable. For example, typing in “1” will allow you to find and replace “1” in any chart titles it appears in. This would allow you to change “A/B test 1” to “A/B test 2” in any chart titles.
You may go back to previous steps to make any needed changes. When you are ready, save your template. Fill out a name and description that would be easy to recognize for your team members.
Editing your templates
After your template has been created, you can then edit the template to add more charts and change the replaceable values. You can also delete the template.
Using an Existing Template
In the Templates tab, use any existing Templates to make your own version of the selected Dashboard. We allow you to "find & replace" particular values in the dashboard (i.e. change "Android" to "iOS") in order to save time copying each analysis. To share the Template with a colleague, simply share the link.
Once you open a template, the charts that make up the dashboard template will be on the left half of the page. The properties you can change will be under the Select Values column. Choose the values that you want to apply to the charts. If you click “Preview Charts”, you can see how your selections will update the charts in the template.
After selecting the values, you are then ready to create your dashboard! By creating a dashboard, you will create a new set of charts with the new values you have selected.
Use Cases
Common Template Use Cases
A/B testing: swap out user or event properties or cohorts with each new experiment’s variants
Releases: swap out version, campaign, region, etc. to track performance or key metrics for new releases
Usage or Engagement dashboards: segment by feature/product, region, device, customer, channels, etc. to analyze metrics like engagement with critical events or specific funnels that are notable to a feature or company
B2B or Partner use cases: create different dashboards segmented by the customer account or partner
Amplitude New User Onboarding: companies often build templates for the above use cases to help onboard new Amplitude users at their company to their teams’ common analyses
Templates vs Dashboard Filters
Templates | Dashboard Bulk Filter |
---|---|
Repeatable dashboards you want to recreate and even share to others
|
Temporary views and filters
|
Permissions
Permissions function the same way as Dashboard permissions.
- Admins can edit all templates.
- If a template includes charts from a project you do not have access to, you will not be able to view it.
- Templates can only have a single “owner” - you cannot currently grant access to editing your template to another user. This feature will be added soon.
- All users will be able to create Templates but only Members and above can publish them to the Gallery. As a Viewer, you may still share a direct link to your template with others.
Current Capabilities
Templates is a new feature with further additions in the works. As such here are current known limitations to the feature:
- Only items already on the charts in the dashboard can be customized.
- Only fixed time date ranges can be swapped. For example, you can swap starts on May 2 for April 2, but you can’t swap “Last 30 days” for “Last 60 days”.
- Public links are not available for Templates.
- Dashboard templates cannot programmatically create multiple dashboards.
- Updating the original template will not update end users’ dashboards created from the template.