Home Docs Installation guide
Guide

Installation guide

Everything you need to install Custom Shipping Rules and go live with UPS rates at your BigCommerce checkout.

This app quotes UPS UAE Domestic rates only. It's the right fit if you ship domestically within the United Arab Emirates with UPS.

Before you install

Make sure your store is ready. You'll need:

A BigCommerce store

Any plan. Install from the App Marketplace or your control panel under Apps → My Apps.

A United Arab Emirates shipping zone

These are UPS UAE Domestic rates, so checkout must have a shipping zone covering the UAE for the options to appear.

Product weights set

Rates are calculated from weight, so products need weights. Add dimensions too for dimensional-weight pricing on light, bulky items.

Permissions

On install the app requests only two OAuth scopes — nothing related to orders, customers, or payments:

  • Fulfillment Methods — to connect the carrier and add its UPS options inside your shipping zones.
  • Information and Settings — to read your store's weight/dimension units and default currency, so rates convert and price correctly.
The app never reads or writes orders, customers, products, or payment data.

Installation steps

Six steps from install to live at checkout.

1
Install the app

Add Custom Shipping Rules from the BigCommerce App Marketplace, or from Apps → My Apps. New installs start switched off, so nothing changes at checkout until you turn it on.

2
Grant the requested permissions

BigCommerce shows the two permissions the app needs and asks you to confirm. Approve them to finish — you're returned to the app dashboard.

3
Connect the carrier

On the Home tab, click “Connect carrier”. This attaches the UPS options to your shipping zone(s) so they can be quoted at checkout. The setup checklist ticks green on success.

4
Review rates & pricing

Open Configure. Pick a pricing strategy (a flat markup %, or fuel surcharge + VAT), browse the AED rate table, and press Test rates on a sample shipment to confirm the numbers.

5
Turn on shipping

Flip the master switch on Home. The status badge turns green once the carrier is connected and the service is on.

6
Verify at checkout

Add a product and check out to a UAE address. You should see two options — Close of Business and Midday — priced in AED.

Open the app Read the User guide

Troubleshooting

Checkout shows only “Ship by weight”

The carrier isn't attached to the zone yet. On Home, use Re-sync carrier, and make sure your UAE shipping zone has the UPS method enabled.

No rates appear for a non-UAE address

This is expected — the app quotes UPS UAE Domestic rates only and returns nothing for other destinations.

Rates look wrong

Check your product weights/dimensions and your pricing strategy on Configure. The charged rate uses the greater of actual vs dimensional weight, priced by your chosen strategy.

Still stuck? Email info@codinative.com — we reply within one business day.