Integration Guide

Shopify Buy Button vs a Full Online Store

The Buy Button channel ships with every Shopify plan; the JS Buy SDK is what Shopify stopped supporting. What the embed does, and where it stops.

Buy ButtonOnline StoreWhere It StopsPlans & Fees
August 14, 2026·18 min read·
Listen to a short brief of this article
Hands-free while you multitask

Key Insights in 60 Seconds

Skim the highlights, then jump to the part of the decision that is actually open in your case.

The Buy Button channel is on every Shopify subscription plan, though Starter isn't available to new stores.
What Shopify stopped supporting is the JS Buy SDK, the developer library, not the channel.
One embed puts a product, a collection or a cart on your page, and that cart accumulates.
Shopify App Store apps don't work with Buy Buttons, and restyling in the channel means generating a new button.
Subscription-only products without a one-time option can be sold on the Online Store channel only.
Button sales carry your plan's usual Shopify Payments rates — 2.9% + 30¢ Basic, where new stores start.

What You'll Learn

1Which of the two Buy Buttons is yours
2What one embed can put on a page
3The limits Shopify documents, and those it doesn't
4What a sale costs per plan
5Why Shopify warns against it on Shopify
6What to do about the JS Buy SDK

You have a website that already works. It ranks for something, people arrive on it, and you have no intention of rebuilding it just because you now want to sell something. Shopify's answer to that is a block of code you paste into a page — and the first thing search results tell you about that block of code is that it has been discontinued.

That is a collision between two different products with almost the same name. One of them is alive and included in every Shopify subscription plan; the other, a developer library called the JS Buy SDK, hit a critical deadline of July 1, 2025: Shopify said setups that made neither of the two changes it named would stop completing purchases. Sorting out which one you are dealing with is the difference between a shopping decision and a repair job, so this page starts there and then answers the real question underneath it: whether the button is enough, or whether what you actually need is a store.

The Quick Verdict

Key takeaway

Five situations cover almost everybody who lands on this question. Find yours in column one; the rest of the page is the evidence underneath these five lines.

Button, store, or neither — by situation

Your situationPickWhy
A handful of products on a site you already own — WordPress, Wix, Squarespace, hand-written codeBuy ButtonShopify includes the channel in all of its subscription plans, so nothing about your site, your hosting or your plan has to change before you can sell from it.
Shoppers need to browse a catalogue, search it or filter itOnline StoreBrowsing is what the Online Store channel is built to do — and no Shopify page we have found describes a customer-facing search or filter inside an embed.
The sale needs a discount code inside the embed, a subscription, or shipping rules of your ownOnline StoreSubscription-only products without a one-time purchase option can be sold on the Online Store channel only — that limit is documented. Shopify documents applying a discount through a cart permalink, but no page we have found describes the promotion mechanics inside the embed itself.
The page you would embed on is your own Shopify store or blogCart permalinksShopify does not recommend Buy Buttons there, because they can cause problems with the checkout process, and names pre-loaded cart permalinks as the alternative.
A developer built the buy flow on that page with Shopify's JavaScript libraryMigrate first, decide laterShopify set a critical deadline of July 1, 2025, 11:00 AM ET for the JS Buy SDK: merchants had to switch to the Storefront API Client or upgrade to JS Buy SDK v3.0 by then, or customers would not be able to complete purchases.

Two Things Called “Buy Button”

Key takeaway

The Buy Button sales channel is something you switch on in your Shopify admin. It produces a block of HTML that you paste into a page on some other website, and the sale it generates runs through Shopify's checkout. Its status is not ambiguous: Shopify's Help Center states that the Buy Button sales channel is included in all Shopify subscription plans — with no plan carved out of that sentence.

The JS Buy SDK was a JavaScript library that developers used to build their own storefront and their own checkout flow against Shopify, in code, without ever opening the Buy Button channel. That is the thing Shopify deprecated. The two share a lineage and half a name, which is why a page about the second one reads, at a glance, like an obituary for the first.

If a developer built the buy flow on that page for you, in code, your part of this article is the triage sectionwhat the deadline did and what the two documented ways out are; if somebody pasted a snippet out of a Shopify admin, the rest of this page is a straightforward comparison.

How to tell which one you have
  • Somebody copied a block of code out of Shopify's admin and pasted it into a page, and what renders is a product block with Shopify's checkout behind it — that is the channel, and it is current.
  • A developer installed a package and wrote code that talks to Shopify, with a checkout built into your own pages — that is the SDK lineage, and the dates below matter to you.

What One Embed Puts on Your Page

Key takeaway

