Some products can only travel if the outside of the package carries the Limited Quantity (LQ) black diamond — a regulatory hazard mark that applies to goods such as aerosols, small compressed gas capsules and certain flammable liquids.
Hazmat returns adds the diamond to the return label automatically. When a customer returns a product you have identified as hazardous, they receive a multi-page PDF: the return label on the first page, and the diamond on its own page ready to print and attach to the parcel.
How it works
You identify hazardous products using product tags, and upload the diamond against each tag you use.
When a customer creates a return that includes an item carrying one of those tags, Swap delivers the return label as a multi-page PDF instead of a single page. The label itself is unchanged. The diamond is added on a separate page, so the customer prints both together and attaches it to the outside of the parcel.
Returns that contain no tagged items are unaffected and produce a single-page label as usual.
Before you start
You supply the diamond image. Swap does not provide it. Use a copy of the LQ black diamond that meets the regulations applying to your goods.
Tag the relevant products in Shopify. Matching is by product tag, so every product that needs the diamond must carry the tag you configure.
Confirm your carrier accepts the goods. Enabling this setting produces the paperwork; it does not grant carrier permission to move hazardous goods. Approval for the specific classification and service is arranged with the carrier.
Setting up hazmat returns
Go to Returns → Settings → Returns and find the Hazmat returns panel.
Turn on Allow hazmat returns.
Select + to add a rule.
Enter the Product tag that identifies the products the diamond applies to.
Select Upload label and choose your image.
Repeat for each tag that needs its own mark, then save.
Add a rule for each product tag you use. Each rule pairs one tag with one uploaded image.
Preparing your diamond image
The image is printed at a fixed size of 100mm square. It is not scaled to fit the image inside it, so any surrounding whitespace in the file reduces the size of the printed diamond.
Upload a tightly cropped square image with the diamond filling the frame. A file with generous margins produces a diamond smaller than the regulatory minimum, which makes the parcel non-compliant even though the diamond is present.
What the customer receives
The customer downloads a single multi-page PDF from the returns portal.
Page one is the return shipping label, exactly as it appears for any other return.
The following page carries the diamond at its regulatory size.
The customer prints both pages, attaches the label as normal, and attaches the diamond to the outside of the parcel.
Things to know
Only the diamond image is added. No hazard classification code or UN number is written to the label or sent to the carrier, and no wording is added to the shipment reference. Where a lane requires declaration text — for example "Not Restricted per A98" on air shipments — arrange that with your carrier directly.
The LQ black diamond is the only mark this fully supports. You can upload any hazmat mark and it will print on the second page, but other hazard classes normally require UN codes or additional data to be sent to the carrier when the label is generated, and that is not included. Do not rely on this setting for anything other than the LQ black diamond without first confirming what your carrier requires.
Every destination is treated the same. A tagged item produces the extra page wherever the return is travelling. The diamond is never applied or withheld by country, so check that the image you upload is valid for every lane your returns use.
The 100mm size is fixed and applies to every rule.
Tags are matched per item, not per return. A return containing one tagged item and several untagged items still produces the multi-page PDF.