Use metrics blocks in dashboards

Use metrics blocks in dashboards

8 min read
I. Intro
You can add metrics blocks to dashboards in Base to intuitively show key metrics, such as the total sales volume, inventory balance, and so on. You can also use metrics blocks to add change over time data to compare the level of development and configure trend charts to view changes to key metrics.
Note: Blocks can be viewed on the mobile app (Lark version 7.32 or above), but adding or editing them isn't supported.
II. Steps
Add a metrics block
  1. Open the base and click Dashboard on the left navigation bar.
250px|700px|reset
  1. At the top, click Add Block and select Metrics under Other.
250px|700px|reset
Configure a metrics block
After adding a metrics block, you can configure its block type, data, and style.
  • You can configure the following settings under the Setup tab:
  • Description: You can set a name for the block.
  • Data source: You can select any table in the current base as the data source for the block. The number of records in the selected table or the value of a field will be counted. If your Lark plan supports multiple data sources, you can select Multi-source mode to select multiple tables to be used as the data source.
  • Data range: You can select a view from the table or set a filter scope to filter for the data you need.
  • Analyze data: You can select Number of records (default) or Field summary as the analytical method for the block.
  • Number of records: The number of records is added up.
  • Field summary: This option can only be selected if the table contains number fields, formula fields with numeric results, or lookup fields referencing numeric values. When this option is selected, you need to select the field to apply to and the calculation methods to use, such as Sum, Max, Min, or Average, under Select field.
  • Change over time: This is unselected by default. If you select this option, you can configure the corresponding date and time field, time range, description, calculation method, and calculation type.
  • Date and time field: You can select date, created at, and last updated fields, as well as formula fields in which the calculated result is a date.
  • Time range: You can select Today, This week, This month, This quarter, This year, Week to date, Month to date, Quarter to date, Year to date, Yesterday, Last week, Last month, Last quarter, Last year, Last 7 days, Last 14 days, Last 30 days, Last 3 months, Last 6 months, Last 365 days, or a custom time range.
  • Note: If you select This week, This month, This quarter, or This year, the range will include data for the entire cycle, including future dates within that cycle. If you select Week to date, Month to date, Quarter to date, or Year to date, the range will include data from the start of the current cycle up to and including today.
  • Description: You can set a description, which will be displayed in the block.
  • Calculation method: You can select Period-to-period (default), Week-over-week, Month-over-month, Year-over-year, or a custom comparison.
  • Calculation type: You can select Discrepancy rate (default), Discrepancy, or Original value.
  • Discrepancy: Data in the current period - Date in the same period some time ago
  • Discrepancy rate: (Data in the current period - Data in the same period some time ago) ÷ Data in the same period some time ago × 100%
  • Original value: Data in the same period some time ago
Note: For details on change over time settings, see below.
  • Trend chart: This is unselected by default. If you select this option, you can configure the corresponding date and time field and time range. The date and time field will be used as the time axis in the chart, and the time range is the time period that will be covered by the chart. Once the configuration is complete, it will be displayed in the metrics block as a line chart.
  • Date and time field: You can select date, created at, and last updated fields, as well as formula fields in which the calculated result is a date.
  • Time range: You can select This week, This month, This quarter, This year, Week to date, Month to date, Quarter to date, Year to date, Last week, Last month, Last quarter, Last year, Last 7 days, Last 14 days, Last 30 days, Last 3 months, Last 6 months, Last 365 days, or a custom time range.
  • Note:
  • For trend charts to work, there must be at least three records within the selected time range.
  • If you select This week, This month, This quarter, or This year, the range will include data for the entire cycle, including future dates within that cycle. If you select Week to date, Month to date, Quarter to date, or Year to date, the range will include data from the start of the current cycle up to and including today.
250px|700px|reset
  • You can configure the following settings under the Customize tab:
  • Background: You can set a custom background color for the block.
  • Font color: You can select a font color for the text in the block.
  • Number format: You can set the format for numbers in the block.
  • Arrow style: You can select the icon style for trends (up, down, flat) of year-on-year and month-on-month data.
