About location rules

You can use location rules to rank the possible locations for a line item during checkout. In this tutorial series, you'll use Shopify Functions to create a function that prioritizes locations in a particular country defined by the user.

Anchor to What you'll learnWhat you'll learn

In this tutorial series, you’ll learn how to do the following tasks:

• Set up your environment to use functions.
• Create a location rule function.
• Add configuration options to your location rule function using metafields.
• Build a location rule user interface using Admin UI extensions.

Anchor to RequirementsRequirements

• You've created a Partner account.
• You've created a development store.
• You've created an app that uses Shopify CLI 3.49.5 or higher. If you previously installed Shopify CLI, then make sure that you're using the latest version. Start with the Remix app template if you plan to make your location rule configurable and create a UI for it. Otherwise, start with an extension-only app and let Shopify host it for you.If you plan to create a UI for your extension, then start with the Remix app template.
• You've installed Node.js 16 or higher.
• You've installed your app on the development store.

• You're using API version 2025-07 or higher for your function.

Anchor to Rust-specific requirementsRust-specific requirements

The following requirements are specific to Rust-based development with Shopify Functions.

• You've installed Rust.

  On Windows, Rust requires the Microsoft C++ Build Tools. Make sure to select the Desktop development with C++ workload when installing the tools.

• You've installed the wasm32-wasip1 target:

  Terminal

  Copy

  $

  $

  rustup target add wasm32-wasip1

Anchor to TutorialsTutorials

Follow the tutorial series to go from "Hello World" to a functional location rules experience.

Tutorial 1: Getting started with building location rules

Create a new location rule function.

Tutorial 2: Make your location rule function configurable

Add configuration to your location rule function using metafields.

Tutorial 3: Build a location rule user interface

Build a new page in your app where merchants can view location rules.

Anchor to Developer tools and resourcesDeveloper tools and resources

Explore the following developer tools and resources to get familiar with building location rules.

Order Routing Location Rule API reference

Consult the GraphQL reference for the Order Routing Location Rule API.

Language support

Learn about the language support and tooling that are available in Shopify Functions.