Configure Product Attributes for Paazl Checkout

The Paazl Checkout Widget uses Magento product attributes to send shipment-relevant data (dimensions, weight, country of manufacture, HS code, processing days, delivery matrix) to Paazl. The module does not create these attributes for you — it only lets you map already-existing catalog attributes to Paazl's expected fields.

If the dropdowns under Stores → Configuration → Sales → Paazl → Product Attributes or Product Sizes show only "None", it means the matching attributes don't yet exist on your catalog. Follow the steps below to add them.

1. Which attributes the module expects

Note: Weight uses Magento's built-in weight attribute — no setup needed.

Note: "Country of Manufacture" and "HS Code" can also be set as a static value in Paazl config if you don't want a per-product attribute.

2. Create the attributes in Magento

For each attribute you need:

1. Go to Stores → Attributes → Product → Add New Attribute.
2. Fill in:
   • Default Label — e.g. "Length"
   • Catalog Input Type — Text Field for decimals/text, Integer for processing days
   • Values Required — usually No
3. Open the Advanced Attribute Properties tab and set:
   • Attribute Code — e.g. length (must match what you'll select in Paazl config)
   • Scope — Global (recommended)
4. Open the Storefront Properties tab and set:
   • Used in Product Listing — No
   • Visible on Catalog Pages on Storefront — No (these are shipping-only)
5. Click Save Attribute.

Repeat for every attribute you need from the table above.

3. Add the attributes to your Attribute Set

1. Go to Stores → Attributes → Attribute Set.
2. Open the attribute set used by your products (usually Default).
3. Drag the new attributes from the Unassigned Attributes column into a group on the left (e.g. "Paazl" or "Shipping").
4. Click Save.

If you use multiple attribute sets, repeat for each one.

4. Map them in Paazl config

1. Go to Stores → Configuration → Sales → Paazl → Product Attributes / Product Sizes.
2. Each dropdown should now list your new attributes — select the matching one for each field.
3. Set Dimensions Metric under Product Sizes (cm / mm / m / in) so Paazl receives correctly converted values.
4. Click Save Config, then flush the configuration cache: bin/magento cache:flush config.

5. Populate the values on products

1. Open any product in Catalog → Products.
2. Fill in length, width, height, weight, HS code, etc. Save.
3. Repeat for all products that ship via Paazl (a CSV import via System → Data Transfer → Import is the fastest path for a large catalog).

Products without these values will simply not pass that attribute to Paazl — the module sends only the fields that are filled in.

6. Verify

1. Open the storefront, add a product to cart, proceed to checkout.
2. Watch the network tab for the Paazl shipping options request — the payload should include length, width, height, weight, etc. for each item.
3. If you have access to Paazl's backend, confirm the order shows the expected dimensions and HS code.

Troubleshooting

• Dropdowns still show only "None": the attribute isn't marked is_visible = 1. Edit the attribute and re-save — or recreate it.
• Dropdowns show the attribute but Paazl still gets no value: the attribute isn't assigned to the product's attribute set, or the product has no value.
• Wrong unit on Paazl side (e.g. 100× too large): check Product Sizes → Dimensions Metric. Magento stores raw numbers, Paazl expects centimetres — the metric setting controls conversion.
• International shipments rejected: HS Code or Country of Manufacture isn't set. Use the Static option as a fallback if you don't want to fill it per product.