Skip to main content

FedEx

Charge accurate residential delivery fees​

Where to find it: Admin → Custom Fields (to configure) | Storefront → Checkout (customer-facing)

When you'd use this: FedEx applies additional charges when delivering to residential addresses rather than commercial locations. Enable this to collect accurate shipping costs from customers during checkout.

What you need first:

  • FedEx shipping integration already configured
  • A custom field created for Ship To addresses with the tag isResidentialAddress set to 1

Set it up:

  1. In Admin, create a custom field for the Ship To entity type
  2. Configure it as a checkbox field with the label "Is the address residential?"
  3. Add a tag named isResidentialAddress with the value 1
  4. The field will automatically appear on checkout address forms

Using it day-to-day:

When customers add or edit a shipping address during checkout, they'll see a checkbox asking whether the address is residential. Their selection is passed to FedEx when calculating shipping rates, ensuring the quote includes any applicable residential delivery surcharges.

For existing customer addresses, the implementation team can import residential status values during your initial setup.

Troubleshooting:

  • Residential fees not appearing in shipping quotes — Verify the custom field has the isResidentialAddress tag with value 1. The field must be tagged exactly this way for the integration to recognize it.
  • Checkbox not visible at checkout — Custom fields for Ship To addresses display automatically on Checkout address forms. Confirm you're using Checkout and the field is active.