250px|700px|reset
After completing the settings, click Confirm in the lower-right corner to add the metrics block to your dashboard.
Note: You can add multiple data sources for a metrics block. For more information on configuring data sources, see Add multiple data sources to dashboard blocks.
Configure change over time
Under the Setup tab, you can select Change over time to configure period-to-period, period-over-period, or custom comparison methods. The definitions of these methods are as follows.
  • Period-over-period: This is the rate of change from the same period some time ago, that is, the changes as compared to the same time period some time ago. Period-over-period can be divided into week-over-week, month-over-month, and year-over-year. Week-over-week refers to the rate of change calculated by comparing the current data to the data from the same time period a week ago. It is used to observe short-term trends. Month-over-month refers to the rate of change calculated by comparing the current data to the data from the same time period a month ago. It reflects the monthly development trends. Year-over-year compares the current data to the data from the same time period a year ago. It is an important metric for evaluating long-term development and annual changes. For instance, a comparison of the data from September 2024 and September 2023 is referred to as year-over-year.
The formulas for the calculation of period-over-period are:
  • Period-over-period discrepancy rate = (Data in the current period - Data in the same period some time ago) ÷ Data in the same period some time ago × 100%
  • Period-over-period discrepancy = Data in the current period - Data in the same period some time ago
  • Original value = Data in the same period some time ago
  • Period to period: This is the rate of change between two adjacent periods, which indicates the changes from one period to the next. For instance, a comparison of the data from September 2024 and August 2024 is referred to as period-to-period.
The formulas for the calculation of period-to-period are:
  • Period-to-period discrepancy rate = (Data in the current period - Data in the previous period) ÷ Data in the previous period × 100%
  • Period-to-period discrepancy = Data in the current period - Data in the previous period
  • Original value = Data in the previous period
  • Custom comparison: You can use a custom time period as needed to compare the data in the current time period to a certain custom time period, so as to meet personalized data analysis needs.
The formulas for calculation of custom comparison are:
  • Custom discrepancy rate = (Data in the current period - Data in the specified period) ÷ Data in the specified period × 100%
  • Custom discrepancy = Data in the current period - Data in the specified period
  • Original value = Data in the specified period
