Skip to content
Stand with Ukraine flag

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.

These settings are available for all view types.

SettingDescription
TitleText shown at the top of the view
SizeTitle font size in vh units (default: 1)
Enable filter auto refreshUpdates filter values in real-time. Without this, filters only reload when Build is clicked
Enable group by amountAdds 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 seriesHides entries that have no telemetry data
Hide legendToggles the legend; when shown, Legend position (top / right / bottom / left) becomes available
Show toolbox exportAdds 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
SettingDescription
Size ContentMain content font size in vh units (default: 1)
Show labelDisplay the field label on the card
Show iconDisplay the selected icon on the card
SettingDescription
Size ContentMain content font size in vh units (default: 1)
Enable comparisonShows the percentage increase/decrease of the last value compared to the first value in the time range
Reverse comparison colorsWhen enabled, positive changes are shown in red and negative changes in green
SettingDescription
Sort orderEnable column sorting. Order way sets ascending or descending; Sort column picks which column; Select top limits output to the top N rows
Column fitControls column sizing: Fit headers (based on header text), Fit cells (based on cell content), Fit screen (fill full width)
Show total rowAdds a summary row with totals for all numeric columns
SettingDescription
Dashed lineMakes bar outlines dashed
Horizontal barDisplays bars horizontally
Stacked barStacks values on top of each other; 100% stacked normalizes all bars to the same height for proportional comparison
Tooltip typeaxis — show all series for a given X value; item — show one specific item; none — no tooltip
Show labelsDisplays values directly on bars
Show timelineAdds a time-selection slider (useful when date fields are used)
Use single Y-axisShares 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 labelRemove axis labels; X-axis position (top / bottom) is available when the X label is shown
Sort barsEnables bar sorting. Order way sets direction; Target field picks the sort field; Select top limits to top N bars
Manual Y/X axis rangeSets explicit axis boundaries: Y-axis min/max and X-axis min/max
SettingDescription
Dashed lineUses a dashed line style
Stroke typesmooth — curved connections; straight — angular; stepline — stair-step (90° transitions)
Show labelsDisplays values directly on the line
Show timelineAdds a time-selection slider
Use single Y-axisShares one Y scale; Y-axis label sets the shared axis label
Hide Y-axis label / Hide X-axis labelRemove axis labels; X-axis position available when shown
Trend lineOverlays a straight line showing the overall data trend
Manual Y/X axis rangeSets explicit axis boundaries
SettingDescription
Show labelsShows values near each sector. When enabled: Show sector name, Show sector value, Show sector percent control what appears on each label
Sort orderSorts sectors by a chosen field. Order way sets direction; Target field picks the field; Select top limits to top N sectors
SettingDescription
Tooltip typeaxis — all items at a given X value; item — one specific item; none — no tooltip
Hide Y-axis label / Hide X-axis labelRemove axis labels; X-axis position available when shown
Trend lineOverlays a straight-line trend
Manual Y/X axis rangeSets explicit axis boundaries
SettingDescription
Show labelsDisplays values inside each cell
Hide Y-axis label / Hide X-axis labelRemove axis labels; X-axis position available when shown
Sort orderSorts X-axis entries. Order way sets direction; Target field picks the field; Select top limits to top N values
SettingDescription
Rangefull — show all data; trim to current day — hide data after today; trim all — hide empty months (borderless layout)
StretchWhen enabled, the calendar fills the full view width

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 entityResult
BuildingBuilding A → 1 sensor; Building B → 0 sensors
SensorSensor_1 → linked to 1 building; Sensor_2 → unassigned
SettingDescription
Preview modeLoads a limited dataset to preview the view. Preview item count sets how many root items to load
Entities RootOverrides the root entity that Trendz selects automatically
Topology EntitiesTrendz 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 loadingLoads unaggregated data directly from ThingsBoard
Enable multi-root items loadingAllows multiple root-level entities to be processed in the same view

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.

SettingDescription
Hide filtersHides the filter section
Hide date filtersHides the date picker
Hide By OptionHides the group-by dropdown
Hide Group by AmountHides the group-by-amount dropdown (when Enable group by amount is on)
Hide AI Summary buttonHides the AI summary button
Get filter values from URLReads filter parameters from the browser URL query string
Set filter values to URLWrites selected filter values into the browser URL
Hidden filtersHides specific named filters
Row click entitiesOn clicking a chart item or table row, sends the selected entity to a ThingsBoard alias — commonly used to trigger filter updates in other widgets
SettingDescription
Hide anomalies listHides the anomalies list section
Hide anomalies chartHides the anomalies chart section
SettingDescription
PromptSelects the AI prompt used when the AI Summary button is clicked. Custom prompts can be created in the AI Prompts section
SettingDescription
AnnotationsHighlight 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
ThemeWidget color theme: Default, Light, Dark, or Custom. Custom exposes Background (widget background color) and Text (text color)
SettingDescription
Cache ReportServes the cached view report when the query plan and time range are unchanged (enabled by default)
Enable cachingEnables 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)

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

ModeDescription
MergedShows the full chart configuration; editable directly
DeltaShows only your changes relative to the default configuration

Additional actions:

ActionDescription
Cancel changesClears all unsaved modifications
Hide dataHides actual data values from chart items — useful for privacy or when sharing a configuration screenshot
SaveApplies and stores your changes

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