Skip to content

Cookie preferences

We use cookies for our own analytics and to see how our campaigns perform. We never sell your data. Necessary cookies keep the site working and cannot be switched off. See our Cookie Policy for details.

Security, load balancing and remembering your cookie choice.

Show us which pages people read and how they find the site, so we can improve it (Google Analytics).

Show us which of our ad campaigns bring visitors to the site (Google Ads).
© 2026 The ThingsBoard Authors
 
Try for free

ThingsBoard Cloud

Choose your data region

Your data stays in the region you choose, for residency and compliance. No credit card required.

North America Data stored in North America Europe Data stored in the European Union

Rather run it yourself? Install on your own servers

View Settings

The View Settings panel is opened via the settings icon in the bottom-right corner of each view. It controls how the visualization is displayed, how data is queried, and how the view behaves when embedded in a ThingsBoard dashboard.

General settings

Section titled “General settings”

These settings are available for all view types.

Setting Description
Title Text shown at the top of the view
Size Title font size in vh units (default: 1)
Enable filter auto refresh Updates filter values in real-time. Without this, filters only reload when Build is clicked
Enable group by amount Adds a group by amount dropdown next to the time-range picker. The value multiplies the Group By unit so several units merge into one bucket, like grouping hourly buckets into 6-hour windows. Works with RAW Date aggregation only. See Group by time
Remove empty series Hides entries that have no telemetry data
Hide legend Toggles the legend; when shown, Legend position (top / right / bottom / left) becomes available
Show toolbox export Adds export options (CSV, XLS, XLSX). When enabled: Show date range and filters includes filter context in exports; Filter to show in XLS selects which filters to include; Rotate export result flips rows and columns

Card view

Section titled “Card view”
Setting Description
Size Content Main content font size in vh units (default: 1)
Show label Display the field label on the card
Show icon Display the selected icon on the card

Card with Line view

Section titled “Card with Line view”
Setting Description
Size Content Main content font size in vh units (default: 1)
Enable comparison Shows the percentage increase/decrease of the last value compared to the first value in the time range
Reverse comparison colors When enabled, positive changes are shown in red and negative changes in green

Table view

Section titled “Table view”
Setting Description
Sort order Enable column sorting. Order way sets ascending or descending; Sort column picks which column; Select top limits output to the top N rows
Column fit Controls column sizing: Fit headers (based on header text), Fit cells (based on cell content), Fit screen (fill full width)
Show total row Adds a summary row with totals for all numeric columns

Bar view

Section titled “Bar view”
Setting Description
Dashed line Makes bar outlines dashed
Horizontal bar Displays bars horizontally
Stacked bar Stacks values on top of each other; 100% stacked normalizes all bars to the same height for proportional comparison
Tooltip type axis — show all series for a given X value; item — show one specific item; none — no tooltip
Show labels Displays values directly on bars
Show timeline Adds a time-selection slider (useful when date fields are used)
Use single Y-axis Shares one Y scale when all series use the same units; Y-axis label sets the shared axis label
Hide Y-axis label / Hide X-axis label Remove axis labels; X-axis position (top / bottom) is available when the X label is shown
Sort bars Enables bar sorting. Order way sets direction; Target field picks the sort field; Select top limits to top N bars
Manual Y/X axis range Sets explicit axis boundaries: Y-axis min/max and X-axis min/max

Line view

Section titled “Line view”
Setting Description
Dashed line Uses a dashed line style
Stroke type smooth — curved connections; straight — angular; stepline — stair-step (90° transitions)
Show labels Displays values directly on the line
Show timeline Adds a time-selection slider
Use single Y-axis Shares one Y scale; Y-axis label sets the shared axis label
Hide Y-axis label / Hide X-axis label Remove axis labels; X-axis position available when shown
Trend line Overlays a straight line showing the overall data trend
Manual Y/X axis range Sets explicit axis boundaries

Pie view

Section titled “Pie view”
Setting Description
Show labels Shows values near each sector. When enabled: Show sector name, Show sector value, Show sector percent control what appears on each label
Sort order Sorts sectors by a chosen field. Order way sets direction; Target field picks the field; Select top limits to top N sectors

