Modules are how data is displayed in SiteStats dashboards. It is the charts, tables and metrics that are displayd in the dashboard.
A module is a visual block on your dashboard that shows data from one or more connectors. Modules control how data is queried, formatted, and presented.
If connectors are the data sources, modules are the presentation layer.
What a Module Does #
A module is responsible for:
- Selecting a connector to pull data from
- Choosing metrics and dimensions
- Applying date ranges, comparisons, and limits
- Rendering the data as a chart, table, or summary
- Updating automatically when date ranges change
Modules do not store data themselves. They request data from the selected connector when the dashboard loads and outputs it as a chart, table, KPI metric or whatever visual you decide to display it as.
Examples of Modules #
Common module types include:
- Line charts showing trends over time
- Bar charts comparing values
- Tables listing pages, queries, or products
- Summary cards showing totals or averages
The same connector can power many different modules, each with different settings.
Modules and the Builder #
Modules are created and configured using the SiteStats builder. In the builder, you typically:
- Choose a connector
- Select metrics and dimensions
- Pick a module type (chart, table, card, and more)
- Adjust options like sorting, limits, and formatting
This lets you build dashboards that combine multiple data sources into a single view.
How Connectors and Modules Work Together #
- Connectors fetch and define data
- Modules request that data and display it
You cannot create a module without an available connector, and a connector is only useful when its data is used by one or more modules.
