4/2/2026, 12:00:29 AM
A new analyticsTargets query returns paginated analytics targets for the shop, with comprehensive filtering, sorting, and a full text query syntax described in the docs. Three new mutations – analyticsTargetCreate, analyticsTargetUpdate, and analyticsTargetsDelete – let apps create, update, or remove analytics targets, each with a payload that includes the target object and potential validation errors. Multiple field descriptions in the Channel type have been clarified: accountId, accountName, handle, and specificationHandle now reference the external account, merchant-facing name, unique shop handle, and bound specification respectively, aiding multi‑channel integration. The channelCreate and channelUpdate mutations have updated descriptions and arg wording to reflect their role in establishing and modifying a channel connection, with channelCreate’s “input” field description now highlighting the creation of a connection to an external platform. channelFullSync’s documentation now explains the full product resync process, its optional country & language scoping, and the response’s fullSyncTraceInfo showing per‑feed trace data. A new weight field on LineItem provides the weight of a unit, useful for shipping calculations. Several legacy branding fields and enums (such as CheckoutAndAccountsConfigurationBrandingBackground and background) have been removed or renamed to simplify the API. The overall schema now contains fewer deprecated paths and more explicit references to the app's ownership of channels, ensuring developers can link resources securely.
A list of analytics targets for the shop.
Returns a Channel by ID. The channel must belong to the calling application.
Returns a Channel by its unique string handle. The handle is either set explicitly during channelCreate or auto-generated from the specification handle and account ID. The channel must belong to the calling application.
The list of Channel objects on the shop. When the calling application supports multi-channel, only channels established by the calling application are returned. Each channel represents an authenticated connection to an external selling platform such as a marketplace, social media platform, online store, or point-of-sale system.
Create a new analytics target.
Updates an analytics target.
Deletes one or more analytics targets.
Creates a Channel representing a connection between the shop and an external selling platform account. Use this mutation after a merchant authenticates with an external platform to establish the publishing destination for product syndication and, for order-generating channels, order import.
The platform resolves the channel specification identified by specificationHandle, determines its country coverage, intersects with the shop's available region markets, and establishes product feeds for all matching regions. Product feeds immediately begin emitting events to the application's webhook or event subscription.
If the specification sets expects_online_store_parity and no matching region markets exist, the mutation returns an error. If the specification doesn't require online store parity and no matching region markets exist, a channel subordinate to shop defaults is created automatically.
Deletes a Channel from the shop. All associated product feeds are removed. Existing orders attributed to the channel are preserved. The channel must have been created via channelCreate.
Triggers a full product resync for the specified Channel. All published products are added to the channel's product feed attention set, causing the next poll or event-triggered consumption to receive current state for the complete catalog. Use this mutation after initial channel setup, after recovering from a prolonged outage, or when the channel's external catalog has drifted from Shopify's state.
The sync can be scoped to a specific country and language. When neither is specified, all country-language combinations covered by the channel's specification are triggered.
Updates the properties of an existing Channel. Use this mutation to update account information — such as the display name shown in Shopify Admin — or to bind the channel to a different channel specification.
Updating the specificationHandle triggers re-evaluation of the specification's country coverage against the shop's region markets, reconciling product feeds accordingly. This is also the mechanism for migrating legacy channel records to the multi-channel model by assigning a specification handle.
A target for an analytics metric.
An auto-generated type for paginating through multiple AnalyticsTargets.
Return type for analyticsTargetCreate mutation.
An auto-generated type which holds one AnalyticsTarget and a cursor during pagination.
Return type for analyticsTargetUpdate mutation.
Return type for analyticsTargetsDelete mutation.
The container background style.
The color selection options.
accountIdaccountNamehandlespecificationHandlechannelfullSyncTraceInfochannelTRANSPARENTbackgroundcolorcountrylanguageweightThe weight of a line item unit.