Change: New Email, Staff Annotation, Location Filters

The API now exposes a paymentInstrumentSendAddEmail mutation that lets you send a secure link to a customer to add a payment instrument for a subscription, order, or draft order. It uses a new PaymentInstrumentMandateInput type and an EmailInput to supply mandate details and email settings. The catalogs and catalogsCount queries have received new filter arguments: "assigned_company_location_id" and a string‑typed "market_id" (previously an id). ProductVariant.barcode is now deprecated in favor of the existing barcodes field; it no longer returns multiple values. RequestedOrderEdit has lost the requestApprovedAt field and gained requestResolvedAt to record when an edit is resolved. Shop.analyticsAnnotations now lists staff as a valid source in its description and query filter, and the AnalyticsAnnotationSource enum has been extended with a STAFF value. The customerPaymentMethodRemoteBillingAddressUpdate mutation’s description was refined to clarify it covers remote credit cards and PayPal billing agreements.

Query Changes

🔄 Modified Queries (2)

catalogs

Returns a paginated list of catalogs for the shop. Catalogs control which products are published and how they're priced in different contexts, such as international markets (Canada vs. United States), B2B company locations (different branches of the same business), or specific sales channels (such as online store vs. POS).

Filter catalogs by type and use the query argument to search and filter by additional criteria.

Learn more about Shopify Catalogs.

~ Modified argument: query

catalogsCount

The count of catalogs belonging to the shop. Limited to a maximum of 10000 by default.

~ Modified argument: query

Mutation Changes

➕ Added Mutations (1)

paymentInstrumentSendAddEmail

Sends an email to a customer containing a secure link to add a new payment instrument (e.g., credit card) for a specific resource such as a subscription, order, or draft order. This is used when a customer needs to provide payment details for an existing resource — for example, after a payment method was revoked or when setting up payment for a new subscription contract.

🔄 Modified Mutations (1)

customerPaymentMethodRemoteBillingAddressUpdate

Updates the billing address on a customer's remote credit card or PayPal billing agreement imported with customerPaymentMethodRemoteCreate. Use this when the billing address is incomplete or incorrect and needs to be corrected in Shopify without re-importing the payment method. The payment method is not re-verified and the buyer is not charged.

The address is saved in Shopify only. It is not sent to the payment gateway, so the address the gateway holds is unchanged.

Type Changes

➕ Added Types (3)

📥PaymentInstrumentMandateInput➕ AddedINPUT_OBJECT

The input fields for specifying a specific mandate resource.

📋PaymentInstrumentMandateResourceType➕ AddedENUM

The type of resource a payment instrument mandate can be associated with.

Values: SUBSCRIPTIONS, ORDERS, DRAFT_ORDERS

🏗️PaymentInstrumentSendAddEmailPayload➕ AddedOBJECT

Return type for paymentInstrumentSendAddEmail mutation.

Fields: customer, userErrors

🔄 Modified Types (4)

🏗️AnalyticsAnnotationSource🔄 Modified

➕ Enum value added: STAFF

🏗️ProductVariant🔄 Modified

🔄 Field modified: barcode

🏗️RequestedOrderEdit🔄 Modified

➖ Field removed: requestApprovedAt

➕ Field added: requestResolvedAt

The date and time when the requested edit was resolved.

🏗️Shop🔄 Modified

🔄 Field modified: analyticsAnnotations

Before:

📝

Returns a paginated list of analytics annotations
for the shop, including Shopify-generated annotations and annotations created by any app. Annotations are
markers that can be overlaid on analytics charts to give merchants context for changes in their metrics.

Supports filtering by title, type, source, start date and time, end date and time, creation date and time, and
update date and time. Results can be sorted by ID or by any of the supported date and time fields. Use the
analyticsAnnotationCreate
mutation to add new app-created annotations.

Type: AnalyticsAnnotationConnection!

Arguments:

first: Int -

The first n elements from the paginated list.

after: String -

The elements that come after the specified cursor.

last: Int -

The last n elements from the paginated list.

before: String -

The elements that come before the specified cursor.

reverse: Boolean -

Reverse the order of the underlying list.

sortKey: AnalyticsAnnotationSortKeys -

Sort the underlying list using a key. If your query is slow or returns an error, then try specifying a sort key that matches the field used in the search.

query: String -

A filter made up of terms, connectives, modifiers, and comparators.

name	type	description	acceptable_values	example_use
created_at	time	Filter by the date and time when the annotation was created.		- `created_at:>=2026-01-01`
ended_at	time	Filter by the date and time when the annotation ended.		- `ended_at:<=2026-01-31`
id	id	Filter by `id` range.		- `id:1234` - `id:>=1234` - `id:<=1234`
source	string	Filter by annotation source.	- `app` - `shopify`	- `source:app` - `source:shopify`
started_at	time	Filter by the date and time when the annotation started.		- `started_at:>=2026-01-01`
title	string	Filter by annotation title.		- `title:campaign`
type	string	Filter by annotation type.		- `type:campaign`
updated_at	time	Filter by the date and time when the annotation was last updated.		- `updated_at:>=2026-01-01`
You can apply one or more filters to a query. Learn more about Shopify API search syntax.

After:

📝

Returns a paginated list of analytics annotations
for the shop, including Shopify-generated annotations and annotations created by staff members or apps.
Annotations are markers that can be overlaid on analytics charts to give merchants context for changes in
their metrics.

Type: AnalyticsAnnotationConnection!

Arguments:

first: Int -

The first n elements from the paginated list.

after: String -

The elements that come after the specified cursor.

last: Int -

The last n elements from the paginated list.

before: String -

The elements that come before the specified cursor.

reverse: Boolean -

Reverse the order of the underlying list.

sortKey: AnalyticsAnnotationSortKeys -

Sort the underlying list using a key. If your query is slow or returns an error, then try specifying a sort key that matches the field used in the search.

query: String -

A filter made up of terms, connectives, modifiers, and comparators.

name	type	description	acceptable_values	example_use
created_at	time	Filter by the date and time when the annotation was created.		- `created_at:>=2026-01-01`
ended_at	time	Filter by the date and time when the annotation ended.		- `ended_at:<=2026-01-31`
id	id	Filter by `id` range.		- `id:1234` - `id:>=1234` - `id:<=1234`
source	string	Filter by annotation source.	- `app` - `shopify` - `staff`	- `source:app` - `source:shopify` - `source:staff`
started_at	time	Filter by the date and time when the annotation started.		- `started_at:>=2026-01-01`
title	string	Filter by annotation title.		- `title:campaign`
type	string	Filter by annotation type.		- `type:campaign`
updated_at	time	Filter by the date and time when the annotation was last updated.		- `updated_at:>=2026-01-01`
You can apply one or more filters to a query. Learn more about Shopify API search syntax.

New Email, Staff Annotation, Location Filters

Query Changes

🔄 Modified Queries (2)

Mutation Changes

➕ Added Mutations (1)

🔄 Modified Mutations (1)

Type Changes

➕ Added Types (3)

🔄 Modified Types (4)

Field Modified: barcode on ProductVariant

Before:

After:

Field Modified: analyticsAnnotations on Shop

Before:

After:

Field Modified: `barcode` on `ProductVariant`

Field Modified: `analyticsAnnotations` on `Shop`