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
- Open the Shopify App Store listing for DimGuard and choose Install.
- Review the requested access scopes (listed below) and approve.
- Choose a plan. The Free / Evaluation plan at $0 per month requires no billing approval; paid plans present a Shopify billing confirmation.
- 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.
- Choose Run scan or wait for the nightly scheduled scan.
- The completeness percentage shows the share of active variants with complete, plausible packed dimensions (length, width, height and weight all present and above zero).
- The Missing list ranks variants by shipping impact: units sold in the last 90 days multiplied by the number of missing fields.
- 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.
- Select variants on the scanner and choose Parse descriptions.
- 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. - Each extraction receives a confidence score. Matches above the threshold you set in Settings → Parser are written; lower-confidence matches are queued for review.
- 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.