Website Widget Installation Guide

What the widget does

The Klikr widget renders a discreet floating control (bell, tag, or your custom icon) in the corner of your website. When a visitor selects it, they subscribe to push notifications without leaving the page and without installing an app.

Subscribers appear in your dashboard under Subscribers with source widget.
You deliver alerts from Send using the same workflow as join-link subscribers.
The embed code is a single <script> tag containing your business slug and a secure key.

Domain lock: Each Klikr account is authorised for one website domain. Register your live URL under Dashboard → Widget → Your website before publishing. The widget will not load on unregistered domains. This protects your account from unauthorised use.

Requirements: A published site served over HTTPS (e.g. https://yourshop.co.za). The widget does not run on local HTML files (file://) or unpublished drafts.

Quick start (3 steps)

1

Set your website URL

Open Dashboard → Widget. Enter your live homepage URL (e.g. https://mystore.co.za), select an icon, then click Save widget settings. Use the root domain. Both www and non-www resolve correctly when they point to the same site.

2

Copy your embed code

In the same Widget tab, click Copy embed code. Your snippet is unique and includes your slug and secret key. Do not publish it publicly or commit it to a public repository.

<script src="https://www.klikr.tech/widget/embed.js?v=20260725a"
  data-slug="your-business-slug"
  data-key="YOUR_EMBED_KEY"
  defer></script>

Replace the example above with the exact line from your dashboard. Values are populated automatically.

3

Paste before `</body>`

Insert the script as the last item before the closing </body> tag on every page where you want the control, or once in your theme footer for site-wide coverage. Refer to the platform instructions below if you are uncertain where to place it.

No website? The widget is optional. Distribute your subscribe link via WhatsApp, email, or a QR code at point of sale instead. Create account to get started.

Install by platform

Each method achieves the same outcome: load your embed code on every page. Select the guide that matches your site builder.

Plain HTML or custom-built site

Open your page file (e.g. index.html) in your editor or hosting file manager.
Locate </body> near the bottom of the file.
Paste your embed code on the line immediately above </body>.
Save and upload to your host. Visit the live HTTPS URL and confirm the control appears in the bottom-right corner.

WordPress

Option A: Plugin (recommended)

Install a footer script plugin such as WPCode, Insert Headers and Footers, or Code Snippets.
Navigate to the plugin's Footer or Body section.
Paste your full Klikr embed code and save.

Option B: Theme footer

Appearance → Theme File Editor → footer.php (or use a child theme).
Paste the embed code immediately before </body>.
Update the file. Clear any caching plugin after saving.

Shopify

Shopify admin → Online Store → Themes.
Click Edit code on your live theme.
Open layout/theme.liquid.
Locate </body> and paste your embed code directly above it.
Save. Preview your storefront on the live domain (not the theme editor preview URL if it differs).

Your Widget URL in Klikr must match your Shopify store domain (e.g. your custom domain or https://yourstore.myshopify.com).

Wix

Dashboard → Settings → Custom Code (under Advanced).
Click + Add Custom Code.
Paste your embed code.
Set placement to Body - end and apply to All pages.
Publish the site.

Squarespace

Settings → Advanced → Code Injection.
Paste your embed code into the Footer field.
Save. Allow a few minutes for changes to propagate.

Webflow

Project settings → Custom code tab.
Paste your embed code into Footer code.
Save and Publish the site to your custom domain.

Google Sites, Carrd, or other builders

Look for Embed, Custom code, HTML block, or Footer injection in site settings. Paste the full script tag. If the builder only supports iframe embeds and blocks <script>, use your subscribe link instead. The widget requires a script tag in the page footer.

Verify your installation

Confirm your website URL is saved in the dashboard and matches the domain you are visiting.
Open your live site in Chrome or Edge (desktop or Android). Safari on iPhone is supported. Visitors must tap Allow when prompted.
Locate the floating control in the bottom corner. Select it and complete the subscribe flow.
Check Dashboard → Subscribers. A new row with source widget should appear.
Optional: preview on Klikr's demo page at /widget-demo?slug=your-slug (Sign in to the dashboard first).

Send yourself a test alert from Dashboard → Send after subscribing. Delivery typically occurs within a few seconds.

Troubleshooting

Widget control does not appear: Confirm the embed code is on the published live site, not a draft. Open browser DevTools → Console and inspect [Klikr] messages. Common resolutions: paste before </body>, clear site cache, ensure data-slug and data-key are present.
"Set your website URL in the Klikr dashboard first": Navigate to Widget → enter your HTTPS homepage → Save widget settings, then reload your site.
"This widget only works on example.com": The page domain must match the URL you registered. If your shop runs on shop.example.com, set that exact host in the dashboard. Subdomains are supported when configured.
"Invalid widget key": Re-copy the embed code from the dashboard. An outdated or modified key will be rejected.
Changed website or rebuilt the site: Update Your website in the Widget tab and save. The embed code remains unchanged unless you create a new account.
Subscriber clicked Allow but no push: On iOS, subscribers may need to add your site to the home screen for reliable delivery. See iPhone & Safari.

FAQ

Will it slow down my website?: The script loads with defer, executing after your page content. It is lightweight and does not block rendering.
Can I use the widget on multiple domains?: One domain per Klikr account. For an additional domain, Contact sales or use separate subscribe links per brand.
Do I need a developer?: No. Most operators install the embed via their platform's custom code or footer setting. A developer can assist if your theme is heavily customised.
POPIA / privacy: Only retain subscribers who opt in via the widget. Remove anyone who requests erasure from Dashboard → Subscribers. See our Privacy Policy.

Website widget installation