Skip to main content

Widgets and Dashboards: Every Number, One Screen

Learn how dashboards and widgets work, what each widget state means, and how permissions and timing affect what you see.

Overview

Widgets and Dashboards puts the numbers you'd normally find spread across separate reports onto one screen, arranged the way you want to see them. A dashboard is a saved, named layout of widgets - small cards that each show a single number, a ratio, or a compact table - built at the Facility level. This article explains how widgets and dashboards behave, what each widget state means, and what to expect around permissions and timing before you build or use one.

Key Concepts

A few terms come up throughout this article and the widget category articles it links to - understanding them now makes the rest of the feature easier to follow.

  • Widget – A fixed-purpose card on a dashboard. Each widget shows one thing - a number, a ratio with a progress bar, or a small table - for the facility you're currently in. A widget has a title but no settings: what it measures and over what period is decided by the widget itself, not by you.

  • Dashboard – A named, saved arrangement of widgets. A dashboard has a name, an optional description, and a saved position and size for every widget it contains, arranged on a 12-column grid. Dashboards live at Dashboards in the facility sidebar menu - a separate feature from the older Dashboard page.

  • Edit Mode – The mode you enter to change a dashboard's layout. Nothing is saved until you choose to save it; leaving edit mode without saving discards every change.

  • Widget Category (Tag) – Every widget belongs to one or more categories, called tags. Tags are the filter chips you see in the Add Widget drawer. There are ten:

    • Occupancy – Unit and area counts, and the revenue that inventory could produce.

    • Revenue – Money earned and billed, plus rate and competitor pricing.

    • Collections – Money received: payments by period, method, and charge type.

    • Cash & Deposits – Physical cash handling and banking.

    • Autopay – Enrollment and upcoming charges.

    • Adjustments – Money going back out: credits, refunds, and reversals.

    • Delinquency – Past-due exposure, aging, the delinquency pipeline, and auctions.

    • Coverage – Tenant protection: facility plans, private policies, premium, and proceeds.

    • Communication – Email, SMS, calls, and notifications.

    • Operations – Work to do, such as open tasks.

    • Leads – Lead volume and conversion: sources, reservations, and move-ins.

A widget can belong to up to two categories, but each widget has one primary category - the one it's filed under for reference purposes.

Filter by widget category in the Add Widget drawer

How It Works

This section covers how a widget gets its data, how current that data is, and who can see what on a dashboard.

What a Widget Shows

Every widget takes one of three shapes:

  1. A single value

  2. A value shown with a ratio and a progress bar

  3. A compact table.

A dashboard showing all three widget shapes

The shape and the period a widget covers are both fixed by the widget itself - there's no date picker or anything to configure. Add a widget, and it works. If you need a different date range than the one a widget shows, open the report the widget corresponds to instead.

Where the Numbers Come from

A widget's number matches the number you'd get from opening the equivalent report for the same period. But which period counts as "the same" depends on the widget, since not every widget uses the same date range.

Therefore, widgets fall into four groups:

  1. Today – Most widgets, including every Management-report widget, request only today's date, in the facility's time zone. Open the matching report for today, and the numbers will match. This group also includes widgets labeled MTD or YTD - MTD Revenue, YTD Revenue, YTD Collections, Revenue by Category, and Payments by Charge Type all still request today's date and read the report's own month-to-date or year-to-date column, so the match is the Management report for today, in the MTD or YTD column.

  2. Month-to-date as a range – Widgets like Payments by Method, Credits Issued, Deposits This Month, the three Refunds widgets, Failed Payments, and MTD Move-Ins request the 1st of the current month through today. Open the matching report with that same date range to see the same numbers.

  3. Next 12 months – Price Increase Prevention is the only widget that looks ahead - it requests today through the same day next year.

  4. No fixed period – Tasks, Vacant Units, Occupied Units, Total Units, Today's Collections, MTD Collections, Cash in Register, Unseen Emails, Unseen SMS, Unseen Notifications, Upcoming Autopay Charges, and the Recent widgets all show a current snapshot or a live list rather than a fixed date range. There's no period to line up here - just open the same screen to see the same thing.

Widgets aren't Real-time

A widget loads its data once, when it first appears on screen. Nothing updates automatically while you're looking at it.

  • If you leave a dashboard and come back within 5 minutes, you see the same cached numbers.

  • If you come back after 5 minutes, or reload the page, you see fresh numbers.

  • If you switch to another browser tab and back, the dashboard does not fetch new numbers.

💡Tip: If you've just done something elsewhere in QuikStor - taken a payment, closed a bank deposit - and want the dashboard to reflect it, reload the page. A widget that failed to load is the one exception: it shows its own Retry button instead of waiting for a full page reload.

Who Can See What