What the channel hands you is narrower than “a shop on your website”, and knowing exactly what it is comes before pricing anything. Generating the code and getting it into WordPress, Wix, Squarespace or a hand-written template is mechanical work, and our companion piece walks that part platform by platform. This page starts one step later: what the thing you pasted can and cannot do once it is there.

What the Buy Button channel produces

What you can createWhat the shopper getsWhen it is the right one
An individual productA single product block on your page, wired to add that product to a cart, to move straight to checkout, or to open its details first — depending on which action you generated.The product belongs on one particular page — a post written about it, a landing page built around it, one item in a portfolio.
An embedded collectionA group of products shown together in one block rather than a single card.You are showing a small, stable set: this season's prints, the four things you actually sell, the merch table.
An embedded cartA standalone cart that customers can use across pages.The buying happens on more than one page, and the cart has to follow the shopper between them.
A cart permalinkA link that opens with the cart already loaded. Shopify describes it as something you share with customers through an email campaign, direct message or social media post.There is no page you can paste code into, or the buying moment happens inside a conversation rather than on a website.

The cart underneath the embed is not limited to one product. Shopify documents the add-to-cart button type as one where customers can continue shopping and add additional products to the cart. So one embed does not lock a shopper into a single-item order: they can keep adding to the same cart before they check out, which is the difference between an embed and a row of isolated buy-now links. Carrying that cart across pages is something Shopify documents for a different object — the embedded cart, which it describes as a standalone cart that customers can use across pages. A cart that keeps its contents between clicks is the reason a handful of products can live on a content site without feeling like a handful of separate transactions.

Where the checkout appears is a setting on the button rather than fixed behaviour: Shopify lets you choose whether the checkout opens in a new browser window or in the same tab as your website, and states that the default is a new window. It is worth setting deliberately — the default is the option most people never touch, and it is the one that moves the shopper off the page you spent years building at the exact moment they decided to pay.

None of that requires seeing it built, but if the embed is still an abstraction, the six-minute tutorial below generates one and drops it onto a Squarespace, Wix and WordPress page in turn — the three hosts this comparison keeps naming. It answers “what does the code do”, not “should I use it”; the decision this article exists for stays in the sections above and below.

Adding a Shopify Buy Button to a Squarespace, Wix or WordPress pageGenerating a Buy Button and embedding it on a non-Shopify site, step by step. Independent channel; the limits and plan requirements below are the sourced part.

Already on Shopify? This Isn't Your Tool

Key takeaway

There is one case where the answer is neither button nor store, and it catches merchants who are already on Shopify and simply want a product to sell from a blog post or a landing page inside their own theme. Shopify is unusually direct about it — this is the platform advising against its own feature, in its own documentation.

Shopify does not recommend the use of Buy Buttons on your Shopify online store or blog, because they can cause problems with the checkout process.
Shopify — Buy Button sales channel — Shopify Help Center ·

The same page names the alternative in the next breath: instead, consider using permalinks to pre-load the cart. A cart permalink is a link that arrives with items already in the basket, so the shopper lands in the checkout your store already runs rather than in a second one layered over the first. On your own Shopify store you are not missing a way to sell — you are one link away from the one you already have.

Where the Buy Button Stops

Key takeaway

This is the section that decides the article. The gap that costs merchants time is not between expensive and cheap, it is between the channel is on my plan and the sale I need will actually complete. Part of that boundary Shopify states outright. The rest of it is silence — features the pages we read document in neither direction — and the two carry very different weight.

What we looked for and did not find
Some of the boundaries below rest on what Shopify's pages do not say rather than on what they do. The surfaces we read for the absences below were the Buy Button channel pages in Shopify's Help Center — the channel overview, create a Buy Button, the channel FAQ and add the embed code — plus the Buy Button product page on shopify.com and Shopify's subscriptions setup page, all read on August 11, 2026; we added two more on August 14, 2026: Shopify's page on customizing or removing a Buy Button, embedded collection or cart, and its cart permalink page. An absence in documentation is weaker evidence than a published rule, and every sentence below that rests on one says so.

The limits Shopify documents

Key takeaway

These four are quotable, dated and settled. Read the third one twice if the site in question is not actively maintained — it is the boundary that turns a five-minute job into an afternoon, two years from now, when somebody changes the brand colours. Shopify documents one way round it that is not a setting: editing the embed code in your page's source HTML, which its own page labels an advanced tutorial it does not support.

