All Products
Search
Document Center

Quick BI:Scorecard

Last Updated:Feb 09, 2026

A scorecard is a key visualization component in Quick BI used to display critical data or performance metrics at a glance. It presents core metrics in prominent cards so you can quickly assess your business status, identify issues, and take immediate action. Scorecards are ideal for real-time Key Performance Indicator (KPI) monitoring or when you need precise values for one or more measures within a single dimension.

Overview

Scenarios

Commonly used to display one or more measures under a single dimension, especially in scenarios that require precise readings of specific metrics.

Benefits

  • Calculations: Configure year-over-year and period-over-period calculations with a single click.

  • Visualization: Add logos or icons, and set custom backgrounds, font sizes, and colors.

  • Annotations: Add custom text or metric notes, and add external links to connect data with other systems.

Example Rendering

指标看板

Limits

  • Prerequisites

    • Data modeling: You must complete data modeling. Your dataset must include a date-type dimension field with daily granularity, for example, Order Date (day).

    • Dashboard Creation: You have created a dashboard. For more information, see Create a Dashboard.

  • Field configuration limits

    A scorecard has two parts: Labels (Dim.) and Metrics (Mea.).

    • You can select only one dimension for Labels (Dim.), such as region.

    • You can select 1 to 20 measures for Metrics (Mea.), such as order quantity and order amount.

Chart Data Configuration

  1. On the Field tab, select a dimension and one or more measures:

    • In the Dimension list, find the Province dimension. Double-click it or drag it to the Labels (Dim.) section.

    • In the Measure list, find the Order amount, Shipping cost, and Profit amount measures. Double-click them or drag them to the Metrics (Mea.) section in the desired order.

    Note

    The first measure in the Metrics (Mea.) section is the primary measure. To change the primary measure, you can reorder the measures in the Metrics (Mea.) section.

  2. Click Update. The system automatically updates the chart.

    image.png

Chart Style Configuration

This section describes how to configure the style of a scorecard. For information about common chart style settings, see Configure the chart title.

image

Quick Layout

You can select a layout template from the quick layout options. The first template is selected by default. Click the reset icon (image) to restore the original layout. Resetting does not affect content-related settings such as text or color.

Layout templates

Preview

Master/Sub Templates

Highlights one primary metric. Use this when you want to emphasize a key metric.

Primary and secondary 1

image

Note

The first measure in the Metrics (Mea.) section is the primary measure. All others are secondary measures.

Primary and secondary 2

image

Primary and secondary 3

image

Primary and secondary 4

image

Primary and secondary 5

image

Primary and secondary 6

image

Parallel Template

Shows all metrics equally. Use this when you need clear visibility of every metric.

Parataxis 1

image

Parallel 1

image

Metric Layout

In the Metric layout section, you can set the layout style for metric blocks.

image

Chart Configuration Item

Description

Metric relationship

Choose Parataxis or Primary and secondary.

111

Metric block group layout

Choose Horizontal scroll or Wrap.

111

Metric block groups per row

Set how many metric block groups appear on each row. Set separate values for mobile and desktop. Choose Auto or Fixed count.111

  • Auto: Adjusts automatically based on the widget size.

  • Fixed count: Keeps the same number of metric blocks regardless of widget size.

    Note

    On mobile, up to three metric block groups appear per row.

Metric block splitting

Choose None, Line separator, or Fill background. With Line separator, set the line color. With Fill background, set the background color and padding.

111

Metric Content

In the Metric content section, you can set the position, display mode, font size, and trend chart style for the content inside metric blocks.

image

Chart configuration items

Description

Metric layout

Settings vary by layout template.

  • For Primary and secondary templates, set Primary and secondary layout. Choose Vertical or Horizontal.

    111

  • For Parataxis templates, set Metric layout. Choose Vertical or Horizontal.111

Name and value position

When Metric layout is Vertical, set the position of dimension names and values.111

Content position in metric block

Set where content appears inside the metric block:

  • When Metric layout is Vertical, choose Left-aligned, Center-aligned, or Right-aligned.111

  • When Metric layout is Horizontal, choose Stretch or Left-aligned.111

Text alignment

Set text alignment inside the metric block: Top-aligned, Center-aligned, or Bottom-aligned.111

Line spacing for metric values

Choose Medium or Compact.111

Show dimension name

Choose whether to show the dimension name on the scorecard.

Show primary metric name

Choose whether to show the primary metric name. This setting applies only to Primary and secondary templates.

Show secondary metric name

Choose whether to show secondary metric names. This setting applies only to Primary and secondary templates.

Secondary metric

When using a Primary and secondary template, set the layout style for secondary metrics inside the metric block.111

Font size

Turn font size settings on or off. When on, set font styles for dimensions and metrics.

Customized Metric Graph

