Documentation and support

Set up your first check and understand the result

Start with one shipping rule that matters. If the check cannot finish, open the result details. They show whether a shipping option or price changed, or why the check stopped.

1

Choose the recommended check

Open WooCommerce → Shipping Contract Guard and choose the first suggested shipping rule. The plugin preselects a simple shippable product when it can.

2

Review the carts

Check the made-up addresses, exact shipping options, and prices. You choose the correct result; the plugin does not decide for you.

3

Save and run

You will see “Everything works,” “Problem found,” or “Could not verify.” The last result means the check was unsafe, ambiguous, unsupported, or incomplete.

Result guide

What to do next

On a small screen, swipe sideways to see all columns.

ResultMeaningNext step
Everything worksEach shipping option and price matched the result you saved.Keep the check and rerun it after a plugin, theme, product, or shipping setting changes.
Problem foundAn expected shipping option is missing, an unexpected option appears, or a price changed.Compare the saved and current results, then inspect the suggested setting first.
Could not verifyThe check was unsafe, unsupported, unclear, or incomplete. This never counts as working.Open the result details and follow the reason shown. Rerun the same test cart only after you resolve that reason.
Reasons a check could not verify

On a small screen, swipe sideways to see all columns.

ReasonMeaningNext step
Unsupported shipping optionThe plugin cannot safely test that shipping option automatically.Run it manually, or review whether the check may contact the provider before you save the exact WooCommerce result.
Incomplete calculationWooCommerce or the shipping option stopped before returning a full result.Check WooCommerce logs and whether the carrier or provider is available, then rerun the same test cart.
Unsafe store changeThe test tried to create or change a store record.Stop running that check, download the support file, and contact support.

Compatibility

Versions we actually test

Version 1.9.4 requires WordPress 6.5, WooCommerce 8.2, and PHP 8.1 or later. The table shows the oldest supported versions and the newest versions that release testing covers. A third-party shipping extension is not automatically supported just because it is installed.

On a small screen, swipe sideways to see all columns.

AreaVersions supported or testedImportant limit
WordPress6.5 or later; release tests used 7.1Each new version needs a fresh release check
WooCommerce8.2 or later; release tests used 11.0.1We test classic checkout on both the oldest and newest listed versions
PHP8.1 or laterCode checks and tests for the oldest supported setup use PHP 8.1
Checkout blocksTested with WooCommerce 11.0.1We exclude WooCommerce 8.2 block rendering because it creates a draft order
High-Performance Order Storage (HPOS)SupportedThe plugin creates no order and does not depend on WooCommerce order storage
Shipping optionsWooCommerce Flat Rate, Free Shipping, and Local Pickup; other options WooCommerce returns after you review the testLive carrier availability and private extension settings are outside the check

Magento Open Source 1.1.0 preview

Install Local and see what Operator will add later

Read the Magento 1.1.0 preview guide before installation. It explains Composer and source installation, reviewing and approving a test, Local and Operator commands, report permissions, temporary-quote cleanup, history, deletion, connecting Operator later, schedules, disconnecting, and troubleshooting.

The preview passes Magento Open Source 2.4.7-p10 with PHP 8.2 or 8.3, 2.4.8-p5 with PHP 8.3 or 8.4, and 2.4.9 with PHP 8.4 or 8.5. It supports Magento’s built-in Flat Rate, Free Shipping, and Table Rate methods only when they have not been replaced or changed. Adobe Commerce and other carriers are not included in the 1.1.0 compatibility claim. Operator is not for sale yet.

Before asking for help

  • Note the Magento, PHP, and extension versions
  • Copy the reason shown with the result
  • Run temporary-quote cleanup
  • Export the local support report if you have permission
  • Never send connection codes, signing keys, customer data, or passwords

What support covers

We review free Local requests on Belgian business days, without a guaranteed response time. We can explain installation, supported tests, result messages, cleanup, local data controls, and how to reconnect Operator safely later. We do not operate the store, repair checkout, bypass billing, or support an unlisted carrier.

Current release

What changed in 1.9.4

  • Calls first-check examples test carts until you review and save them.
  • Labels passing history results as working.
  • Calls the cases affected by a configuration change saved test carts.
  • Changes no shipping calculation, stored data, information sent to Operator, billing rule, or price.

Before publication, version 1.9.4 passed automated WordPress, code-quality, runtime, compatibility, release, and local browser checks. No issues were recorded in those checks.

Before reporting a problem
  • Update to version 1.9.4
  • Record the WordPress, WooCommerce, and PHP versions
  • Repeat the same test cart once
  • Download the support file from Shipping Contract Guard → Settings
  • Remove customer data, passwords, and secrets from every note

Support file

Share useful details without sharing store content

The downloadable support file includes product versions, whether the database and automatic checks are working, whether Operator is connected, and totals from the latest run. It leaves out products, product codes, saved checks, addresses, customers, orders, payment details, service identifiers, and passwords.

Optional WooCommerce logging is off by default. When enabled, it records only the Shipping Contract Guard admin action and whether it succeeded. Turn it off again after reproducing the issue.

Support expectations

What happens after you ask for help

Email hello@shippingcontractguard.com with the support file, the result shown on screen, and the steps you took. Do not send database exports, customer addresses, order data, service keys, carrier passwords, or payment information.

Local

We review requests on Belgian business days. The free plan has no guaranteed response time.

Operator

We review messages from stores with an active Operator subscription first. Operator monitors checks; it does not repair your store or provide emergency support.