Learn how to transition your legacy cards to dataset-based cards by identifying, configuring, and recreating them for an upcoming upgrade.

1. Go to the Explorer, and identify the legacy cards that you want to keep. For legacy cards that are not needed, you can delete them.
2. Note down the configuration of each card. We recommend copying the following information into a spreadsheet.

   • Card title

   • Card description

   • Metric

   • Metric time granularity (days, weeks, or months)

   • Number of metric periods (for example, last 12)

   • Filter fields: Take note of all the fields that you use to filter your metric. You'll need to include these fields in your dataset definitions.

   • Group-by field: Note down the group-by field that you use. You'll need it in your dataset definitions.

   • Whether the card is pinned to the Dashboard. If yes, take note of its configuration details:

     • Which row is it on?

     • How wide is it?

     • Which display option does it use? KPI only, KPI and chart, or chart-only?

     • What position is it on the row from left to right?

3. Create datasets for your cards.

   • Go through your spreadsheet and create one dataset for each unique combination of metric, metric time granularity, and the number of metric periods. For instance, if you had two cards with the metric Net MRR and one of them displayed data for the last 12 months and the other displayed data for the last 4 quarters, then you will need to create two datasets (one for monthly Net MRR and another for quarterly Net MRR). If you had two cards both with Net MRR for the last 12 months, then you would only need to create one dataset with Net MRR for the last 12 months. Keep in mind that a single dataset in Analytics can be reused in multiple cards.

   • For each dataset, in the Field section, add all of the fields that you used in your card filters or group-by fields for cards with the same metric, metric time granularity, and number of metric periods.

   • Add a title and description for your dataset and save it. Make a note in your spreadsheet of legacy card the name of the dataset you created for it.

4. Delete all of your legacy cards.
5. Create your cards based on the datasets that you created in Step 3.

   • Go through your spreadsheet and, for each legacy card, create a new time series card.

   • For each card, select the dataset you created in Step 3 for the legacy cards, and then add a group by field and filters consistent with your card configuration. Name the new card the same as your legacy card.

6. Pin your new cards to the dashboard.

   • For each legacy card that was pinned to the Dashboard, find the corresponding new dataset-based card that you created in Step 5, and pin it to the dashboard.

   • Open the dashboard. For each newly pinned card on the dashboard, arrange it to the same location, adjust it to the desired width, and use the same display options (KPI only, KPI and chart, or chart-only).