HomeAdd a widgetWordPress
Add an online store to WordPress
Sell something from WordPress without migrating the site onto an e-commerce platform. One widget is one purchasable thing, checkout runs on Stripe, and the money goes to your own Stripe account.
Free plan, no card. Paid plans start at $19 a month.
Why do it this way on WordPress
A full e-commerce plugin is a reasonable answer to a catalogue and an unreasonable one to a single product. If you are selling one thing — a book, a course, a deposit, a membership — a Custom HTML block and a Stripe account gets you there without adding a store, a cart, a checkout page and an ongoing update surface to a site that is otherwise a website.
See it working
This is a real Sorraia shop widget — our own sample product, embedded here exactly the way you would embed yours. Checkout is switched off on this one: click Buy and you will get “This shop is not ready to accept payments yet.” instead of a Stripe page. Everything up to that point is the live product.
How to add an online store to WordPress
A widget that sits in the page flow goes in a Custom HTML block, on the one page you want it on.
Self-hosted WordPress has no plan gating on any of this. WordPress.com does: on the free plan the Custom HTML block strips script, style, link, iframe, frame, form, input, object, textarea and embed tags, so nothing renders — and note that link is on that list, meaning an externally-linked stylesheet is blocked too, not just inline CSS. Its paid plans — Personal, Premium, Business and Commerce — all allow custom code, but you have to install at least one plugin before the plan’s hosting features switch on, so a paid site that has never installed a plugin will still have the embed silently removed.
In Sorraia, add the website and verify it — a DNS TXT record, or a meta tag in your homepage’s <head>. Verification is what lets you attach a widget to that site, so it comes before there is anything to paste.
Save the product and the Copy Embed Code popup appears; the Install wizard on the product’s row on the Shop page does the same with a verification step.
Open the page in WordPress (Pages → hover the page → Edit) and put the cursor where the widget should sit.
Click the Block Inserter (the + icon), search for “HTML”, and choose Custom HTML. In an empty paragraph you can also type /html and press Enter.
Paste the Sorraia snippet into the block, then click Publish or Update on the page.
Open the live page in a new tab to check it. The block editor renders its preview inside a sandbox, so a working widget can look boxed-in or blank while you are editing.
If the site still runs the Classic Editor, switch from the Visual tab to the Text tab, paste the snippet there, and save without switching back. TinyMCE reformats markup on the round trip and can mangle or drop the script.
What you get
Sell something from WordPress without migrating the site onto an e-commerce platform. One widget is one purchasable thing, checkout runs on Stripe, and the money goes to your own Stripe account.
Three ways to charge
A widget is a flat-price Buy Now, a pay-what-you-want donation where the customer sets the amount, or a recurring monthly or yearly subscription. You pick per widget, so a one-off product and a membership can live on the same site.
Three ways to fulfil
Digital emails a signed download link once Stripe confirms payment — the link is good for 24 hours. Physical collects a shipping address at checkout and applies one flat shipping rate, and you mark it shipped. Service skips fulfilment entirely and just tells you the sale happened.
Checkout is Stripe, and the account is yours
Payment runs as a direct charge on your own connected Stripe account, so payouts, disputes, receipts and tax settings stay in the Stripe dashboard you already use — we never hold your money in between. Sorraia takes a platform fee on top, deducted as a Stripe application fee: 2% on Free, falling to 1.5% on Starter, 1% on Growth, 0.5% on Business and 0.25% on Enterprise. Eight currencies are supported.
Orders and refunds in the dashboard
Orders land in Sorraia with the customer, the amount and the site they came from, filterable and exportable like every other list. Refunds are issued from the same place.
More detail in the Help Center: Shop basics · Embedding on your website
Things worth knowing about WordPress
- Silent script stripping is the most common failure. WordPress removes <script> on save from any user without the unfiltered_html capability — always the case for non-Super-Admins on multisite, and often on a single site where a security plugin (Wordfence, Solid Security) or DISALLOW_UNFILTERED_HTML has taken it away. The block saves cleanly and the script is simply gone.
- Caching and optimisation plugins are the second. WP Rocket, Autoptimize, LiteSpeed Cache and Perfmatters defer, combine, minify or lazy-load JavaScript by default, which breaks async widget loaders. Add the Sorraia script URL to the plugin’s exclusion list.
- The block editor’s preview pane is a sandboxed iframe, so a floating launcher looks clipped inside the block while you edit and works correctly for visitors. Check the published page, not the editor.
Questions
Do I need my own Stripe account?
Yes, and that is deliberate. Checkout is a direct charge on your connected Stripe account, so customers pay you and your payouts, disputes, receipts and tax configuration stay in the Stripe dashboard you already control — Sorraia never holds your revenue in between. Our platform fee rides along as a Stripe application fee, from 2% on Free down to 0.25% on Enterprise, so you can see exactly what it is on every charge.
Can I sell a subscription, or take donations?
Both. Each shop widget is set to one of three types — a flat-price one-off, a donation where the customer chooses the amount, or a recurring subscription billed monthly or yearly. Different products on the same site can use different types.
Do I need a plugin to add a Sorraia widget to WordPress?
No. An inline widget goes in a Custom HTML block, which is part of WordPress itself. A plugin is only worth installing for the site-wide case — a floating chat launcher on every page — because a footer snippet plugin like WPCode survives theme updates, while a hand-edited footer.php does not.
The widget disappeared after I saved the page. Why?
Almost always script stripping. WordPress removes script tags on save from users without the unfiltered_html capability, and security plugins remove that capability from ordinary administrators. To confirm: open DevTools → Network, save the block, and inspect the request — if the script is in the request body but missing from the response, something stripped it server-side. Adding it site-wide through a snippet plugin sidesteps the block’s filtering entirely.
Add an online store to WordPress
Build it in Sorraia, paste one line into your WordPress site, and change it later without touching the embed again.