Create your own widget

You can use WOWidget to turn any website into a widget.
If you already have your own website, simply open it in the WOWidget app.
If you have a JSON or XML feed, you can open it using the WOWidget and use the built-in field editor to select the fields that interest you.
If you don't have a website ready, you can easily create one.

Template

    <!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="utf-8">
        <!-- Title tag will be parsed as widget name. -->
        <title>Widget name</title>
        <!-- Ensure proper and consistent scaling. -->
        <meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0">
        <!-- Prevent iOS from changing numbers to clickable links. -->
        <meta name="format-detection" content="telephone=no">
        <style>
            /* Transparent background. */
            html, body { background: transparent; }
            /* Remove the default spacing. */
            html, body { margin: 0; padding: 0; }
            /* Disable user selection. */
            * { user-select: none; }
            /* Style for dark mode. Dark mode does not affect widgets. */
            @media (prefers-color-scheme: dark) {}
        </style>
    </head>
    <body>
        Widget content.
    </body>
    </html>

Dimensions

Widget dimensions vary depending on the iPad and iPad model. See a summary of widget screen dimensions.

Meta tags

WOWidget sends the following meta tags with the initial request:

X-width: Widget width.
X-min-height: Minimum widget height.
X-max-height: Maximum widget height.
X-version: Widget version.

⚠️ JavaScript requests do not send any additional meta tags.

Security

If possible, always use an https connection.
You can use a URL with a token as authentication.
⚠️ Safari does not support basic access authentication in URL.
⚠️ WOWidget does not support states.

Distribution

You can share any widget directly from the app.
You can also programmatically create a share url.
There is also a tool for creating a share URL.

Limitations

⚠️ iOS has a bug that prevents any website from loading on the lock screen. WOWidget regularly takes snapshots of active widgets and displays them as a fallback on the lock screen.