Skip to content
Exobean

DimGuard operational guide

Complete guide to installing and operating DimGuard for Shopify, covering access scopes, the completeness scanner, description parsing, bulk CSV schema and safety rules, auto-guard webhooks, the rollback vault, EU PPWR audit rules, Shopify billing, GDPR webhooks and troubleshooting.

DimGuard v1.0 Shopify App Store Updated 2026-11-16 Product overview

Overview

DimGuard is a commercial software application for Shopify that governs packed dimensions across a catalog. It keeps every SKU shippable, keeps carrier rates accurate and prepares merchants for obligations under the EU Packaging and Packaging Waste Regulation (PPWR). This guide is written for store owners, operations staff and third-party logistics teams.

DimGuard works with the packedDimensions fields on product variants and never modifies prices, inventory, orders or customers.

Installation

  1. Open the Shopify App Store listing for DimGuard and choose Install.
  2. Review the requested access scopes (listed below) and approve.
  3. Choose a plan. The Free / Evaluation plan at $0 per month requires no billing approval; paid plans present a Shopify billing confirmation.
  4. DimGuard opens inside Shopify Admin and runs an initial completeness scan automatically.

Shopify access scopes explained

Scope Why it is needed
read_products Read products, variants and existing dimension fields for scanning and auditing
write_products Write validated dimension values during parsing, imports, auto-guard corrections and rollbacks
read_shop (via the Shop query) Identify the store, its currency and unit settings

DimGuard does not request customer, order, fulfilment or payment scopes. Webhook subscriptions are limited to product topics and the mandatory privacy topics described below.

Completeness scanner

The scanner is the home screen of DimGuard.

  1. Choose Run scan or wait for the nightly scheduled scan.
  2. The completeness percentage shows the share of active variants with complete, plausible packed dimensions (length, width, height and weight all present and above zero).
  3. The Missing list ranks variants by shipping impact: units sold in the last 90 days multiplied by the number of missing fields.
  4. From any row you can enter dimensions manually, send the variant to the parser, or add it to a CSV export.

Plausibility rules flag values outside configurable bounds (for example a length under 0.5 cm or a weight above 200 kg) so that typos do not pass as complete.

Description and specification parser

The parser extracts dimensions from product descriptions and specification tables.

  1. Select variants on the scanner and choose Parse descriptions.
  2. DimGuard reads the description HTML through a sanitizing parser, locates dimension expressions (for example 38 x 30 x 12 cm, 15" W × 10" D × 4" H, Weight: 1.2 kg) and normalises units to your store’s settings.
  3. Each extraction receives a confidence score. Matches above the threshold you set in Settings → Parser are written; lower-confidence matches are queued for review.
  4. A rollback snapshot is taken before any write.

Bulk CSV import and export

Export

Choose Export CSV from the scanner. The file contains one row per variant with the columns below.

Import schema

Column Required Format
variant_id Yes Shopify variant GID or numeric id
sku No Used for display only; variant_id is authoritative
length Yes Decimal
width Yes Decimal
height Yes Decimal
dimension_unit Yes cm, mm, m, in, ft
weight Yes Decimal
weight_unit Yes g, kg, oz, lb

Safety rules

  • Files are validated in full before any write. A single invalid row rejects the import and the report lists every error by line number.
  • Any cell beginning with =, +, -, @, a tab or a carriage return is treated as a potential spreadsheet formula. On export such cells are prefixed with a single quote; on import they are rejected unless the value is a plain number.
  • Imports are limited to 50,000 rows per file. Larger catalogs should be split.
  • A rollback snapshot is created automatically before the import is applied.

Auto-guard webhooks

Auto-guard subscribes to products/create and products/update webhooks so that dimension governance continues around the clock.

  • Each webhook is verified against its HMAC signature before processing.
  • When a product is created or edited, DimGuard checks the affected variants for completeness and plausibility within seconds.
  • Policy options under Settings → Auto-guard are Flag only (default), Flag and parse (attempt extraction from the description) and Flag, parse and notify (email a daily digest to the address you provide).
  • Auto-guard never deletes a value a merchant entered manually.

Rollback vault

The vault stores point-in-time snapshots of dimension state.

  • A snapshot is taken before every parser run, CSV import, auto-guard correction batch and manual bulk edit.
  • Snapshots record the variant id and all four dimension fields with their units.
  • To restore, open Rollback vault, select a snapshot and choose Restore. DimGuard rewrites the fields to the snapshot values and records the restore as a new snapshot, so a restore can itself be undone.
  • Retention is 30 days on Professional and 365 days on Enterprise Compliance. Snapshots past retention are deleted automatically.

EU PPWR compliance audit

Available on the Enterprise Compliance plan, the audit evaluates each variant’s packed dimensions against void-space thresholds and readiness indicators relevant to the EU Packaging and Packaging Waste Regulation.

  • Void space compares product dimensions (when present as a metafield or parsed value) with packed dimensions and reports the empty-space ratio against the threshold configured in Settings → PPWR (default 40%).
  • Readiness indicators flag missing packed dimensions, missing weight and implausible ratios that would prevent accurate packaging reporting.
  • Results are Pass, Warn or Missing per variant, with an evidence report that can be exported as CSV or PDF for compliance records.

DimGuard provides measurement governance to support compliance programmes. It does not constitute legal advice; merchants remain responsible for their own obligations under applicable regulation.

Plans and Shopify billing

Plan Price Catalog limit Highlights
Free / Evaluation $0 per month 250 SKUs Scanner, manual CSV export
Professional $29 per month 5,000 SKUs Parser, bulk CSV, auto-guard, 30-day vault
Enterprise Compliance $99 per month Unlimited PPWR audit, 365-day vault, priority support

All plans are billed through the Shopify Billing API and appear on your Shopify invoice. Upgrades apply immediately; downgrades take effect at the next billing cycle. The App Store listing is authoritative for current prices and limits.

Privacy and GDPR webhooks on uninstall

DimGuard implements the mandatory Shopify privacy webhooks:

  • customers/data_request: DimGuard stores no customer data and responds confirming that no customer records exist.
  • customers/redact: acknowledged; no customer data to delete.
  • shop/redact: received 48 hours after uninstall; all shop data including snapshots, audit results and the access token are deleted.

The full data governance statement is in the Exobean LLP Privacy Policy.

Troubleshooting

Symptom Likely cause Resolution
Scan shows fewer variants than expected Draft or archived products are excluded by default Change the status filter in Settings → Scanner
Parser found nothing Dimensions are in an image or in an unsupported format Enter manually or use CSV import
CSV import rejected Schema or formula-safety violation Open the error report; fix the listed rows and re-upload
Auto-guard not firing Webhook subscription missing after a reinstall Open Settings → Auto-guard and choose Re-register webhooks
Restore button disabled Snapshot is older than the plan’s retention Upgrade the plan before retention lapses or re-import from an export
PPWR audit shows Missing for all rows Product dimensions metafield not mapped Map the product dimension source in Settings → PPWR

For anything not covered here, open a request at the Exobean service desk or write to support@exobean.com with your store domain and the steps you followed. Do not include your Shopify password or API secrets in any message.