WidgetDash Support

There are two easy ways to connect the WidgetDash app to your server:

1. QR Code (recommended): Open the WidgetDash app, tap Scan QR Code, and point your camera at the QR code in your dashboard. This fills in your server URL and API key for you and gives the iPhone full access, so only scan it on your own phone.
2. Manual setup: In the app's Configuration section, enter the Server URL (https://api.widgetdash.app) and your API Key, then tap Save. Your keys are on the dashboard. Use the write key; a read key connects view-only.

You don't need an account to start: the app creates a free one the first time you open it.

As soon as you are connected, the app starts syncing your widget data.

Home Screen widgets:

1. Touch and hold an empty spot on your Home Screen until the apps start to jiggle.
2. Tap the + button in the top-left corner.
3. Search for WidgetDash in the widget gallery.
4. Pick the widget size you like and tap Add Widget.

By default, small shows your first source, medium shows up to 5, and large shows as many as fit. To pick what a widget shows, long-press it and tap Edit Widget. Choose a Source, then add more under More Sources (Medium, Large and the rectangular Lock Screen widget); they show in the order you pick. All Sources goes back to the default. Several sources need iOS app 1.7 or later. To change the order, tap Edit in the app: move sources up or down, or tap the eye to hide one from this iPhone's widgets.

Lock Screen widgets (rectangular or round):

1. Touch and hold your Lock Screen, then tap Customize.
2. Select the Lock Screen layout.
3. Tap the widget area above or below the clock.
4. Search for WidgetDash and pick a widget to add.
5. To choose its source, tap the widget while you're customizing and pick a Source.
6. Tap Done to save.

If your widgets are not showing the latest data, try these steps in order:

1. Check your API key: Open the WidgetDash app and confirm your API key is correct. You can find your current key in your dashboard at widgetdash.app.
2. Double-check the server URL: Make sure the server URL in the app matches the one in your account dashboard. Even a trailing slash or a small typo can block the connection.
3. Check your internet connection: Widgets need an active connection to fetch fresh data. Try loading a webpage in Safari to confirm you are online.
4. Force a refresh: Open the WidgetDash app and tap the refresh button. Widgets ask iOS for an update about every 5 minutes, and iOS sometimes delays them to save battery, so your widget should catch up within a few minutes.
5. Restart the app: If it still will not update, force-quit the WidgetDash app and open it again.

If none of these steps fix it, please reach out using the contact form below and we will help.

WidgetDash gives you a REST API, so you can push any number from any service, script, or automation tool. Just send a simple HTTP request with your API key and it lands on your widget.

Start with the step-by-step guide. For the full list of endpoints, request formats, and examples, see the API reference.

In the iPhone app, scroll to Account and tap Delete Account. On the web, sign in, open Account and choose Delete account.

Deletion is immediate: your sources and data are deleted, and a Pro subscription is cancelled. If you can't sign in, use the form below and we'll delete it for you. See the privacy policy for details.