Integrate Getplainly in 30 seconds.

Copy the snippet below and paste it just before the closing </body> of your website. Replace YOUR_API_KEY with your access key from the dashboard.

index.html

<div class="my-app-widget" data-api-key="YOUR_API_KEY"></div>
<script src="https://getplainly.ai/widget.js" defer></script>

Pro Tip: Place the script before the closing </body> tag for optimal performance.

Platform Guides

WordPress

Install via the 'Insert Headers and Footers' plugin.

Framer

Go to Settings -> Custom Code -> Body Start.

Webflow

Add a 'Custom Code' embed block to your Footer.

Shopify

Edit your theme.liquid file.

Regenerating your API key

Generating a new API key will start fresh tracking statistics. Your current key will stop working and you must update the snippet on your site with the new key.

Configuration Reference

Option	Type	Description
data-api-key	string	Your access key from the dashboard (Required). Set on the container div, e.g. <div class="my-app-widget" data-api-key="YOUR_API_KEY"></div>.
class	string	Container div must use class "my-app-widget" so the script can mount the widget.

Troubleshooting

Domain Whitelisting

The widget only loads on domains you have whitelisted. If the widget does not appear or you see CORS errors, your domain may not be whitelisted.

Log in to your dashboard and go to Settings.
In the Whitelisted Domain section, add your domain (e.g. www.yoursite.com).
Save the change. The widget will only work on this domain.

Common issues

CORS error — Your domain is not whitelisted. Add it in Settings.
Widget not loading — Ensure the domain in your browser URL matches the whitelisted domain exactly (including www vs non-www).
Works in production but not locally — Add localhost or your local domain to the whitelist for development.

Last updated: February 21, 2026