What you can't doWhat Shopify's page saysWhat that means on your page
Run a Shopify app on the embed“Buy Buttons aren't compatible with apps from the Shopify App Store.”Every upsell widget, review block, bundle builder and loyalty popup in your admin belongs to the store, not to the button. What you paste is what the shopper gets.
Offer Apple Pay“If your customer is using the Buy Button to pay for their order, then Apple Pay isn't offered because it's not supported by the Buy Button sales channel.”The wallet a large share of iPhone shoppers reach for is missing here, and the reason Shopify gives is the channel itself rather than anything in your payment settings.
Restyle a button after it is live“The appearance of the Buy Button can't be changed after you embed it on your website. If you want to change it, then you must create a new button in the channel and replace the original code with the new code.”A redesign of your site becomes a re-paste of every embed on it, unless somebody hand-edits the embed code — a route Shopify documents but labels an advanced tutorial it does not support. On a site nobody maintains, this is the line that ages worst.
Skip having a supported gateway“You need to use a supported payment gateway to use Buy Button.”Which gateways qualify depends on where your business is registered, so this is a check to run in your own admin before you build a page around the button.

Source: Shopify Help Center — Buy Button FAQ, Create a Buy Button and Activating Apple Pay, read August 11, 2026.

Can you sell subscriptions through a Buy Button?

Key takeaway

Subscriptions are usually where this decision stops being close, and the boundary is documented — but it sits on the product rather than on the button. A product that can only be bought as a recurring purchase has exactly one channel it is allowed to sell on.

Subscription-only products without a one-time purchase option can be sold only on the Online store sales channel.
Shopify — Set up subscriptions — Shopify Help Center ·

Read the scope carefully, because it is narrower than “no subscriptions”: it covers subscription-only products without a one-time purchase option. Selling plans on the Buy Button channel more generally are not described one way or the other on the pages we read — see the boundary block above — so a product you intend to offer both ways is a question to settle with a test in your own admin. Either way, the recurring side of a business has its own mechanics, and the subscriptions guide covers them properly.

The limits nobody documents

Key takeaway

Promotions are the first gap, and it is narrower than it looks. For a cart permalink, Shopify documents that when you create one you can select the product variants, quantities and discounts that you want to apply. What no Shopify page we have found describes is applying a discount code or a gift card at the level of the Buy Button embed itself — the surfaces we read are listed in the block above. That is not the same as saying it will fail; it means there is nothing published to plan a promotion around inside the embed, and a campaign whose whole mechanic is a code working inside an embed deserves a real test order before the email goes out.

Rules at the point of sale are the second. A minimum order value, a local delivery radius, shipping rates or tax settings configured for this channel alone — none of those are documented for the Buy Button on the pages we read. Shipping and tax still come from your store settings and are worked out at checkout, which is fine for a flat catalogue and awkward the moment your delivery promise depends on where the buyer lives.

Browsing is the third, and the one that quietly decides the article. The search box in the Buy Button channel is the one you use to find a product while creating a button; no page we have found describes a search or filter that a visitor gets inside an embed. Where a test in your own store is the honest answer, the price of running one is a Basic subscription at $39/month, month-to-month in USD — Shopify states the Starter plan isn't available to new stores. And if the answer you need is a catalogue people search and filter, that is not a gap in the button. That is a description of an Online Store.

Which plan do you need, and what does a sale cost?

Key takeaway

The plan question has a shorter answer than most people expect: no particular plan. Because Shopify includes the channel in all of its subscription plans, what you are really choosing is a price, not a capability. Two plans bracket the decision for a site that wants an embed and nothing else — Starter and Basic, both quoted below in USD on month-to-month billing. Starter brackets it only for merchants already on it: Shopify states the Starter plan isn't available to new stores, and that a merchant who changes plan cannot revert back to it. If you are opening a store now, the floor is Basic; where the choice between the two is still open, it is settled by your monthly sales volume rather than by anything the channel can or cannot do, and the route-by-route arithmetic behind that crossover belongs to our guide Add Shopify to an Existing Website, linked earlier in this article.

The two plans that bracket an embed-only setup (Starter is closed to new stores)

PlanMonthly, USD, month-to-monthOnline card rate with Shopify PaymentsSurcharge if you use another provider
Starter$5/month5% + 30¢5%
Basic$39/month2.9% + 30¢2%

Source: Shopify pricing for the Basic row, USD, month-to-month billing; the Starter row's $5 price and 5% surcharge come from an April 2026 archive snapshot of Shopify's own Starter page, which now redirects, and its 5% + 30¢ card rate from a July 2026 archive snapshot of this pricing page. Rates are the standard online card rates for each plan; the surcharge column applies only when payments run through a provider other than Shopify Payments.

