AnalyticsTarget sortKey now ID; new B2B, LineItem fields

4/14/2026, 12:00:43 AM

The analyticsTargets query now defaults to sorting by ID instead of START_DATE, and its query argument now accepts a "default" filter for more natural searches. The financeKycInformation field’s description has been clarified to emphasize its use for embedded finance apps. A new B2BType object and a b2b field on EntitlementsType expose B2B entitlement data. The AnalyticsTarget type gains a shopifyqlQuery string field, allowing clients to retrieve the raw ShopifyQL query used to compute its metric. LineItem now includes priceAfterAllDiscountsBeforeTaxesSet, giving the total line-price in shop and presentment currencies after discounts but before taxes. MarketsCatalogsEntitlement gets a limit integer field indicating the catalog cap. Additional enum values MEDIA_CANNOT_BE_MODIFIED and CVV_ATTEMPTS_EXCEEDED have been added to their respective error code enums. Developers should adjust queries that rely on these defaults or newly added fields and be aware of the new error codes when handling errors.

Query Changes

πŸ”„ Modified Queries (2)

analyticsTargets

A list of analytics targets for the shop.

~ Modified argument: sortKey
~ Modified argument: query
financeKycInformation

Returns Know Your Customer (KYC) information for the shop's Shopify Payments account. KYC data includes verified identity and business details collected during onboarding. This is primarily used by embedded finance apps (e.g., Shopify Balance, Bill Pay) that need to verify the merchant's identity without requiring a separate KYC process.

Type Changes

βž• Added Types (1)

πŸ—οΈB2BTypeβž• AddedOBJECT

The entitlements for B2B.

Fields: enabled

πŸ”„ Modified Types (7)

πŸ—οΈAnalyticsTargetπŸ”„ Modified
βž• Field added: shopifyqlQuery

A ShopifyQL query string to fetch the current metric value for this target.

πŸ—οΈBusinessEntityπŸ”„ Modified
βž• Field added: legalEntityId

The stable central legal entity ID associated with this business entity.

πŸ—οΈEntitlementsTypeπŸ”„ Modified
βž• Field added: b2b

The shop's B2B entitlements.

πŸ—οΈFilesErrorCodeπŸ”„ Modified
βž• Enum value added: MEDIA_CANNOT_BE_MODIFIED
πŸ—οΈLineItemπŸ”„ Modified
βž• Field added: priceAfterAllDiscountsBeforeTaxesSet

The total price of the line item in shop and presentment currencies,
after all discounts are applied and excluding refunded and removed quantities.
This value doesn't include taxes.

πŸ—οΈMarketsCatalogsEntitlementπŸ”„ Modified
βž• Field added: limit

The maximum number of catalogs allowed.

πŸ—οΈShopPayPaymentRequestReceiptProcessingStatusErrorCodeπŸ”„ Modified
βž• Enum value added: CVV_ATTEMPTS_EXCEEDED