7/17/2026, 12:00:15 AM
A new draftThemeFilesCommit mutation is added allowing callers to commit staged theme file changes for a given theme ID and session ID. This mutation returns a DraftThemeFilesCommitPayload containing lists of deleted and upserted files and any user errors. All references to the AnalyticsTarget object, query, and mutations now link to the latest (stable) API, improving consistency with latest docs. The analyticsTargets query, analyticsTargetCreate, analyticsTargetUpdate, and analyticsTargetsDelete mutations keep the same signatures but update descriptions and link URLs. The payload types for the create and update mutations now feature updated field descriptions linking to the new docs URLs. A new returnPolicyProfile field is added to the Market object, exposing the return policy profile for a market. No API functionality is removed; the only changes are UI description updates, the new theme commit feature, and the additional market field.
Returns a paginated list of analytics targets
for the shop. Each target represents a merchant-defined goal for a specific metric over a date range.
Results can be filtered by metric, name, date range, or filter expression, and sorted by fields
such as start_date, expected_value, or metric.
Use the analyticsTargetCreate
mutation to add new targets.
Commits staged theme file changes for a caller-provided session.
Creates an analytics target that
defines a merchant's goal for a specific metric over a date range. For example, a merchant
can set a target of $50,000 in total sales for a quarter, or 1,000 orders in a month.
Provide the target attributes through the input argument. The target's currency is set to
the shop's currency. A target is uniquely identified by the combination of metric, startDate,endDate, and filters — attempting to create a duplicate returns a user error.
Use analyticsTargetUpdate
to modify an existing target, oranalyticsTargetsDelete
to remove targets.
Updates an existing analytics target.
Only the fields provided in the input argument are modified; omitted fields remain unchanged.
Setting a nullable field to null clears its value.
Use analyticsTargetCreate
to create a new target, oranalyticsTargetsDelete
to remove targets.
Deletes one or more analytics targets.
Accepts a list of target IDs and returns the IDs that were successfully deleted. If any ID
is not found, a user error is returned for that ID while the remaining valid targets are still deleted.
Use analyticsTargetCreate
to create new targets, oranalyticsTargetUpdate
to modify existing ones.
Return type for draftThemeFilesCommit mutation.
analyticsTargetanalyticsTargetreturnPolicyProfileThe return policy profile for this market.