Documentation

Rule Ship Guide

Everything you need to build, price, and target custom shipping rates for your Shopify checkout — from your first rate to advanced filter logic.

Overview

Getting Started

Rule Ship lets you create custom shipping rates that appear at checkout based on cart weight, order price, destination, and product details. Each rate you define is evaluated automatically for every checkout — no code required.

  1. 1

    Open the app

    From your Shopify admin, go to Apps → Rule Ship.

  2. 2

    Review existing rates

    The Home screen lists every rate you've created, along with its price and conditions.

  3. 3

    Create your first rate

    Click “New Shipping Rate” to define pricing, limits, and filters — see below for details.

Walkthrough

Creating a Shipping Rate

Each rate is built from four groups of settings:

  1. 1

    Public Details

    Rate Name and Rate Description — shown to the customer at checkout.

  2. 2

    Advanced Settings

    A unique Code to identify the rate, optional internal Notes, and toggles for Disabled.

  3. 3

    Price

    Set a Base Price, then optionally add a per-kilogram or per-currency-unit surcharge that kicks in past a threshold. See “How Pricing Is Calculated” below.

  4. 4

    Limits & Filters

    Restrict the rate to a weight range, a price range, and/or one or more conditions on the destination and cart contents.

Tip

Every rate needs a unique Code. Save is blocked until Rate Name, Rate Description, Code, Base Price, and at least one filter are filled in.

Reference

How Pricing Is Calculated

At checkout, the final price for a rate is the base price plus any surcharges once the cart crosses the weight or price thresholds you set:

Cart weight is the sum of quantity × grams across every line item. Leave a surcharge field at 0 to skip that part of the formula.

Reference

Filters & Conditions

Filters decide whether a rate is offered at all. A rate is only shown when every filter on it matches (filters are combined with AND). To match several values within a single filter, use the Include or Exclude verb with a comma-separated list.

Destination fields

Matched against the customer's shipping address.

FieldMatches
Customer NameShipping address name
Address line 1Shipping address, line 1
Address line 2Shipping address, line 2
CityShipping address city
State / Province codeShipping address province code
Country 2-letter codeShipping address country code (ISO 3166-1 alpha-2)
Zip / Postal codeShipping address postal code
Company nameShipping address company name

Product fields

Matched against every line item in the cart — the rate applies if any item matches.

FieldMatches
Product NameLine item title
Product SKULine item SKU
Vendor nameLine item vendor
Product TagAny tag on the product
Product TypeProduct type
CollectionAny collection the product belongs to

Verbs

VerbDescription
EqualsExact match, case-insensitive.
Not EqualTrue when the value does not match exactly.
Starts withTrue when the field begins with the value.
Ends withTrue when the field ends with the value.
IncludeTrue when the field matches any of a comma-separated list, e.g. "CA,US,UK".
ExcludeTrue when the field matches none of a comma-separated list, e.g. "CA,US".
Regular ExpressionTrue when the field matches the pattern, e.g. "^V0C.*".
Reference

Weight & Price Limits

Beyond filters, a rate can be scoped to a weight range and a price range. A cart must fall within both ranges for the rate to be offered:

Weight range

Cart weight must be at least Minimum Weight. If Maximum Weight is set above 0, the cart weight must not exceed it.

Price range

Cart total must be at least Minimum Price. If Maximum Price is set above 0, the cart total must not exceed it.

Good to know

Price limits are evaluated before discounts, since Shopify does not pass discount information to shipping rate apps at this stage.

Workflow

Managing Existing Rates

From the Home screen you can search rates by name, expand a rate to review its price, limits, and conditions, edit a rate's details, temporarily turn a rate off without deleting it, or remove it entirely.

SearchExpand detailsEditDisable / EnableDelete

Editing a rate

Click “Edit” on any rate to open it in the same form used to create a rate, pre-filled with its current Public Details, Advanced Settings, Price, and Limits/Filters. Make your changes and save — the same validation rules from “Creating a Shipping Rate” apply.

Help

Troubleshooting

  • !

    A rate isn't showing at checkout

    Confirm the rate isn't Disabled, that the cart falls within its weight and price limits, and that every filter on the rate matches the test order.

  • !

    Save is failing

    Check that the Code is unique across all your rates and that every filter has a Field, Verb, and Value.

  • !

    Price looks wrong

    Remember surcharges only apply past the “Starting after” threshold, and price limits are compared before discounts.