# X Shield documentation {#docs-app-title}

Step-by-step help for X Shield on your Shopify store: set it up, block countries, IP addresses and bots, test every rule in dry run, and fix the problems merchants ask about most. Each page uses the labels you see in the app.

Start here

## [Get Started with X Shield](/docs/x-shield/getting-started/)

Set up X Shield on Shopify: open the app once, switch on its app embed, add your first country or IP rule and test it before it reaches a real customer.

## Set up

1

- **[Get Started with X Shield](/docs/x-shield/getting-started/)** Set up X Shield on Shopify: open the app once, switch on its app embed, add your first country or IP rule and test it before it reaches a real customer.

## Blocking rules

4

- **[Block or Allow Countries in X Shield](/docs/x-shield/block-countries/)** Block or allow countries in X Shield: pick a mode, add countries or whole groups like the EU, limit rules to certain pages, and test before you enforce.
- **[Block IPs, Ranges and Networks in X Shield](/docs/x-shield/block-ip-addresses/)** Block single IP addresses, CIDR and start-end ranges, IPv6 or a whole provider by ASN in X Shield, and use Allow mode to admit only the addresses you list.
- **[Bot Protection and Verified Crawlers in X Shield](/docs/x-shield/bot-protection/)** How X Shield blocks bots while verified Googlebot and Bing get in: IP-range checks, Known bots, opt-in AI crawlers, fake Googlebots and Search Console tests.
- **[Block VPNs, Proxies and Scrapers with X Shield](/docs/x-shield/vpn-proxy-scraper-blocking/)** Turn on VPN, proxy and Tor blocking or the gentler scraper-network block in X Shield, see which networks are exempt, and avoid turning away honest shoppers.

## Test and troubleshoot

4

- **[X Shield Dry Run: Test Rules and Avoid Lockouts](/docs/x-shield/safety-and-testing/)** Use X Shield's dry run, rule tester and private access link to see who a rule would block, check your own connection, and get back in if you lock yourself out.
- **[X Shield Blocked a Real Customer? Find Out Why](/docs/x-shield/customer-blocked/)** A real customer saw X Shield's blocked page? Find their visit, see which protection fired, and fix the rule without letting in the traffic you meant to stop.
- **[X Shield Isn't Blocking? 9 Things to Check](/docs/x-shield/not-blocking/)** X Shield not blocking anyone? Check the app embed, dry run, Block vs Allow mode, bypass lists and page targeting, and what a storefront blocker can't reach.
- **[Why Blocked Visitors Show in Shopify Analytics](/docs/x-shield/blocked-visitors-in-shopify-analytics/)** Why visitors X Shield blocked can still appear in Shopify Analytics, what the difference in the numbers means, and how to read both reports side by side.

## Protect and customise

4

- **[Customise the X Shield Blocked Page](/docs/x-shield/blocked-page/)** Change what visitors blocked by X Shield see: the title, message and icon, your own logo, a redirect instead, protection alerts and the X Shield badge.
- **[Protect Text and Images with X Shield](/docs/x-shield/content-protection/)** Turn on X Shield's right-click, copy, text-selection, image, video and keyboard-shortcut protection, and understand what content protection can and can't stop.
- **[Block Spy Extensions and DevTools in X Shield](/docs/x-shield/spy-extensions/)** Block visitors running competitor spy extensions such as PPSPY and Koala Inspector, or opening developer tools, without blocking your own team by mistake.
- **[X Shield Order Protection: Flag, Tag and Hold](/docs/x-shield/order-protection/)** How X Shield checks new orders against storefront evidence, adds flagged orders' evidence to Shopify's fraud analysis, and tags or holds them on higher plans.

## Plans and reports

2

- **[X Shield Plans: Upgrade, Downgrade or Cancel](/docs/x-shield/plans/)** Compare X Shield's Free, Premium, Enterprise and Plus plans, start a trial or yearly billing, and see what changes when you upgrade, downgrade or cancel.
- **[X Shield Analytics and Email Reports](/docs/x-shield/analytics/)** Read X Shield Analytics: each blocked visitor's country, IP, network, page and the protection that fired, how long history lasts, and what the emails contain.

[X Shield: IP Country Blocker](/shopify/x-shield/)

X Shield is a Shopify app that blocks visitors by country, IP address or network, and turns away the bots, VPNs and spy extensions it detects, showing them a blocked page instead of your store. Googlebot and Bingbot, checked against their published IP ranges, still get in, and dry run lets you test every rule before it blocks anyone.

[Install free on the Shopify App Store](https://apps.shopify.com/x-shield-store-guard?utm_source=b2bgold.app&utm_medium=referral&utm_campaign=docs&utm_content=docs/x-shield&utm_term=card) [Plans and pricing](/shopify/x-shield/#pricing) [How X Shield compares with Blockify](/compare/x-shield-vs-blockify/)

Need help with X Shield? Email [support@b2bgold.app](mailto:support@b2bgold.app).