> For the complete documentation index, see [llms.txt](https://docs.roadmap.so/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roadmap.so/subscriptions/managing-subscriptions/changing-a-subscriptions-shipping-address.md).

# Changing a subscription's shipping address

Pick, add, or edit the address a subscription ships to, from the admin or the customer's dashboard, and how it stays in step with the customer's Shopify addresses.

Each subscription contract has its own shipping address. Instead of typing one in, you and your customers pick from the addresses already saved on the customer's Shopify profile, or add a new one. Picking a saved address avoids typos and near-identical addresses, which matters because subscriptions only [combine into one order](https://docs.roadmap.so/subscriptions/getting-started/combine-same-day-subscription-orders.md) when they ship to exactly the same address.

The same address picker is used in three places:

* The **Shipping address** card on a subscription contract in the Roadmap admin
* The subscription dashboard in new customer accounts
* The legacy storefront subscription dashboard

### Change the address from the admin

{% stepper %}
{% step %}

#### Open the picker

Open the subscription in Roadmap, go to the **Shipping address** card, and click **Edit**.
{% endstep %}

{% step %}

#### Pick, edit, or add an address

The picker lists every address saved on the customer's Shopify profile, in any country, under a note explaining that *Saved addresses come from the customer's Shopify profile, and Shopify default marks the one set as their default there. Selecting an address changes the shipping address for this subscription only.*

* The address the subscription uses now is pinned to the top with a **Current** badge.
* The customer's default address in Shopify carries a **Shopify default** badge.
* Each entry shows the region, so near-identical addresses can be told apart. Identical saved addresses appear once.
* When the customer has a long list of addresses, a **Search saved addresses** box appears above the list.
* Click **Edit** beside any address to change it, including the current one, or **+ Add new address** if the one you need isn't saved yet.
  {% endstep %}

{% step %}

#### Save

Nothing changes until you click **Save**. The new address applies to future orders on this subscription only, and the change is recorded on the contract's [Timeline](https://docs.roadmap.so/subscriptions/managing-subscriptions/the-subscription-activity-timeline.md) with who made it.

<figure><img src="https://393112916-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ8asLD4FVCFagK40xEr4%2Fuploads%2F1Re58k7lZsgOLIiKqHYI%2FScreenshot%202026-11-18%20at%2011.01.40%E2%80%AFAM.png?alt=media&amp;token=74346f8b-adbb-4fda-924e-2c5cf80e4870" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

In the admin you can also pick an address in a different country from the one the subscription ships to now, for example when a customer moves overseas. The subscription's market sets which products are available and what they cost, so confirm the products are available in the new country before you switch it.

### What your customers see

Customers choose **Edit shipping address** on their subscription dashboard, in both new customer accounts and the legacy storefront dashboard. This opens **Update shipping address**, with the note *Saved addresses come from your account. Selecting an address changes the address for this subscription only.* They can pick a saved address, **Edit** one (including the one marked **Current**), or **+ Add new address**. Nothing changes until they save.

Customers see the **Current** badge but not the **Shopify default** badge, which is shown in the admin only.

The picker works the same way in both dashboards. In new customer accounts its look comes from your Shopify theme settings, so it can look different from the legacy dashboard shown below.

<figure><img src="https://393112916-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ8asLD4FVCFagK40xEr4%2Fuploads%2Ff8uUMsujtPtN5knrBvhZ%2FScreenshot%202026-11-18%20at%2011.05.44%E2%80%AFAM.png?alt=media&amp;token=7f41a0a7-2e22-47da-ac75-6562b9e0bf69" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Customers only see addresses in the country their subscription ships to now. Addresses in other countries are left out of their picker, and the country can't be changed when they add or edit an address. To move a customer to another country, change the address for them from the admin.
{% endhint %}

On the legacy storefront dashboard, customers with more than 20 saved addresses see the first 20 and a **Load more** option for the rest. Their current address is always shown at the top.

Customers can change the address on **Active**, **Paused**, and **Failed** subscriptions. A paused or failed subscription keeps the new address when it's reactivated.

### Keeping addresses in step with Shopify

* **New addresses** added in the picker are saved to the customer's Shopify profile too, so they're there to pick next time.
* **Changes to the customer's default address in Shopify** carry through to every subscription that ships to that default address. Subscriptions that ship to a different address keep their own.
* **A default address in a different country** isn't carried through. The subscription keeps its current address.

### Required address fields

The address forms follow the customer information options in your [Shopify checkout settings](https://help.shopify.com/en/manual/checkout-settings/customer-info). If your checkout requires a field, such as first name, company, address line 2, or a shipping phone number, it's required in the subscription address forms too and marked with an asterisk. Last name is always required, and state or region is required wherever Shopify requires it for that country.

If a saved address is missing a required field, saving opens the edit form with the missing fields shown, so they can be filled in first. When you create a subscription from the admin, an address that's missing a required field can't be selected until it's completed.

{% hint style="info" %}
New customer accounts pick up a change to your checkout settings straight away. The admin and the legacy storefront dashboard can take a few moments to show it.
{% endhint %}

### If an address can't be saved

If the address doesn't pass validation, the subscription keeps its current address and the reason is shown, for example a postal code that doesn't match the city or region. The failed attempt and its reason are recorded on the contract's Timeline. For each reason and what the customer needs to change, see **When an address won't save** in [The customer subscription dashboard: a tour](https://docs.roadmap.so/subscriptions/storefront-and-accounts/the-customer-subscription-dashboard-a-tour.md).

### Related guides

* [The customer subscription dashboard: a tour](https://docs.roadmap.so/subscriptions/storefront-and-accounts/the-customer-subscription-dashboard-a-tour.md): every action customers see, including address restrictions
* [Changing shipping on a subscription contract](https://docs.roadmap.so/subscriptions/managing-subscriptions/changing-shipping-on-a-subscription-contract.md): move a contract to a different shipping rate
* [Create a subscription for a customer](https://docs.roadmap.so/subscriptions/managing-subscriptions/create-a-subscription-for-a-customer.md)
* [Combine same-day subscription orders](https://docs.roadmap.so/subscriptions/getting-started/combine-same-day-subscription-orders.md)
* [The Subscription Activity Timeline](https://docs.roadmap.so/subscriptions/managing-subscriptions/the-subscription-activity-timeline.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.roadmap.so/subscriptions/managing-subscriptions/changing-a-subscriptions-shipping-address.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
