Shipping Calculator
Add shipping cost calculations to your product checkout flow, with rates based on destination and package details. Available on Plus plans and above.
Plus+Overview
The Shipping Calculator app adds automatic shipping cost calculations to your e-commerce checkout. When a customer purchases physical products from your store, the calculator determines the shipping cost based on the delivery destination, cart contents, and your configured rates.
You define shipping zones (geographic regions) and assign shipping rates to each zone. During checkout, the customer enters their delivery address and the system matches it to a zone, calculates the available shipping methods, and displays the costs — all before the customer completes payment.
Key capabilities:
| Feature | Description |
|---|---|
| Shipping Zones | Define regions by country, state, or postal code range |
| 4 Rate Types | Flat rate, weight-based, price-based, and ZIP + weight combined |
| Free Shipping | Set minimum order thresholds for free shipping |
| Checkout Integration | Shipping options appear automatically during checkout |
| Address Auto-fill | ViaCEP integration for Brazilian addresses |
| Stripe Integration | Shipping cost added as a separate line item in Stripe |
| Product Weight | Track weight and dimensions per product |
Getting Started
Enabling the Shipping Calculator
Open the Shipping App
Navigate to Dashboard → Apps → Shipping Calculator. You’ll see the shipping dashboard with 4 tabs: Overview, Zones, Rates, and Settings.
Enable shipping in Settings
Go to the Settings tab and toggle Enable Shipping Calculator to on. This activates shipping calculations in your checkout flow.
Configure your default units
In the Settings tab, set your preferred units:
| Setting | Options | Default |
|---|---|---|
| Weight unit | kg, lb | kg |
| Dimension unit | cm, in | cm |
Create shipping zones
Go to the Zones tab and create at least one shipping zone (see Shipping Zones below).
Create shipping rates
Go to the Rates tab and create at least one rate for your zone (see Shipping Rates below).
The Shipping Calculator only applies to physical products. Digital products (where requires_shipping is set to false) skip the shipping step during checkout.
Shipping Zones
A shipping zone is a geographic area where you deliver products. Each zone can be defined by countries, states/provinces, and postal code ranges.
Creating a Zone
- Go to Dashboard → Apps → Shipping Calculator → Zones tab
- Click Create Zone
- Fill in the zone details:
| Field | Required | Description |
|---|---|---|
| Name | Yes | A descriptive name (e.g., “Brazil - Southeast” or “USA - West Coast”) |
| Description | No | Internal notes about this zone |
| Countries | Yes | Select one or more countries (e.g., BR, US) |
| States | No | Narrow down to specific states (e.g., SP, RJ, MG, ES for Brazil) |
| ZIP/CEP Ranges | No | Define postal code ranges for even more precise targeting |
| Active | Auto | Enabled by default — toggle off to temporarily disable |
Zone Matching
When a customer enters their shipping address during checkout, the system matches their address to a zone using this priority:
- ZIP/CEP range — most specific match
- State — if ZIP ranges are not configured
- Country — broadest match
If no zone matches the customer’s address, the checkout will show a message that shipping is not available to that location.
Example Zones
Zone: Brazil - Southeast
- Countries: Brazil
- States: SP, RJ, MG, ES
- ZIP ranges: 01000-000 to 09999-999 (São Paulo metro), 20000-000 to 28999-999 (Rio de Janeiro)
Zone: USA - California
- Countries: United States
- States: CA
Zone: International
- Countries: All remaining countries
- No state or ZIP restrictions
Shipping Rates
Each shipping zone needs at least one rate that defines how shipping costs are calculated. You can create multiple rates per zone to offer different shipping options (e.g., “Standard” and “Express”).
Rate Types
GoConverso supports 4 rate calculation methods:
| Rate Type | How It Works | Best For |
|---|---|---|
| Flat Rate | Fixed cost regardless of cart contents | Simple pricing, local delivery |
| Weight-Based | Cost varies by total product weight using tiers | Physical goods with varying weights |
| Price-Based | Cost varies by cart subtotal using tiers | Percentage-style shipping discounts |
| ZIP + Weight | Combines postal code and weight for calculation | Precise regional + weight pricing |
Creating a Rate
Go to the Rates tab
Navigate to Dashboard → Apps → Shipping Calculator → Rates tab.
Click Create Rate
Click the Create Rate button to open the rate configuration form.
Configure the rate
| Field | Required | Description |
|---|---|---|
| Zone | Yes | Select which shipping zone this rate applies to |
| Name | Yes | Display name shown to customers (e.g., “Standard Shipping”) |
| Description | No | Additional details shown during checkout |
| Rate Type | Yes | Flat Rate, Weight-Based, Price-Based, or ZIP + Weight |
| Base Price | Depends | Fixed cost for flat rate; base cost for other types |
| Free Shipping Threshold | No | Minimum cart value for free shipping (e.g., $100) |
| Min Cart Value | No | Rate only available for orders above this amount |
| Max Cart Value | No | Rate only available for orders below this amount |
| Active | Auto | Enabled by default |
Add weight or price tiers (if applicable)
For Weight-Based and Price-Based rates, add tiers to define graduated pricing.
Weight Tiers Example
For a weight-based rate, you define price tiers based on total cart weight:
| Min Weight | Max Weight | Price |
|---|---|---|
| 0 kg | 1 kg | $10.00 |
| 1 kg | 5 kg | $20.00 |
| 5 kg | No limit | $35.00 |
The system calculates the total weight of all physical products in the cart and matches it to the appropriate tier.
Price Tiers Example
For a price-based rate, tiers depend on the cart subtotal:
| Min Subtotal | Max Subtotal | Shipping Cost |
|---|---|---|
| $0 | $50 | $15.00 |
| $50 | $100 | $8.00 |
| $100 | No limit | $0.00 (Free) |
Free Shipping Threshold
Any rate can have a free shipping threshold. When the cart subtotal exceeds this amount, the shipping cost for that rate becomes $0 and a “Free Shipping” badge is displayed to the customer.
Offering free shipping above a certain order value is one of the most effective ways to increase average order value. Consider setting a threshold slightly above your current average order size.
Product Configuration
For shipping calculations to work accurately, your products need weight and dimension information.
Adding Weight to Products
When creating or editing a product in Dashboard → Products, you’ll find shipping fields:
| Field | Description |
|---|---|
| Weight | Product weight (numeric value) |
| Weight Unit | kg or lb |
| Length | Package length |
| Width | Package width |
| Height | Package height |
| Dimension Unit | cm or in |
| Requires Shipping | Toggle — set to off for digital products |
| Shipping Class | Optional category for grouping similar products |
Products without a weight value will default to 0 kg in shipping calculations. Make sure to add weight to all physical products for accurate shipping costs.
Product Variants
If your products have variants (different sizes, colors, etc.), each variant can have its own weight and dimensions. The shipping calculator uses the individual variant weights when calculating the total cart weight.
Checkout Integration
How Customers Experience Shipping
When a customer checks out with physical products, the checkout flow includes a Shipping step:
Customer fills in contact details
The first step collects name, email, and phone number.
Customer enters shipping address
The shipping address form collects:
| Field | Description |
|---|---|
| Country | Dropdown selector |
| State/Province | Dynamic based on country |
| City | Text field |
| Postal Code (ZIP/CEP) | Text field with auto-fill for Brazil |
| Street Address | Full address line |
Automatic shipping calculation
Once the address is complete, the system automatically:
- Matches the address to a shipping zone
- Calculates available shipping methods
- Displays options with prices
Customer selects shipping method
Available shipping methods are shown as selectable cards with:
- Method name (e.g., “Standard Shipping”)
- Price (or “Free Shipping” badge if threshold met)
- Zone name for reference
Checkout continues to review
The order total now includes the selected shipping cost: Total = Subtotal + Shipping.
Brazilian Address Auto-fill (ViaCEP)
For Brazilian addresses, the checkout form integrates with the ViaCEP API. When a customer enters their CEP (postal code), the system automatically fills in:
- Street name
- Neighborhood
- City
- State
This reduces friction and speeds up the checkout process for Brazilian customers.
ViaCEP auto-fill works with any valid 8-digit Brazilian CEP. The customer can still edit the auto-filled fields if needed.
Order Record
When an order is completed, the following shipping information is saved:
| Data | Description |
|---|---|
| Shipping address | Full delivery address as JSON |
| Shipping method | The rate the customer selected |
| Shipping cost | The calculated cost |
| Total weight | Sum of all product weights in the order |
Stripe Integration
When using Stripe for payments, the shipping cost is added as a separate line item in the Stripe Checkout session. This means:
- The customer sees “Shipping” as a distinct charge
- Stripe records show product subtotal and shipping separately
- Refunds can be processed for products and shipping independently
Plan Availability
The Shipping Calculator is available on Plus plans and above.
| Feature | Free | Plus | Pro | Max | Ultra |
|---|---|---|---|---|---|
| Shipping Calculator | — | Yes | Yes | Yes | Yes |
| Shipping Zones | — | 5 | 20 | Unlimited | Unlimited |
| Rates per Zone | — | 3 | 10 | Unlimited | Unlimited |
| Weight-Based Rates | — | Yes | Yes | Yes | Yes |
| Price-Based Rates | — | Yes | Yes | Yes | Yes |
| ZIP + Weight Rates | — | — | Yes | Yes | Yes |
| Free Shipping Thresholds | — | Yes | Yes | Yes | Yes |
| ViaCEP Auto-fill | — | Yes | Yes | Yes | Yes |
Related
- E-Commerce — Set up your product catalog
- Checkout & Payments — Payment processing and checkout customization
- Digital Products — Sell digital downloads (no shipping needed)