Skip to main content

Widgets Overview

Widgets are the building blocks of dashboards in IoTBreeze, providing various ways to visualize, interact with and monitor your IoT data. Each widget type is designed for specific use cases and data presentation needs.

Widget Categories​

Data Display Widgets​

These widgets focus on presenting data in tabular or structured formats, ideal for detailed data analysis and property monitoring.

Status & State Widgets​

Monitor the current state and status of your Things with visual indicators and comparison tools.

Chart Widgets​

Visualize time-series data, trends and patterns with various chart types.

Interactive Widgets​

Execute actions and monitor events directly from your dashboard.

  • Events - Event monitoring and management
  • Action - Thing action execution

Visual & Media Widgets​

Enhance dashboards with images, overlays and custom drawings.

  • Image - Static image display
  • Canvas - Free-form drawing

Layout & Navigation Widgets​

Organize dashboard content with structural and informational elements.

External Content Widgets​

Integrate external content and geographic visualizations.

Adding Widgets to Dashboards​

To add a widget to your dashboard:

  1. Enable editing mode by clicking the lock button
  2. Click the "+" button in the toolbar
  3. Select the desired widget type from the dialog
  4. Configure the widget properties
  5. Position and resize the widget as needed

For detailed information on dashboard editing, see Dashboards.

Widget Configuration​

Each widget type has its own configuration options. Detailed configuration options are documented in each widget's individual page.

Common Fields​

Many widgets share these display options, though not all widgets include every field. See each widget's page for its exact configuration.

FieldRequiredDescription
Transparent❌ NoRemove the widget background for a clean look
Background Color❌ NoCustom background color for the widget
Border color❌ NoCustom border color for the widget
Compact number❌ NoDisplay large numbers in compact format (e.g., 1.23K)
Override❌ NoUse widget-specific time settings instead of dashboard defaults

Widget-Specific Fields​

Beyond the common fields, widgets may include:

  • Title - Display name for the widget
  • Thing - Selection of Things to display data from
  • Measures / Properties - Data source configuration
  • Timeframe - Time range for data display (timeseries widgets)
  • Aggregation - Data aggregation method
  • Visualization Settings - Chart types, colors and display options

Best Practices​

Widget Selection​

  • Choose widgets that best represent your data type
  • Use chart widgets for trends and patterns
  • Use state widgets for current values and status
  • Combine multiple widgets for comprehensive views

Dashboard Organization​

  • Group related widgets in containers
  • Use titles to create clear sections
  • Maintain consistent widget sizes for visual harmony
  • Place most important widgets in prominent positions

Performance Considerations​

  • Limit the number of widgets per dashboard (recommended: 10-15)
  • Use appropriate time windows to reduce data loading
  • Consider widget refresh rates for real-time data
  • Test dashboard performance on target devices

What's Next?​

Explore individual widget documentation for detailed configuration options and use cases, or return to Dashboards to learn more about dashboard management.