Scatter Plot view

Section titled “Scatter Plot view”
Setting Description
Tooltip type axis — all items at a given X value; item — one specific item; none — no tooltip
Hide Y-axis label / Hide X-axis label Remove axis labels; X-axis position available when shown
Trend line Overlays a straight-line trend
Manual Y/X axis range Sets explicit axis boundaries

Heat Map view

Section titled “Heat Map view”
Setting Description
Show labels Displays values inside each cell
Hide Y-axis label / Hide X-axis label Remove axis labels; X-axis position available when shown
Sort order Sorts X-axis entries. Order way sets direction; Target field picks the field; Select top limits to top N values

Heat Map Calendar view

Section titled “Heat Map Calendar view”
Setting Description
Range full — show all data; trim to current day — hide data after today; trim all — hide empty months (borderless layout)
Stretch When enabled, the calendar fills the full view width

Query params

Section titled “Query params”

These settings control how Trendz builds the data query for the view.

To illustrate why these matter, consider two buildings and two sensors in ThingsBoard:

  Building A ──contains──▶ Sensor_1
  Building B  (no sensors)
  Sensor_2    (not assigned to any building)

The result changes based on which entity is used as the root:

Root entity Result
Building Building A → 1 sensor; Building B → 0 sensors
Sensor Sensor_1 → linked to 1 building; Sensor_2 → unassigned
Setting Description
Preview mode Loads a limited dataset to preview the view. Preview item count sets how many root items to load
Entities Root Overrides the root entity that Trendz selects automatically
Topology Entities Trendz finds the shortest path between all entities in the Topology Graph to build its query plan. For complex graphs where the shortest path is not optimal, manually specify which entities to include
Raw data loading Loads unaggregated data directly from ThingsBoard
Enable multi-root items loading Allows multiple root-level entities to be processed in the same view

View Mode fields

Section titled “View Mode fields”

These settings apply when the view is displayed in full-screen mode or embedded as a Trendz widget in a ThingsBoard dashboard. See Widget actions for usage details.

Setting Description
Hide filters Hides the filter section
Hide date filters Hides the date picker
Hide By Option Hides the group-by dropdown
Hide Group by Amount Hides the group-by-amount dropdown (when Enable group by amount is on)
Hide AI Summary button Hides the AI summary button
Get filter values from URL Reads filter parameters from the browser URL query string
Set filter values to URL Writes selected filter values into the browser URL
Hidden filters Hides specific named filters
Row click entities On clicking a chart item or table row, sends the selected entity to a ThingsBoard alias — commonly used to trigger filter updates in other widgets

Anomalies view

Section titled “Anomalies view”
Setting Description
Hide anomalies list Hides the anomalies list section
Hide anomalies chart Hides the anomalies chart section

AI Assistant

Section titled “AI Assistant”
Setting Description
Prompt Selects the AI prompt used when the AI Summary button is clicked. Custom prompts can be created in the AI Prompts section

Colors

Section titled “Colors”
Setting Description
Annotations Highlight background ranges on the chart to indicate value levels. Each annotation has From Y (start value), To Y (end value), and Color. Available for Bar and Line views only
Theme Widget color theme: Default, Light, Dark, or Custom. Custom exposes Background (widget background color) and Text (text color)

Cache

Section titled “Cache”
Setting Description
Cache Report Serves the cached view report when the query plan and time range are unchanged (enabled by default)
Enable caching Enables long-term metrics cache. Caching Time Unit sets the data aggregation level. Auto Refresh preloads the cache on a schedule: Every sets the interval value; Time Unit sets the unit (e.g. hour, day)

Chart Option

Section titled “Chart Option”

Fine-tune all chart settings using JSON. Two editing modes are available:

Mode Description
Merged Shows the full chart configuration; editable directly
Delta Shows only your changes relative to the default configuration

Additional actions:

Action Description
Cancel changes Clears all unsaved modifications
Hide data Hides actual data values from chart items — useful for privacy or when sharing a configuration screenshot
Save Applies and stores your changes

The right panel shows a live preview of how the JSON changes affect the chart.

© 2026 The ThingsBoard Authors ·