Skip to main content
Popups are drawn by a single Senderz runtime that loads on your storefront. You install it once. Every popup you publish afterwards appears without touching your theme again.

​
Before you start

  • Your store or site must be connected in Senderz. The runtime identifies your site by its address and asks Senderz which popups belong to it. A site that is not connected gets nothing back, so no popup can render. Connect it under Settings → Integrations.
  • You need at least one published popup whose targeting matches the page you are testing on.

​
Where the install instructions live

Open the popup, click Publish or schedule in the builder header, and read the Install card in the panel that opens. Senderz shows the path for your platform, so you do not have to guess which one applies to you.

​
Shopify

Do not paste a script into your Shopify theme. Shopify serves the Senderz runtime through a theme app embed. There is no snippet to copy, and editing Liquid files is not a supported install path.
1

Connect Shopify

Install Senderz from the Shopify App Store, or connect it under Settings → Integrations. See Shopify for the full connect flow.
2

Turn on the app embed

In your Shopify admin go to Online Store, then Themes, choose Customize on your published theme, open App embeds and switch on Senderz App Embed. Senderz can take you straight there: the Shopify integration card has an Open theme editor button, and the Senderz app inside Shopify admin has Enable in theme editor.
3

Save the theme

Click Save in the theme editor. Nothing is applied until you save.
4

Check it back in Senderz

Return to Senderz and click Check again. The Senderz App Embed row should change to Enabled.
Senderz checks your published theme. Enabling the embed on a draft or unpublished theme leaves the row at Not enabled yet, even though the toggle looks on in the editor you were working in.
Enabling the embed makes popups possible on the storefront. It does not publish a draft popup. Each popup still has to be published on its own.

​
WordPress and WooCommerce

One plugin covers both. It is called Senderz Marketing and it works on any WordPress site, with or without WooCommerce.
1

Install the plugin

In WordPress go to Plugins, then Add New, search for Senderz Marketing, and install and activate it. If the site cannot reach the plugin directory, use the Download the WordPress plugin link in the Senderz install card and upload it under Plugins → Add New → Upload Plugin.
2

Open the plugin screen

Open Senderz Marketing in the WordPress admin menu. With WooCommerce active it sits under Marketing. Without WooCommerce it is its own top-level menu item.
3

Connect to Senderz

On the Connection tab click Connect to Senderz, then approve the request in your Senderz workspace. The tab then reads Connected.
Site not reachable from the internet? Use Manual setup on the same screen. It asks for your Workspace ID and an API key, both of which come from Senderz under Settings → API Tokens. This is the path for staging and local sites that the approval redirect cannot reach.
Nothing leaves your site until you connect it. On a fresh install the plugin makes no outbound request of any kind, so no storefront script loads and no popup can appear before that step.
If you were running the older WooCommerce-only Senderz plugin, installing this one takes over automatically. Your settings carry across and the old plugin is deactivated. Connect from the Senderz Marketing screen so the site is linked to your workspace directly. The WooCommerce connection has two halves that are set up and reported separately: the store data connection and the plugin. See WooCommerce for both.
Once a WordPress or WooCommerce site is connected, the install card disappears from the publish panel. That is not a fault. There is nothing left to install, so Senderz stops showing the instructions.

​
Konimbo

Paste one snippet into your theme footer, under Settings and custom scripts:
Add it once. It covers every popup you publish after that. The snippet reports whatever address the visitor is browsing. If your live storefront runs on a custom domain but you connected a different address in Senderz, name the connected address explicitly:
Two popup features are unavailable on Konimbo. Cart targeting rules need a cart the site exposes to the browser, and a push subscribe block needs a service worker served from your own domain. Konimbo has neither, so the cart rules control is hidden in the builder and a push subscribe block stays inert. Everything else works normally.
See Konimbo for the store connection itself.

​
Any other platform

The install card offers the two routes that exist: install the Senderz Marketing plugin if the site runs on WordPress, or open Integrations and connect a supported store.
On-site popups run on connected Shopify and Konimbo stores, and on any WordPress site using the plugin. There is no generic paste-anywhere popup snippet for other platforms today. If your site is none of those, use an embedded form instead. It is a native form you place in your own page markup, and it works anywhere.

​
Confirm it is live

1

Check the popup's own status

A popup only serves when its status is Live and its publish window is open. Draft, Paused, Scheduled and Ended all serve nothing. A popup you scheduled is set to Live, but its chip reads Scheduled until its start time passes, and Ended once its end date does.
2

Open your storefront in a private window

A private window clears the browser memory of popups this visitor has already seen or submitted, which is the single most common reason a popup looks broken to the person who built it. Make sure the page, device and any other targeting rules actually match.
3

Watch impressions rise

The popups list shows Impressions, Conversions and CVR per popup. On Shopify, the Senderz app inside Shopify admin also shows Last storefront event, Last popup impression and Last popup conversion, which read No event yet until the first one arrives.
4

Check the runtime loaded

Open your browser’s developer console on the storefront and type window.SenderzStorefront. If it is undefined, the runtime is not on the page and the problem is the install step, not the popup.
5

Check which popups the site received

window.SenderzStorefront.activePopups lists the popups the runtime fetched for this site. An empty list means the runtime loaded and reached Senderz, but nothing live and in-window came back.
To force a popup open without waiting for its trigger:
The argument is the popup’s handle, set under Targeting and display → Display → Custom trigger, or its id. The call skips the timing rules and the show-again frequency, because you have explicitly decided this is the moment. It still honours audience, page, device, cart, schedule and the do-not-show-again-once-submitted rule, so a public handle cannot widen a targeted popup. It returns false when nothing matches or a popup is already open.

​
Troubleshooting

​
Next

Build a popup

Steps, targeting, triggers, games and rewards.

Test and read results

Pre-launch checks, A/B variations and the step funnel.

Embedded forms

A native form for sites the popup runtime does not cover.

Web push

Browser notifications, including the push opt-in block inside a popup.