Nothing about the button itself is surcharged. Shopify does state that you will be charged third-party transaction fees each time a customer makes a purchase using the Buy Button unless you also activate Shopify Payments — but that is the same condition that governs every other channel you sell through, not a penalty for embedding. The arithmetic of those surcharges across all the plans, and the cases where they are waived, belongs to the payment gateways guide.

One thing you get for nothing is visibility. Shopify's sales report documentation states that the Sales channel column displays the name of the channel or app the customer used to place their order, naming Online Store and Buy Button as its examples. So you can answer “is the embed actually working?” from the reports you already have, without tagging anything.

Which One Is Yours?

Key takeaway

Six sections in, the honest position is that almost nobody decides this on one fact. A shop with four products and no promotions is a straightforward yes; the same shop with a subscription box in it, or a developer's checkout on the page, is a completely different answer — and neither of those shows up in the profile you matched at the top.

The table at the top answers by profile. This one answers by combination — what you are selling, what has to happen at the moment of sale, and who touches the code on that page, crossed together. Pick one of the four hard answers and the points stop mattering; pick two and the quiz takes the more urgent one first — an SDK checkout before anything else, then your own Shopify store, then a subscription.

Buy Button or a Full Store — Which Is Yours?Five questions; the answer depends on how they cross, not on any one of them
Question 1 of 5
Where would the button actually go?

If Your Checkout Was Built on the JS Buy SDK

Key takeaway

This section is for a smaller group, and it is written in the past tense because the deadline has already gone. It applies if the buy flow on your site was built by a developer in code against Shopify's JavaScript library, rather than pasted out of the admin. What broke was any checkout still on the old JS Buy SDK when the deadline passed — neither switched to the Storefront API Client nor upgraded to v3.0 — and it broke on a date Shopify published in advance.

Three moments matter, and only the last one has consequences a shopper could see.

The JS Buy SDK is deprecated
“The JS Buy SDK is deprecated as of January, 2025. It will no longer be updated or maintained by Shopify past that point.” The Buy Button sales channel in the admin is untouched by this notice.Source: Shopify Dev Changelog
Early 2025
A final major version lands
“A final major version will be released in early 2025 to remove the SDK's dependency on the deprecated Checkout APIs, replacing them with Cart APIs.” This is the version a site still on the library was expected to reach.
Critical deadline — migrate or purchases stop completing
“Critical Deadline: July 1, 2025 11:00 AM ET.” Shopify's changelog states that merchants had to switch to the Storefront API Client or upgrade to JS Buy SDK v3.0 by then, or customers would not be able to complete purchases.Source: Shopify Changelog

Both Shopify posts cited here — re-read on August 14, 2026 — name the same critical deadline date for the JS Buy SDK: July 1, 2025, which the changelog post pins at 11:00 AM ET. If you are trying to work out whether a site is affected, the date on the changelog is the one to check against, and the symptom it names is unambiguous: on a setup that made neither of the two changes, purchases stop completing.

One more date circulates in third-party write-ups — January 2026. It appears on neither of the two Shopify pages above, so treat it as someone else's number rather than a second cut-off to plan around.

Shopify published two ways out in the same post. The first is switching to the Storefront API Client, which it recommends, and which manages the API's authentication information and enables full access to globally-deployed carts. The second is upgrading to JavaScript Buy SDK v3.0, which it describes as letting merchants maintain their current setup with minimal changes for use cases that are supported by the Cart API. Which of the two suits you is a development decision rather than a merchandising one, and it sits inside the larger question of how much custom Shopify you want to own.

The Bottom Line

Key takeaway

The question that brought most people here — “is the Buy Button still supported?” — turns out to be the wrong one, and answering it takes ten seconds: the channel is included in all Shopify subscription plans, and the deprecated thing is a developer library with a similar name. The question worth your time is the one underneath it, and it has nothing to do with support status.

Choose the embed when your product list is short and stable, and the store when the sale needs anything to happen around it. Promotions inside the embed, subscriptions, delivery rules and a catalogue people can search are the four things that turn a Buy Button project into a Shopify project — and choosing the store is not the same as moving: the usual shape is the content site staying exactly where it is while the shop lives on Shopify. Only one of the four is a limit Shopify puts in writing; for the embed itself the other three are absences in the documentation we read, which is a weaker thing and worth weighing as one. If none of the four is in your plan, paste the snippet and get on with selling.
Your Next Step by Stage
New to Shopify entirelySee what a Shopify store actually involves before you decide how much of one you need.Getting started with Shopify
The embed isn't enoughWhat a full Shopify website includes out of the box, the three ways to build one, and what each costs.Shopify ecommerce website
You want it done for youThe embed placed properly on your existing site, or a checkout migrated off the old JS Buy SDK.Shopify store setup