Access to a dashboard itself is controlled by four facility-level permissions found in the Dashboard section: Read, Create, Update, and Delete. Without permission to read dashboards, none load at all. Access to an individual widget's data is separate - it depends on the permission behind the report or list that widget draws from, and is covered in each category's article rather than here.

Unit-related widgets displaying "You don't have access to this widget."

These permissions are mirrored directly in what's visible on screen. Download is hidden without the Read permission, Edit is hidden without the Edit permission, New Dashboard is hidden without the Create permission, and the empty-dashboard Add Widget link is hidden without the Edit permission. Delete is hidden without the Delete permission.

ℹ️ Info: A dashboard belongs to the facility, not to the person who built it. Everyone with access to a facility's dashboards sees the same dashboards and the same saved layout. The one exception is which dashboard opens first - that's remembered in your browser, not on your account, so it doesn't follow you to a different computer.

Using the Feature

You can build any number of dashboards for a facility, starting from:

  • A blank layout

  • A copy of an existing dashboard

  • By importing a previously exported dashboard file.

The three ways to start a new dashboard: blank, from an existing layout, or by importing a file

Changing a dashboard's layout happens in a dedicated edit mode: you can move, resize, add, and remove widgets freely, but nothing is saved until you choose to save it.
​

Entering edit mode to rearrange or add widgets

Once a dashboard exists, you can:

  • Rename it
    ​

    Renaming a dashboard from the pencil icon next to its name
    ​

  • Switch between dashboards
    ​

    The Change Dashboard switcher, listing every available dashboard you can switch to
    ​

  • Download it - The only available download format for dashboards is JSON.
    ​

    Downloading a dashboard saves it as a JSON file
    ​

  • View it in full screen - Exit the full screen mode by pressing Esc on the keyboard.
    ​

    Viewing a dashboard in full screen
    ​

  • Delete it - Click on any of the X buttons in the drop-down menu to delete a dashboard. If you have one dashboard remaining, it cannot be deleted.
    ​

    Clicking the X button next to a dashboard opens a confirmation modal

What a Widget Can Show

Every widget renders in one of six states.

Case 1: Loading

  • What you see: A grey placeholder shaped like the widget's finished content.

  • When it happens: While the widget's data is being requested.

Widgets in the loading state, before their data appears

Case 2: Data

  • What you see: The widget's number, ratio, or table, fully populated.

  • When it happens: The normal case, once data has loaded successfully.

Widgets in their normal state, after data has loaded successfully

Case 3: Empty

  • What you see: A short sentence inside the card confirming there's nothing to show, for example "No tasks to show." or "No payments recorded today." Only the plain single-value widgets show an em dash (—) instead - the ratio widgets with a progress bar (Vacant Units, Occupied Units, Tenants on Autopay, and the like) show 0/0 and 0.0% when there's nothing to count.

  • When it happens: The request succeeded, but there's no data for the period the widget covers.

A widget in its empty state, there is no data for the period the widget covers

Case 4: Locked

  • What you see: A padlock icon with the message "You don't have access to this widget."

  • When it happens: Your role is missing at least one permission the widget needs. The widget stays on the dashboard - it isn't removed, just locked.

A widget in its locked state, permissions to read the corresponding reports are not enabled

Case 5: Error

  • What you see: A warning triangle, the message "Unable to load data", and a Retry button - on small widgets, this collapses to just the refresh icon.

  • When it happens: The request for that widget's data failed. Retry re-runs the request for that widget's data, but several widgets share one underlying request - all Management-report widgets read the same report for today, for example - so widgets that failed for the same reason recover together when you retry any one of them.

A widget in its error state, showing "Unable to load data." and a Retry button

Case 6: Unavailable

  • What you see: A ban icon with the message "This widget is no longer available." Also, the title bar of the unavailable widget is blank.

  • When it happens: The widget type saved in the layout no longer exists in the current version of the app, or is not yet enabled for the facility or company you are viewing.

A widget that's no longer available in this version of the app

Edge Cases and Conditions

A few things about Widgets & Dashboards behave in ways you wouldn't necessarily imply from using the feature alone. This section walks through each one, grouped by what they affect, so you know what to expect.

Time Zones and Periods

Widget periods aren't calculated against your own clock - they're calculated against the facility's. If a facility record has a time zone set, then every widget's period is calculated using that time zone, not your browser's. That means a manager working late from a different time zone still sees the facility's own day, not their local one. Furthermore, if the facility record has no time zone set, then the calculation falls back to your browser's time zone instead.

Widgets That aren't Meant to Match

Some widgets look like they should tell the same story and don't, and both are still correct. Revenue and Collections are the most common example: if you compare a Revenue widget to a Collections widget for the same period, then expect different numbers - Revenue reflects what was earned and billed, while Collections reflects what actually came in. Neither one is wrong; they're answering different questions.