Select whether to display the metric modifier graph. If you enable this option, you can set the modifier graph position, color scheme, modifier graph type, and graph style.

  • Position: Choose Left, Top, Right, or Left of name. When position is Left or Right, you can also adjust alignment.

    111

  • In Graph Style, you can set the display style for metric annotations. You can choose Transparent, Solid Color, or No Background. When you select Transparent or Solid Color, you can also modify the icon’s border radius value.111

  • Icon Size specifies the size of the decorative icon.

  • In Color Settings, you can configure the overall color scheme for the metric chart.

  • Type: Choose Icon library or Image field.

    1. You can use Image field only if your dataset includes an image-type field (2).

    2. When selecting materials, you can use material icons and upload your own images.

      Note

      Upload PNG, JPG, or GIF files up to 1 MB.

      image

Series Settings

In the Series settings section, you can set the series and add a prefix or suffix for metric values.

Chart configuration items

Description

Select field

Select a measure added to the Metrics (Mea.) section.

Prefix and suffix for metric value

Set the prefix and suffix for metric values.

image

Conditional Formatting

In the Conditional formatting section, you can set conditional formats for measures.image

Setting

Description

Select field

Select a measure to apply conditional formatting. Any measure added to the Metrics (Mea.) section is available.

After you finish styling, clear unwanted conditional formats. In the field panel, click Clear formats in the lower-right corner. Select the formats to remove and click OK.image

Quick style

Apply a preset style to set marker icons or font colors for the current measure.image

  • Compare: Choose Compare with zero or Compare with mean.111

  • Invert colors

    For example, with Compare with zero, values less than zero appear red and values greater than zero appear green. After inversion, values less than zero appear green and values greater than zero appear red.

    111

  • Delete: If you no longer need a set quick style, click Delete to remove it.111

Custom style

Define custom styles beyond the preset options.

  • Text: Set rules to highlight key data with specific text colors.image Configure these items:

    • Field: Choose which field the rule applies to. By default, this shows the field selected in Select field. You can also pick another field to build complex rules.

    • Condition: Choose Compare with static value or Compare with dynamic field.

    • Rule: Define the logic and the text style when the condition is met. Set text color, bold, or italic.

    • Add rule: Click to add a new rule.

  • Icon: Show a marker icon based on numeric comparison. This makes it easy to see how current data compares to target data.image Configure these items:

    • Field: Choose which field the rule applies to. By default, this shows the field selected in Select field. You can also pick another field to build complex rules.

    • Condition: Choose Compare with static value or Compare with dynamic field.

    • Rule: Click the Marker icon box. Pick an icon from the system library. Define the logic for each icon. Assign a unique icon to each rule.

    • Add rule: Click to add a new rule.

Synchronize style to

Apply the current conditional formatting to other measures.

Icon position

When you use an icon-based style, set the icon position: Right or Left.111

Chart Analysis Configuration

Configuration item

Name

Description

Data interaction

Filter interaction

If your data is spread across multiple charts, use filter interaction to link them for unified analysis. For more information, see Filter interaction.

Go To

If your data is spread across multiple dashboards, use hyperlinks to link them for unified analysis. Choose Parameter or External link. For more information, see Hyperlink.

What to do next

  • You can share the dashboard with others. For more information, see Share a dashboard.

  • You can build a topic-specific analysis dashboard with navigation menus and integrate it into the BI portal. For more information, see BI portal.

FAQ

1. When should I use a scorecard?

Answer: You can use a scorecard to obtain a quick overview of core business metrics, such as total sales, user count, or profit margin, at the top of a dashboard. It is also useful for showing multiple key metrics across a single dimension, such as region or product line.

2. How do I make the Sales metric stand out in the card?

Answer: First, on the Field tab, drag the Sales measure to the first position in the Metrics (Mea.) section to make it the primary metric. Then, on the Style tab, under Quick layout, select a Primary and secondary template. These templates highlight the primary metric using larger fonts or more prominent placement.

3. How do I show an upward arrow (if the metric increases) or downward arrow (if it decreases) next to the metric value?

Answer: You can use Conditional formatting. On the Style tab, in the Conditional formatting section, select your metric. Under Custom style > Icon, you can add rules. For example, you can set a rule to show a green upward arrow when [metric] > 0 and another rule to show a red downward arrow when [metric] < 0. You can use built-in icons or upload your own.

4. What does Labels (Dim.) do in a scorecard?

Answer: The Labels (Dim.) field sets the grouping dimension for the scorecard. For example, if you add the Region dimension, the scorecard displays one set of metric cards for each region or lists the regions within a single card. If you do not specify a dimension, the scorecard displays aggregated metrics for all data.

5. How do I add units like “ten thousand CNY” or “%” to metric values?

Answer: On the Style tab, go to the Series settings section. From the Select field drop-down list, select your metric. In the Prefix and suffix for metric value section, enter your unit (such as “ten thousand CNY” or “%”) in the Suffix box.