Not Sure the Button Will Still Be Enough in a Year?

We scope the store build before you outgrow the embed: what your catalogue, promotions and delivery rules actually require, what it costs to build, and what stays on the site you already own. A fixed quote, not a rebuild surprise.

Get a scoped quote

Frequently Asked Questions

No. Shopify's Help Center states that the Buy Button sales channel is included in all Shopify subscription plans, and nothing on that page announces a retirement. What was discontinued is a different thing with a similar name: the JS Buy SDK, a JavaScript library developers used to build their own checkout against Shopify.
The Buy Button is a sales channel you switch on in your admin; it generates code you paste into a page on another website. The JS Buy SDK was a developer library for building a custom storefront and checkout in code. The channel is live and included in every subscription plan; the library is deprecated.
That was the date Shopify published as the critical deadline for the JS Buy SDK, at 11:00 AM ET. Its changelog states that merchants had to switch to the Storefront API Client or upgrade to JS Buy SDK v3.0 by then, or customers would not be able to complete purchases. It has no bearing on Buy Buttons generated from the admin channel.
Any subscription plan. Shopify states the channel is included in all Shopify subscription plans, with no exceptions listed, so the plan decision is really a price decision. In USD, month-to-month, Basic is $39/month; Starter is $5/month, but Shopify states the Starter plan isn't available to new stores, so a store opening now starts at Basic. Between the two, the fees per sale differ more than the subscriptions do.
No — a sale through the button carries the same rates as any other online sale on that plan. Shopify does state that you will be charged third-party transaction fees each time a customer buys through the Buy Button unless you also activate Shopify Payments, which is the same condition that applies to your other channels.
Yes, on a cart permalink. Shopify documents appending a discount query parameter to a cart permalink URL to apply a discount, and the Buy Button channel creates cart permalinks. For the product or collection embed itself, no Shopify page we have found describes applying a discount code or a gift card, so run a real order through your own embed before you build a promotion around it.
Not the subscription-only kind. Shopify's subscriptions documentation states that subscription-only products without a one-time purchase option can be sold only on the Online store sales channel. Selling plans on the Buy Button channel more generally are not described either way on the pages we read, in August 2026.
No. Shopify's Apple Pay documentation is explicit: if your customer is using the Buy Button to pay for their order, Apple Pay is not offered, because it is not supported by the Buy Button sales channel. If express wallets matter to your conversion rate, that is an argument for the Online Store checkout instead.
No. Shopify states that Buy Buttons are not compatible with apps from the Shopify App Store. Upsell widgets, review blocks, bundle builders and loyalty popups all attach to the store rather than to the embed, so whatever you paste into your page is exactly what a shopper will see there.
Not through the channel. Shopify states the appearance of a Buy Button can't be changed after you embed it on your website; to change it you must create a new button in the channel and replace the original code with the new code. A separate Shopify page does describe changing a Buy Button's appearance by editing its embed code in your page's source HTML, but labels that an advanced tutorial it does not support. Plan a site redesign as a re-paste of every embed on it.
Shopify says no. Its Help Center states that Shopify does not recommend the use of Buy Buttons on your Shopify online store or blog, because they can cause problems with the checkout process, and suggests using permalinks to pre-load the cart instead. On your own store you already have a checkout to send people to.
It might be. Shopify states that Buy Buttons created before October 10, 2016 are no longer supported, so an embed pasted in during that era can simply have run out. The documented fix is the same one used for restyling: generate a new button in the channel and replace the old code with it.
Yes, with the right button type. Shopify documents that add product to cart adds the product to a shopping cart, and that customers can continue shopping and add additional products to the cart. So a shopper builds one basket rather than placing a string of separate single-item orders.
Yes, without any extra setup. Shopify's sales report documentation states that the Sales channel column displays the name of the channel or app the customer used to place their order, naming Online Store and Buy Button as examples. So the embed's revenue stays identifiable against everything else you sell.
About This Article
Shopify Developer & E-Commerce Writer
9+ years with Shopify since 2017

Front-end developer specializing in Shopify since 2017. Experienced in building custom Liquid themes, optimizing storefront performance, and integrating third-party apps. Writes in-depth, data-driven e-commerce guides based on hands-on experience with real merchant stores.

This article was written entirely by AI under human editorial direction. The editor sets the topic and structure, runs multi-stage validation on facts, links, and interactive elements, and verifies the output is useful from a business perspective. All claims are checked against official Shopify sources. Details may change — always confirm critical data at shopify.com.

Editorial Policy
Continue Learning

What to Read Next

Stay updated

Get notified about new articles

Subscribe to receive updates when we publish new Shopify guides and insights.