AnalyticsSummaryCard

Components/Charts/Analyticssummary

Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/analyticssummarycard

Overview

Copy

Analytics Summary Card component provides a concise overview of key metrics, helping users quickly understand performance insights at a glance.

Do

  • Use short labels that are easy to read.
  • Use it together with <AnalyticsLayout/> to control the layout.

Don't

  • Don't overcrowd the card with too much information.
  • Don't add ambiguous metrics, to prevent misinterpretation.

Feature examples

Add additional information to a card with footer.

Copy

Trend

The trend indicates the change of the value in percentage.

It has 2 modes:

  • Positive - colored green with arrow upwards
  • Negative - colored red with arrow downwards.

If there's no change in value, trend won't be displayed.

Copy

Action Button

Summary card can have action button inside to assist with any action needed, since it's a node.

Copy

Clickable Card

Control is a card is clickable with onClick.

Copy

Loader

Card supports loading state. <Loader/> will replace the action button when it's actively loading. If the card is clickable it won't be actionable as long as the loader is active.

Copy

Sparkline Width

Control the sparkline width by pixels with chartWidth prop.

Copy

Border

Control the appearance of the component using the border prop.

Use this property to emphasize the separation between items.

Copy

Horizontal padding

Control the padding of the card with horizontalPadding prop.

It supports three sizes:

  • large (default)
  • medium
  • small
Copy

Developer examples

Tooltip On Title

If needed, the title can have <Tooltip/> to better explain the context.

Copy

Tooltip On Value

When value appears as abbreviated number, <Tooltip/> will appear on hover.

Copy

Code

Copy

Props

NameTypeDefaultDescription
alwaysShowCTAbooleanfalseAlways show CTA button.
borderbooleanfalseAdds a border and corner radius.
chartAnimationDurationnumber300Chart animation duration.
chartColorHexstring—Sets the color of the chart.
chartData (required){ label: Date; value: number; }[]—Sets the data points of the sparkline chart. Each point has a label date, plotted on the x axis, and a numeric value, plotted on the y axis.
chartHighlightedStartingIndexnumber—Indicates the starting index of the highlighted area of the chart.
chartWidthnumber69Chart width.
ctaButtonReactNodenullCTA button React Node.
dataHookstring—Applied as data-hook HTML attribute that can be used in the tests.
disabledboolean—
footerReactNodenullFooter - node.
getChartTooltipContent(index: number) => ReactNode—Chart tooltip content.
horizontalPadding"small" | "medium" | "large"smallControls spacing size from left and right sides.
invertedTrendboolean—Invert color and arrow direction of Trend.
isLoadingbooleanfalseWhether component is loading.
isTrendVisiblebooleanfalseShow/Hide trend.
onBlur(event: FocusEvent, triggers: Triggers) => void—
onChartHover(index: number) => voidnoopFires when chart is hovered.
onClick(event: MouseEvent<HTMLDivElement, MouseEvent>) => void—Card would be clickable.
onCTAClick(event: MouseEvent<HTMLDivElement, MouseEvent>) => void—Fires when CTA button is clicked.
onFocus(event: FocusEvent, triggers: Triggers) => void—
refRefObject—
titlestring—Text for the title.
titleTooltipstring—Text for title tooltip.
trendnumber—A number to be displayed as the trend, a positive number is green with an arrow facing up and a negative number is red with an arrow facing down.
value (required)string—Sets the main value of the card, displayed as a large heading.
valueTooltipstring—Text for value tooltip.

Testkit

Import the driver matching your test environment:

Copy

Driver methods

MethodDescription
clickCTAClick on CTA
CTAExistsCheck if CTA exists
CTAExistsWithoutHoverCheck if CTA exists
isLoadingChecks whether the Analytics are loading
getValuereturns the value text
getValueTooltipTextreturns the value tooltip text
getTitlereturns the title text
getTitleTooltipTextreturns the title tooltip text
trendExistschecks if trend exists
getTrendvaluereturns the trend value
existsChecks whether the component found with the given data hook.
elementGets the component root element.
clickClicks on the component root element.
baseReturns UniDriver for the base element.

Changelog

  • 1.340.0 (2026-10-21) — maintenance release, no component-specific changes
  • 1.339.0 (2026-10-19) — maintenance release, no component-specific changes
  • 1.338.0 (2026-10-15) — maintenance release, no component-specific changes
  • 1.331.0 (2026-10-01) — maintenance release, no component-specific changes
  • 1.330.3 (2026-09-29) — maintenance release, no component-specific changes
  • 1.325.0 (2026-09-17) — maintenance release, no component-specific changes
  • 1.324.0 (2026-09-14) — maintenance release, no component-specific changes
  • 1.323.0 (2026-09-10) — maintenance release, no component-specific changes
  • 1.310.0 (2026-08-10) — maintenance release, no component-specific changes
  • 1.299.0 (2026-07-17) — breaking: reimagined Harmony redesign (#16576) — has visual changes
  • 1.292.0 (2026-06-22) — maintenance release, no component-specific changes
  • 1.291.0 (2026-06-19) — maintenance release, no component-specific changes
  • 1.277.0 (2026-05-07) — maintenance release, no component-specific changes
  • 1.273.0 (2026-04-30) — maintenance release, no component-specific changes
  • 1.272.0 (2026-04-27) — maintenance release, no component-specific changes
  • 1.266.0 (2026-04-07) — maintenance release, no component-specific changes
  • 1.260.0 (2026-03-17) — maintenance release, no component-specific changes
  • 1.258.0 (2026-02-23) — breaking: tokenizing (#15946)
  • 1.254.0 (2026-02-03) — maintenance release, no component-specific changes
  • 1.247.2 (2026-01-21) — maintenance release, no component-specific changes
  • 1.170.0 (2025-03-12) — fix: apply hover state only when the card is clickable (#14600)
  • 1.163.0 (2025-02-18) — maintenance release, no component-specific changes
  • 1.157.0 (2025-01-30) — maintenance release, no component-specific changes
  • 1.154.0 (2025-01-17) — maintenance release, no component-specific changes
  • 1.138.1 (2024-10-30) — maintenance release, no component-specific changes
  • 1.116.0 (2024-07-22) — maintenance release, no component-specific changes
  • 1.102.0 (2024-04-16) — maintenance release, no component-specific changes
  • 1.93.0 (2024-02-08) — maintenance release, no component-specific changes
  • 1.92.1 (2024-02-05) — maintenance release, no component-specific changes

Last updated: 22 October 2026

Did this help?