Troubleshooting
If your widget doesn’t work as expected, check the points below.
Most issues are related to endpoint access or data format.
Most issues are related to endpoint access or data format.
Widget shows “Configure widget”
- Make sure your API Widget key is saved in the app.
- Re-add the widget and select the configuration.
Widget is not updating
- Widget updates are scheduled by iOS WidgetKit and may be limited by system conditions.
- Low Power Mode can reduce update frequency.
- Ensure your endpoint responds quickly and is reachable.
No data or empty widget
- Verify the endpoint URL is correct and public.
- Check that valid JSON is returned.
- Ensure the response matches the W12 template format.
Formatting issues
- Use only supported color values.
- Keep keys and values within 24 characters.
- Return no more than 12 rows.