Revenue by Category and Today's Collections showing different numbers for the same day - both are correct

Tables, Totals, and Widget Text

Not every table total works the same way, and not every number on a widget comes straight from a report field. If a table widget has a Total row, then that total is normally the report's own total and can be larger than what's visible in the table itself.

Two widgets work differently: if the widget is Payments by Charge Type, then its total is calculated from its own visible rows instead; if the widget is Occupancy Breakdown, then its Total row leaves the percentage column empty.

A small number of widgets also build part of their own text rather than displaying a field straight from a report. If a widget's wording doesn't match anything you can find in the corresponding report or export, then it's likely a value assembled specifically for the dashboard - for example, a combined list of categories or attributes - rather than a single field copied over.

Widgets That Look Ahead

Most widgets describe the past or the present, but a small number look forward instead. If a widget lists something like upcoming autopay charges or rate protection about to expire, then treat it as a queue of items to act on, not a total to reconcile against another report - these widgets are meant to flag what's coming, not summarize what already happened.

Following an upcoming autopay charge to the tenant's payment method

Dashboard Layout Behavior

A dashboard's widgets are laid out on a fixed grid, and edit mode holds every change until you explicitly save. If you view a dashboard on a narrower screen or browser window, then the layout automatically adjusts to fit - but that adjustment is never saved. If you return to a wider screen afterward, then you see the layout exactly as you last saved it, not as it appeared while adjusted. Edit mode always shows the full layout and scrolls horizontally on narrower screens instead of adjusting it.

Regarding the edit mode, if you try to navigate to another page while you have unsaved changes, then a "You have unsaved changes!" modal appears with Discard Changes and Cancel buttons - Cancel button returns you to the editor with your changes intact, while Discard Changes discards them.

The "You have unsaved changes!" modal that appears when you try to navigate to another page while in the edit mode

Furthermore, if you press Cancel in the editor header itself instead, then every change you made - moves, resizes, additions, and removals - is discarded immediately, with no warning. Save Changes also stays disabled until you've actually changed something. If you never save your changes, then nothing changes for anyone else viewing that dashboard, since a dashboard belongs to the facility rather than to you individually.

One more thing worth knowing: QuikStor doesn't prevent duplicates. If you add the same widget to a dashboard more than once, then it's allowed - there's no warning, and each copy can be sized differently from the other.

Two same widgets on the dashboard, each sized differently

Deleting and Importing Dashboards

Deleting a dashboard has one built-in safeguard, and importing one has a quiet failure mode worth knowing about before you rely on it.

If a facility has only one dashboard, then there's no way to delete it - the entire Change Dashboard switcher is hidden until a facility has more than one dashboard, and the delete control, X, lives inside that switcher.

When you do delete a dashboard, then a confirmation modal appears first: "Are you sure you want to delete "[Dashboard Name]"? This cannot be undone." If you're currently viewing the dashboard you deleted, then you're returned to the first dashboard from the Change Dashboard drop-down menu; if you delete a different one, then you stay exactly where you are.

Deleting a dashboard from the Change Dashboard switcher opens a confirmation modal

Furthermore, If you import a dashboard file that isn't valid, then the import is refused with an error message up front. If the file is valid overall but contains individual widget entries that can't be read, then those entries are skipped silently instead of blocking the import - so an imported dashboard can end up with fewer widgets than the original file described, with no error to flag it.

Importing a JSON file that is invalid displays an error message "Invalid dashboard configuration file."

FAQ

A few questions come up often about Widgets & Dashboards that are worth answering directly here.

1. Why don't my Revenue and Collections numbers match?

They're not meant to. Revenue reflects what was earned and billed, while Collections reflects what actually came in - the two track different things and will often show different numbers for the same period. See Widgets That Aren't Meant to Match section for more detail.

2. Can I change the date range a widget shows?

No. Every widget's period - such as MTD or today - is fixed by the widget itself, and there's no date picker to change it. To see a different date range for the same data, open the report the widget corresponds to.

3. Why does a widget show a padlock instead of a number?

A padlock means your role is missing at least one permission that widget needs. The widget stays on the dashboard rather than disappearing - you just can't see its data until the permission is granted.

4. Can I delete the only dashboard on a facility?

No. A facility can't be left without a dashboard, so the option to delete only appears once a facility has more than one saved dashboard.

5. Why doesn't a dashboard reflect something I just did in QuikStor?

A widget only loads its data once, when it first appears, and caches it for 5 minutes. If you've just taken a payment or closed a bank deposit elsewhere in QuikStor, reload the page to see it reflected.

Related Articles

Did this answer your question?