Theme Setup

Kedra Shield requires a theme app embed to be enabled in your Shopify theme. Without this, the app cannot protect your store.

Why This Step Is Required

Kedra Shield runs as a script embedded in your storefront theme. It evaluates each visitor and enforces your blocking rules (country, IP, VPN, bot, etc.) directly in the browser. If the app embed is not enabled, none of your protection settings will take effect.

How to Enable the App Embed

During Setup Wizard

Step 5 of the setup wizard provides a direct link to your theme editor with the app embed pre-selected. Simply:

  1. Click the Install app button — this opens your Shopify theme editor.
  2. In the theme editor, toggle Kedra Shield on under App Embeds.
  3. Click Save in the theme editor.
  4. Return to the Kedra Shield setup wizard and continue.

Manually (After Setup)

If you need to enable or re-enable the app embed at any time:

  1. Go to Shopify Admin > Online Store > Themes.
  2. Click Customize on your active theme.
  3. In the theme editor, click App embeds (in the left sidebar).
  4. Find Kedra Shield and toggle it on.
  5. Click Save.

How to Verify the App Embed Is Active

Kedra Shield automatically checks whether the app embed is enabled on your active theme.

  • If active: A green “Active” badge appears on your dashboard.
  • If inactive: An orange warning banner appears on your dashboard with a message: “Kedra Shield is not yet protecting your store.” It includes a button to activate the app embed directly.

Important: Re-Enable After Theme Changes

If you switch to a new theme or duplicate your theme, the app embed does not carry over automatically. You must re-enable Kedra Shield in the new theme’s App Embeds settings.

This is one of the most common reasons the app appears to stop working.

Next Steps