> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://help.sigmacomputing.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://help.sigmacomputing.com/_mcp/server.

# Customize chart mark tooltip fields

> Customize Sigma chart mark tooltip fields to show the metrics and data attributes most relevant when you hover data points.

Chart mark tooltips appear when you hover over individual data points in a visualization. Sigma auto-selects default tooltip fields, but you can customize them to display the metrics and data attributes most relevant to your use case.

Tooltips are featured in all visualization types but are not customizable in gauge charts and Sankey diagrams.

![A bar chart with a tooltip showing the highlighted year of date is 2019 and that 9 employees were hired in that year, accounting for \$6.3 million in sales.](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/sigma.docs.buildwithfern.com/78ab532c1116e1cacae2659b4f91e0331f27490210ad6d23a5af5987a3f1ede7/assets/docs-images/b9f33f19b57a6ce2a4325739bda668bd16982a1686f635c6db1e766496fc83f3-chart-mark-tooltip.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260727%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260727T004535Z&X-Amz-Expires=604800&X-Amz-Signature=7be5ac8d422fa0ea97f7bd5de54561079a4b84e07fef796cbbc2efbc6d4a9dfc&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

This document explains how to manage default and custom tooltip fields.

## User requirements

The ability to customize chart mark tooltip fields requires the following:

* To use this feature, you must have **Can edit** or **Can explore** [access](/docs/folder-and-document-permissions) to the individual workbook.
* You must be customizing or editing the workbook.

## Show or hide default tooltip fields

By default, tooltips display fields corresponding to source columns configured in the chart properties. For example, the columns defining axes, values, stages, and mark colors. You can show or hide these fields as needed.

1. On the workbook page, select the chart element you want to modify.
2. In the editor panel, hover over the relevant column in the **X-axis** or **Y-axis** field, then click the down arrow (<img src="https://sigma-docs-screenshots.s3.us-west-2.amazonaws.com/Icons/caret.svg" alt="" />) to open the column menu.
3. Select **Show in tooltip** to change the tooltip visibility.

   * If the menu item displays a checkmark (✓), the corresponding tooltip field is currently shown. Click to hide the tooltip field.
   * If the menu item displays no checkmark, the corresponding tooltip field is currently hidden. Click to show the tooltip field.

   The change to the tooltip takes effect immediately. Hover over individual data points in the chart to view your changes.

   When you apply stacking in bar charts, you can also customize tooltips in the editor panel's **Format** > **Tooltip** section to display the variable value as a percentage of the cumulative stack. See **Customize tooltip fields and values** in [Build a bar chart](/docs/build-a-bar-chart).

## Show or hide column names in a tooltip

You can hide column names to make tooltips simpler to read, or show them again to provide additional context. By default, chart tooltips display column names for each field.

If hiding column names makes the tooltip unclear or difficult to read, column names are not hidden.

1. On the workbook page, select the chart element you want to modify.
2. In the editor panel, click **Format**, then select **Tooltip** to expand the section.
3. Turn the **Show all column names** toggle on or off to show or hide column names in the tooltip.

## Display additional tooltip fields

To enhance your chart tooltips with additional fields, add new or existing columns to the **Tooltip** property.

1. On the workbook page, select the chart element you want to modify.
2. In the editor panel, click **Tooltip**.
3. In the **Select column** field, click <img src="https://sigma-docs-screenshots.s3.us-west-2.amazonaws.com/Icons/button-add.svg" alt="" /> **Add calculation...** and configure a source column for the new tooltip field:

   * To reference or aggregate data from an existing column, search or scroll the **Select column** or **Aggregate column** list and select a column name. You can change or remove the aggregation if needed.
   * To create a new column based on a custom formula, select **Add new column**, then enter the formula or value in the toolbar.
   * To create a new column based on the number of aggregated rows, select **Row count**.

   The new tooltip field is displayed when you hover over individual data points in the chart.

## Remove custom tooltip fields

To remove fields added to tooltips, remove columns configured in the **Tooltip** property.

1. On the workbook page, select the chart element you want to modify.
2. In the editor panel, click **Tooltip**.
3. In the **Tooltip** property, hover over the column you want to remove, then click the down arrow (<img src="https://sigma-docs-screenshots.s3.us-west-2.amazonaws.com/Icons/caret.svg" alt="" />) to open the column menu.
4. To delete the column, select **Delete column** or remove it from the **Tooltip** property by clicking and dragging it back to the **Add column** list.

   The change to the tooltip takes effect immediately. Hover over individual data points in the chart to view your changes.

## Related resources

* [Customize chart background and style](/docs/customize-chart-background-and-style)
* [Customize element title](/docs/customize-element-title)
* [Format chart legend](/docs/format-chart-legend)
* [Create and format trellis charts](/docs/create-and-format-trellis-charts)
* [Display chart data labels](/docs/display-chart-data-labels)
* [Display chart reference marks](/docs/display-chart-reference-marks)
* [Add trend lines](/docs/add-trend-lines)