Table of Contents

  1. How to create the Plausible Analytics iOS widget:

Plausible Analytics iOS Widget for Self-hosted Websites

Here’s a script to create your own Plausible Analytics iOS widget for self-hosted websites. It’s a simple and intuitive way to keep track of your website’s daily performance on the go. With this 1:1 block widget (see screenshot for reference), you can access key daily metrics directly from your iPhone or iPad’s home or lock screens, such as real-time data, page views, unique visitors, top referrer, and top country. 

Purchase the code snippet from digital store


① According to the instructions (see below), = your primary domain and = the subdomain where you’ve installed Plausible. You’ve to replace both accordingly.

② The widget size is 1×1. That’s a small, square size widget.

③ It is only tested on self-hosted Plausible instances.

How to create the Plausible Analytics iOS widget:

Step 1: Generate an API key from

Step 2: Install Scriptable on your iPhone/iPad. Scriptable is a free automation tool that enables you to write scripts that integrate with the native features of iOS/iPadOS.

Step 3: Get plausible-analytics-widget.js. The script contains helper texts as comments. Paste the content of the script to scriptable, and start editing. Alternatively, paste the script to a code editor on your PC/macOS, make the edits, and send the final version to your iPhone/iPad.

Step 4: Edit the plausible-analytics-widget.js

① In line 6, add your baseURL, 

② In line 9, add your API key.

③ In line 12, add your siteID, which is

④ In line 114, replace “Example Daily” with your brand or domain name.

⑤ In line 120, add a URL to visit after tapping on the widget.

Step 5: Add the final version of the script to scriptable, and set it as the home-screen or lock-screen Plausible Analytics widget in iOS.

If you need further assistance, reach out to [email protected]. I also make Python scripts for Plausible. If you need a hook for a specific app, I can help.

Written by MighilMighil is an indie musician and tinkerer with diverse work experience in technology and writing. He has had the privilege of serving in various capacities, encompassing generalist and specialist roles. He is currently based in Chengdu.


Opt-in to receive long-form essays in your inbox. Unsubscribe anytime. Follow me on 𝕏 if you like.

Powered by DigitalOcean, BunnyCDN, WordPress.