When configuring change over time, the availability of calculation methods depends on the time range you select. In the following table, June 28, 2024 (Friday) is used as an example for today to show available calculation methods and the time range compared depending on the selected time range.
Selected time range
Compared time range
Period-to-period
Week-over-week
Month-over-month
Year-over-year
Today: 2024/06/28
Previous day: 2024/06/27
A week ago: 2024/06/21
Same day last month: 2024/05/28
Same day last year: 2023/06/28
Yesterday: 2024/06/27
Previous day: 2024/06/27
A week ago: 2024/06/20
Same day last month: 2024/05/27
Same day last year: 2023/06/27
This week (7 days): 2024/06/24 - 2024/06/30
Last week (7 days): 2024/06/17 - 2024/06/23
Last week (7 days): 2024/06/17 - 2024/06/23
Not comparable
Same period last year (7 days): 2023/06/24 - 2023/06/30
Week to date (5 days): 2024/06/24 - 2024/06/28
Last week (5 days): 2024/06/17 - 2024/06/21
Last week (5 days): 2024/06/17 - 2024/06/21
Not comparable
Same period last year (5 days): 2023/06/24 - 2023/06/30
Last week: 2024/06/17 - 2024/06/23
Two weeks ago: 2024/06/10 - 2024/06/16
Two weeks ago: 2024/06/10 - 2024/06/16
Not comparable
Same period last year: 2023/06/17 - 2023/06/23
This month (whole month): 2024/06/01 - 2024/06/30
Last month (whole month): 2024/05/01 - 2024/05/31
Not comparable
Last month (whole month): 2024/05/01 - 2024/05/31
Same period last year (whole month): 2023/05/01 - 2023/05/31
Month to date: 2024/06/01 - 2024/06/28
Last month (not a whole month): 2024/05/01 - 2024/05/28
Not comparable
Last month (not a whole month): 2024/05/01 - 2024/05/28
Same period last year (not a whole month): 2023/05/01 - 2023/05/28
Last month: 2024/05/01 - 2024/05/31
Two months ago: 2024/04/01 - 2024/04/30
Not comparable
Two months ago: 2024/04/01 - 2024/04/30
Same period last year: 2023/05/01 - 2023/05/31
This quarter:
April 1, 2024 - June 30, 2024
Last quarter: January 1, 2024 - March 31, 2024
Not comparable
Not comparable
Same quarter last year: April 1, 2023 - June 30, 2023
Quarter to date:
April 1, 2024 - June 28, 2024
Last quarter (not a full quarter): January 1, 2024 - March 28, 2024
Not comparable
Not comparable
Same quarter last year (not a full quarter):
April 1, 2023 - June 28, 2023
Last quarter: January 1, 2024 - March 31, 2024
Two quarters ago: October 1, 2023 - December 31, 2024
Not comparable
Not comparable
Same quarter last year:
January 1, 2023 - March 31, 2023
This year: January 1, 2024 - December 31, 2024
Last year: January 1, 2023 - December 31, 2023
Not comparable
Not comparable
Last year: January 1, 2023 - December 31, 2023
Year to date: January 1, 2024 - June 28, 2024
Last year (not a full year): January 1, 2023 - June 28, 2024
Not comparable
Not comparable
Last year (not a full year): January 1, 2023 - June 28, 2023
Last year: January 1, 2023 - December 31, 2023
The year before last: January 1, 2022 - December 31, 2022
Not comparable
Not comparable
The year before last: January 1, 2022 - December 31, 2022
Last 7/14/30/365 days
Previous 7/14/30/365 days
Not comparable
Not comparable
Not comparable
Last 3 months: April 1, 2024 - June 28, 2024
January 1, 2024 - March 28, 2024
Not comparable
Not comparable
Not comparable
Last 6 months: January 1, 2024 - June 28, 2024
June 1, 2023 - December 28, 2023
Not comparable
Not comparable
Not comparable
Note: When configuring change over time, the last day of a month will be selected if there is no corresponding date in that month for the selected time range. For instance, if today is 10/31/2024, the selected time range is Today, and the selected calculation method is Month-over-month, the compared time period will be 9/30/2024. If today is 03/31/2024, the selected time range is This month, and the selected calculation method is Month-over-month, the compared time range will be 2/1/2024–2/29/2024.
If you want to see the changes in the number of orders between this year and last year, after selecting Change over time, you can select This year as the time range, Year-over-year as the calculation method, and Discrepancy rate as the calculation type.
250px|700px|reset
Manage a metrics block
Click the icon in the upper-right corner of the block to configure, duplicate, delete, change its background color, copy it to another dashboard, or move to a layout block.
250px|700px|reset
You can also select the block and drag the lower-right corner to adjust the block size or drag the top of the block to move it.
III. FAQs
Can I use metrics blocks on the mobile app?
On the mobile app, you can view metrics blocks, but you can't add or edit them.
While configuring a metrics block, what time period does the selected time range refer to exactly?
Refer to the table below for details.
Time range
Description
Week to date
Refers to the week in which today falls, from Monday of the current week to today, or from Monday to Sunday if a full week is needed.
If today is Wednesday (10/16/2024), then the time range is from Monday to Wednesday (10/14/2024–10/16/2024). The compared time range is also from Monday to Wednesday in a certain period.
This week
Refers to the whole week in which today falls.
Last week
Refers to the week preceding the week in which today falls.
Month to date
Refers to the month in which today falls, from the 1st of the current month to today.
This month
Refers to the whole month in which today falls.
Last month
Refers to the month preceding the month in which today falls.
Quarter to date
Refers to the quarter in which today falls, where the four quarters are defined as January 1 to March 31, April 1 to June 30, July 1 to September 30, and October 1 to December 31, respectively.
If today is July 29, then the time range is from the beginning of the respective quarter to today (July 1 to July 29). The compared time range is also from July 1 to July 29 in a certain period.
This quarter
Refers to the whole quarter in which today falls.
Last quarter
Refers to the quarter preceding the quarter in which today falls.
Year to date
Refers to the year in which today falls, from January 1 to today.
This year
Refers to the whole year in which today falls.
Last year
Refers to the year preceding the year in which today falls.
Last 7/14/30/365 days
Refers to the past 7/14/30/365 days (including today).
Last 3 months
Refers to the 2 months prior to the month in which today falls, from the first day of that month to today. If today is August 1, then the last 3 months would be June 1 to August 1.
Last 6 months
Refers to the 5 months prior to the month in which today falls, from the first day of that month to today. If today is August 1, then the last 6 months would be March 1 to August 1.
Written by: Lark Help Center
Updated on 2025-03-08
How satisfied are you with this content?
Thank you for your feedback!
Need more help? Please contact Support.
0
rangeDom
rangeDom
rangeDom