Help & FAQ

Everything you need to know about using ParityGuard to migrate your checkout customizations.

Getting Started

1. Install the app — Add ParityGuard to your Shopify store from the Shopify App Store. You'll be asked to approve a small set of OAuth permissions (theme read access, ScriptTag read access, and web pixel deployment).

2. Connect your store — Authorize ParityGuard to access your store data. We only request the permissions needed to analyze your checkout configuration. See our Privacy Policy for full details on what we access.

3. Run your first audit — Navigate to the Dashboard and click “Start Audit” to scan your checkout for migration opportunities. The initial scan typically takes 1–3 minutes depending on your store's complexity.

4. Review results — Check the Patterns page to see detected checkout customizations. Each pattern shows the legacy implementation, the recommended Checkout Extensibility replacement, and a migration path.

5. Deploy migrations — Once you've reviewed and approved migration patterns, use the Deployment page to push configurations to your store's checkout extensions.

How It Works

ParityGuard analyzes your store's legacy checkout configurations — including ScriptTags, theme customizations, and additional scripts — and maps them to Shopify's native Checkout Extensibility features.

Pattern detection: Our audit engine reads your store's theme files, ScriptTag configurations, and pixel settings to identify checkout customizations that can be migrated to native extensions (validation, discounts, UI blocks, shipping, and payment customizations).

Classification: Detected patterns are automatically classified into one of 9 container types (parity-validator, parity-discount, parity-transformer, parity-shipper, parity-payer, parity-ui, parity-pixel, parity-variable, or non-migratable).

Deployment: Approved migration patterns are deployed as Shopify Functions and Checkout UI Extensions via metafield configuration — no code changes to your theme required.

Common Issues

My audit isn't finding any patterns

Ensure your store has active checkout customizations (ScriptTags, theme modifications, or additional scripts). If you recently installed the app, allow up to 5 minutes for the initial scan to complete. Stores with no legacy customizations will show zero patterns — this means your checkout is already using native features.

Deployment failed with an error

Check the Deployment page for error details. Common causes include: expired API tokens (re-authenticate from Settings), conflicts with other checkout apps (disable conflicting apps temporarily), or metafield size limits (large configurations are automatically sharded). Try redeploying after resolving the conflict.

Extensions aren't showing in my checkout

Verify that the extensions are enabled in your Shopify admin under Settings > Checkout. Some extensions require a published theme to be visible. Also check that your store is on a Shopify plan that supports checkout extensibility (Basic and above).

The app shows “non-migratable” for some patterns

Some legacy checkout customizations cannot be directly migrated to Checkout Extensibility due to API limitations. Non-migratable patterns are flagged with guidance on alternative approaches or manual migration steps.

I uninstalled and reinstalled — where is my data?

When you uninstall ParityGuard, we delete all merchant-specific data within 48 hours per our GDPR compliance policy. After reinstalling, you'll need to run a fresh audit. Your Shopify store data is unaffected — we only delete ParityGuard's internal records.

Data Handling

What data we access: ParityGuard reads your store's checkout configuration, theme settings, ScriptTag configurations, and extension metadata. We do not access customer personal data, payment information, or order details.

How data is used: Collected data is used solely to identify checkout migration opportunities and generate recommendations for your store. Checkout scripts may be sent to our classification service (powered by LLM) for pattern recognition — see our Privacy Policy for details on third-party data transfers.

Data retention: All merchant data is deleted within 48 hours of uninstalling the app. Anonymized operational logs may be retained for up to 90 days.

GDPR compliance: We comply with GDPR and Shopify's data protection requirements. Our web pixel respects customer consent preferences via Shopify's Customer Privacy API.

Billing

Free trial: All new installations include a 14-day free trial with full access to all features. No credit card required during the trial.

Subscription: After the trial, a monthly subscription is required to continue using ParityGuard. Billing is handled entirely through Shopify's billing system — we never see your payment details.

Managing your subscription: You can view your plan status and manage billing from the Settings page within the app, or through your Shopify admin under Apps > ParityGuard.

Cancellation: You can cancel your subscription at any time by uninstalling the app. Your data will be deleted within 48 hours per our data retention policy.

Supported Migration Types

ParityGuard detects and migrates the following checkout customization types:

Cart Validation

Migrate custom cart validation scripts to Shopify's Cart Validation Function.

Discounts

Convert legacy discount logic to native Shopify Discount Functions.

Cart Transforms

Move cart modification scripts to Cart Transform Functions.

Shipping

Migrate custom shipping logic to Delivery Customization Functions.

Payments

Convert payment customization scripts to Payment Customization Functions.

Checkout UI

Replace injected checkout UI elements with native Checkout UI Extensions.

Web Pixel

Deploy analytics tracking via Shopify's Web Pixel API for checkout event monitoring.

Contact Information

For support inquiries, please email us at support@parityguard.com.

Response time: We aim to respond to all support requests within 24 hours during business days.

When contacting support, please include your store URL and a description of the issue to help us assist you faster.

You can also find us through the Shopify App Store listing page for ParityGuard.