Skip to content
Visit ShipperHQ.com
  • There are no suggestions because the search field is empty.

How to Assign ShipperHQ Attributes in Magento 2

Connect your products to Shipping Groups, Origins, boxes, and freight settings so every item gets the right shipping rates

Table of Contents

Product attributes tell ShipperHQ how each item in your Magento 2 or Adobe Commerce catalog ships: which Shipping Group it belongs to, which Origin it ships from, which boxes it can pack into, and whether it needs freight. With attributes in place, your shipping rules and carrier settings apply to exactly the products you intend.

For example, you might place oversized patio furniture in a freight Shipping Group, assign a warehouse Origin to products you drop-ship, or limit fragile glassware to a padded box. Each of these starts with an attribute value on the product in your Magento admin.

How It Works

The Shipping Groups, Origins, boxes, and Pickup Locations you create in ShipperHQ become attribute values in Magento when you synchronize. You then select those values on each product, either one product at a time or in bulk.

Most ShipperHQ attributes are added to your attribute sets automatically when you install the extension. A few less common attributes need to be added to your attribute sets manually before they appear on your products.

Requirements

Assigning Attributes to a Product

ShipperHQ attributes are grouped into panels on the product edit page. Once you save the product, ShipperHQ uses the assigned values the next time rates are requested for that item.

  1. Go to Catalog › Products and open the product you want to update.
  2. Expand the Shipping panel to assign a Shipping Group, Origin, or Pickup Location.

    5_pound_dumbell___Products___Inventory___Products___Magento_Admin
  3. Expand the Dimensional Shipping panel to assign boxes, packing rules, or product dimensions.
  4. Expand the Freight Shipping panel to set freight attributes, such as freight class.
  5. Save the product.

Updating Attributes for Multiple Products

Magento's Update Attributes tool applies the same Shipping Group, Origin, or other attribute value to many products at once. Go to Catalog › Products, select the products you want to change, then choose Update Attributes from the Actions menu. See Adobe's Bulk updates for product attributes documentation for details.

Adding Attributes to an Attribute Set

An attribute appears on your products only when it belongs to the attribute set those products use. Some ShipperHQ attributes, such as the master packing box attribute (shipperhq_master_boxes), are not added to your attribute sets on install. Once you add one to an attribute set, it appears on every product that uses that set.

  1. Go to Stores › Attributes › Attribute Set and open the attribute set your products use.
  2. Drag the attribute from the Unassigned Attributes list into the matching group, such as Dimensional Shipping for box attributes.
  3. Save the attribute set.
  4. Repeat for each attribute set your products use.

For more on how attribute sets work, see Adobe's Attribute sets documentation.

Troubleshooting

An Attribute Doesn't Appear on the Product

The attribute most likely isn't in the product's attribute set. Follow the steps in Adding Attributes to an Attribute Set.

If the attribute isn't listed under Unassigned Attributes either, go to Stores › Attributes › Product and search for it. If it's missing there, the extension's database setup may not have completed during installation. See How Do I Resolve a Failed SQL Run in Magento.

A Shipping Group, Origin, or Box Is Missing From the Options

New or updated values from ShipperHQ appear in Magento after you synchronize. Run the synchronization, then refresh your caches under System › Cache Management.

A box appears as an option only when Can Be Used to Pack All Products is unchecked for that box in ShipperHQ. See Dimensional Packing: Configure Boxes to be Used for All Products.

A Deleted or Renamed Value Still Appears

Synchronization keeps any value that's still assigned to a product, so a Shipping Group you deleted or renamed in ShipperHQ stays in Magento until you remove it from those products. See "Manual Delete Required" when Synchronizing to Magento.

Rates Don't Reflect the Attributes You Assigned

If your assigned attributes aren't included in the rate request, common causes include configurable product settings, outdated indexes, and values set in a different configuration scope. See Fix Magento Attributes That Are Not Included in Requests.

Additional Resources