Shopify Tax Managed Mode Changes Market Settings and Shop Publication Rules
Shopify published a developer changelog entry on October 28, 2026, describing the release of managed mode for Shopify Tax. Classified as both a Breaking API Change and Action required, it concerns the 2027-01 API release and behavior in the REST Admin API and GraphQL Admin API. The entry lists October 22, 2026 as the effective date.
The changes apply only to stores using Shopify Tax managed mode for U.S. sales. In that setup, Shopify manages certain store settings and enforces tax-related behavior through API validation. Merchants selling into the United States without managed mode are not affected by these particular rules.
Market Validation in marketCreate and marketUpdate
The marketCreate and marketUpdate mutations validate currency and tax settings for merchant-managed, non-retail markets that include the United States. Markets that exclude the U.S., retail markets, and markets managed by third parties are outside this validation scope. The check applies to all supported API versions, including unstable, but is triggered only when a request includes currencySettings or priceInclusions. Requests omitting both fields continue to behave as before.
Shopify validates the effective configuration, including values already stored and defaults for omitted subfields. For a U.S.-only market, the required settings are baseCurrency: USD, localCurrencies: false, and taxPricingStrategy: ADD_TAXES_AT_CHECKOUT. For a market containing the U.S. and another country, such as Canada, the required settings are localCurrencies: true and taxPricingStrategy: INCLUDES_TAXES_IN_PRICE_BASED_ON_COUNTRY.
Currency violations return UNSUPPORTED_CURRENCY. Incompatible tax display settings return INCOMPATIBLE_CONFIGURATION in API version 2026-07 and later, or GENERIC_ERROR in earlier versions. Developers can either send compliant settings or avoid including the fields when no change to those settings is needed.
Publishing Products to Shop Becomes a Prerequisite
For stores operating in managed mode, products published to Online Store, Headless, Hydrogen, or Buy Button must also be published to Shop. Shopify describes these as dependent publication channels. The handling of inconsistent publication requests depends on the API version.
In the unstable API version, a request that violates the dependency is rejected in full. In dated API versions, Shopify can add the necessary Shop or dependent-channel changes to the request automatically and save it. Publishing a product to a dependent channel also publishes it to Shop, even if the dependent-channel publication is scheduled, because Shop does not support scheduled publishing. Conversely, unpublishing a product from Shop also removes it from the dependent channels.
A rejection by Shop or a Shop status requiring action does not necessarily block a dated-version request. Some combinations can still be rejected, however, including certain attempts to schedule a draft product on a dependent channel without publishing to Shop. The distinction matters: this is an API enforcement and synchronization rule for eligible stores, not a universal requirement that every Shopify merchant publish every product to Shop.
Which Publication Mutations Are Affected
The dependency applies to publishablePublish, publishableUnpublish, and publicationUpdate, along with the deprecated productPublish and productUnpublish mutations and publication fields in productCreate and productUpdate.
Because productUpdate replaces the entire list of publications, a request that includes a dependent channel must also include Shop. With publicationUpdate, certain conflicting auto-publishing configurations are invalid: for example, turning on autoPublish for a dependent channel while Shop is not set to publish automatically, or turning it off for Shop while a dependent channel continues to auto-publish.
In the REST Admin API, creating or updating a product can fail when the product would be made available on Online Store without being published to Shop, or while Shop blocks it. Shopify documents validation messages including For the store setup, Shop publication is a prerequisite and For the store setup, unpublishing from dependent publications is a prerequisite. Repeating an identical invalid request produces the same response, so these should be handled as validation errors, not transient failures suitable for retry loops.
Rollout is gradual and restricted to stores with managed mode. The API schema itself is unchanged.
Taxable Fields and Product Taxonomy Changes
The same changelog entry also deprecates the taxable field in DraftOrderLineItemInput and the taxable argument in orderEditAddCustomItem beginning with GraphQL Admin API 2027-01. Shopify directs developers toward productCategoryId, based on its Standard Product Taxonomy.
For stores using managed mode, taxable is ignored in all API versions; an item without a category is taxed at the standard rate. In stores without managed mode, taxable retains its previous behavior. Reading the taxable value and webhook payload contents do not change. The new productCategoryId field is available in draftOrderCreate, draftOrderUpdate, draftOrderCalculate, and orderEditAddCustomItem.
The entry also clarifies that visibility settings in CheckoutBrandingFooterContent and CheckoutAndAccountsConfigurationBrandingFooterContent control customizable footer content only. Transaction information supplied by Shopify may remain visible even if the corresponding setting is HIDDEN. No schema change accompanies this clarification.
A Practical Developer Checklist
Developers maintaining Shopify integrations should check whether affected stores use managed mode before updating market or product publication logic. The immediate steps are to ensure correct U.S. market currency and tax settings, or omit those fields when they are not being changed; publish products to Shop before, or in the same request as, dependent channels; and unpublish dependent channels before or alongside Shop.
For active products in REST integrations, Shopify recommends sending published: false first and then publishing through publishablePublish. Developers should replace deprecated taxable inputs with productCategoryId when adopting API 2027-01 and review checkout branding preview tests to account for footer information that Shopify can still display.
Dates, Scope, and What Shopify Does Not Specify
The developer entry lists October 28, 2026 as its publication date, October 27, 2026 as its update date, and October 19, 2026 as its creation date. The update date therefore precedes the displayed publication date. This article follows the stated publication date and reports October 22, 2026 separately as the effective date.
According to the accompanying release notes, API version 2027-01 is scheduled to become stable on January 1, 2027 and was still a release candidate when the source material was prepared. The managed-mode changelog item is not separately enumerated in those release notes. The changelog does not explain how a particular store is enrolled in managed mode, and the market-setting checks described above extend across supported API versions rather than applying exclusively to 2027-01.
Related Shopify Markets API Change
Shopify Tax calculates sales tax for Shopify stores. The marketCreate and marketUpdate mutations control market settings such as currency and how taxes are reflected in prices.
In a separate developer announcement dated September 22, 2026, Shopify said it was removing the marketCurrencySettingsUpdate mutation from GraphQL Admin API 2027-01. Currency settings should instead be passed through marketCreate and marketUpdate. In API versions 2026-10 and earlier, the older mutation remains present but returns UNIFIED_MARKETS_ENABLED without making changes. Shopify does not explicitly attribute that separate removal to the Tax managed-mode policy.
Trust Us Transform Your Performance Marketing.
Keep commerce, tax, and channel integrations aligned with reliable marketing measurement. We help ecommerce brands audit Shopify data, conversion tracking, and paid media performance to support profitable growth.
Audit Your Shopify Analytics










