App Activation

Kedra Shield must be activated on your Shopify theme to protect your store. This page explains how activation works and how to verify it.

How Activation Works

Kedra Shield runs as a theme app embed — a script injected into your storefront that evaluates and blocks visitors based on your configured rules. The app checks your active theme to confirm the embed is enabled.

When you open the Kedra Shield dashboard, the app automatically verifies whether the app embed is present and enabled in your current theme.

Checking Activation Status

On your Kedra Shield dashboard, look for the activation status:

  • Active (green badge) — The app embed is enabled and your store is protected. Your blocking rules, content protection, and analytics are all running.
  • Inactive (orange badge with warning banner) — The app embed is not enabled. A banner will appear with the message: “Kedra Shield is not yet protecting your store.”

If you see the inactive warning, click the Activate app embed button to go directly to your theme editor and enable it.

Common Reasons the App Appears Inactive

1. Theme app embed was never enabled

During the setup wizard (Step 5), you are directed to enable the app embed in your theme editor. If this step was skipped, the app will not run on your storefront.

Fix: Go to Shopify Admin > Online Store > Themes > Customize > App Embeds, toggle Kedra Shield on, and click Save.

2. You switched themes

The app embed setting is tied to the specific theme it was enabled on. If you switch to a different theme, publish a new theme, or duplicate your theme, the app embed must be re-enabled on the new active theme.

Fix: Re-enable the app embed on your new active theme.

3. The app embed was accidentally disabled

If someone edited your theme and turned off the app embed, protection will stop.

Fix: Re-enable the app embed in your theme’s App Embeds settings.

How to Test That Blocking Is Working

  1. Check the Analytics page — Look for entries in the Blocked IPs tab. If visitors are being blocked, they will appear here.
  2. Use a VPN — Connect to a VPN from a blocked country and visit your store. You should see the block page.
  3. Use incognito mode — Your regular browser may have cached pages from before blocking was enabled. Always test in a private/incognito window.
  4. Check the dashboard — Confirm the green “Active” badge is displayed.

Note: Blocked visitors may still appear in Shopify Analytics and Google Analytics. This is expected behavior — these tools record the visit attempt before the app has a chance to block the visitor. See the Troubleshooting section for a full explanation.

Next Steps