# Nicolás Mateos — full reference text > Freelance Shopify Plus and B2B developer based in Madrid, Spain. This file holds the complete > text of the reference pages of nicolasmateos.com: services, comparisons, questions and glossary. > Every block is headed by the URL it comes from, so anything quoted here can be attributed and > linked. Platform limits carry the date they were last checked against Shopify documentation. Site: https://nicolasmateos.com/ Index: https://nicolasmateos.com/llms.txt Glossary: https://nicolasmateos.com/en/glossary/ Contact: nicolasmhbusiness@gmail.com # English --- ## Shopify checkout customisation URL: https://nicolasmateos.com/en/services/checkout-extensibility/ Service: Shopify checkout customisation Updated: 2026-10-21 UI extensions, validations that block payment, custom fields and shipping and payment rules, inside Checkout Extensibility. What can be done, I do; what cannot, I tell you before quoting. ## What people actually ask for It is almost never a redesign. In the projects that reach me, checkout gets touched for four reasons: 1. **To warn about something before paying.** A minimum that is not met, a product with a three-week lead time, payment terms the company already has. 2. **To ask for a piece of data.** Purchase order number, VAT number, the buyer's internal reference, a requested delivery date. 3. **To block.** So a cart the warehouse cannot fulfil cannot be paid for. 4. **To order methods.** Hiding or reordering shipping and payment options by cart, country or company. All four fit inside Checkout Extensibility. What does not fit is moving the checkout steps or laying it out freely, and that is worth knowing before promising it upstairs. ## The pieces, and which one applies - **The editor** for the visual side: logo, colours, fonts, block order. No code and no Plus. - **UI extensions** to add content or fields at the allowed points of the checkout and the thank-you page. - **[Functions](/en/services/shopify-functions/)** for behaviour: validations that block, discounts, availability and order of shipping and payment methods. The difference that matters most when quoting: an extension that shows a notice is an afternoon; a validation that decides whether a cart can be paid for touches business rules, and the edge cases get written down before the code does. ## In B2B, two specific things A wholesale portal's checkout is won on two details. The first is stating the payment terms where the buyer sees them: if they pay in 60 days, saying so in the cart and at checkout cuts abandonment more than any badge. The second is the purchase order: a professional buyer has to be able to enter their reference, and that reference has to reach the order. ## What I deliver The extension or the Function with its configuration, tested on a development store against the carts that really cause trouble, and a written note on what can be changed from the admin without calling me again. ### FAQ **Can the checkout be laid out like a normal page?** No. Checkout Extensibility places extensions at allowed points and lets you change logo, colours, fonts and block order from the editor, but not freely reorder the steps or inject arbitrary JavaScript. If a quote assumes that, the quote is wrong. **Do I need Plus to touch the checkout?** For the visual side and for public apps, no. For an extension or a Function written specifically for your store, yes: they ship inside a custom app, and that requires Shopify Plus. **What happened to checkout.liquid?** It stopped being the route. What lived in checkout.liquid gets rebuilt with extensions and Functions, and in most cases half of what was there is no longer needed: they were workarounds the platform now covers. **Can I ask for a purchase order number at checkout?** Yes, with a field in an extension, and it can be stored on the order so it reaches the invoice and the ERP. It is one of the things a B2B buyer asks for most. --- ## Shopify speed and Core Web Vitals optimisation URL: https://nicolasmateos.com/en/services/core-web-vitals/ Service: Shopify performance optimisation Updated: 2026-11-05 I measure the store with real-user data, not just Lighthouse, and fix what actually costs seconds: app scripts nobody uses any more, unsized images, and theme JavaScript that blocks interaction. ## Measure first, and measure what counts Lighthouse is useful for comparing before and after under identical conditions. What decides your ranking is field data from real users: a store can score 95 in Lighthouse and still fail [Core Web Vitals](/en/glossary/core-web-vitals/) if 70% of its visits arrive on a phone with a poor connection. So the audit starts with the real data and with knowing where your visits come from. Optimising desktop on a store whose traffic is 80% mobile is wasted work. ## The order I fix in 1. **Ghost apps.** The app is removed from the dashboard and its script keeps loading. It is the first thing I look at and there are almost always two or three. It is also the most profitable fix: removing weight carries no design risk. 2. **Images.** Declared dimensions, modern formats, the main one loaded early and outside any carousel that needs JavaScript to paint its first frame. 3. **Theme JavaScript.** Usually the cart: rebuilding it by hand on every change when you can ask Shopify for the rendered section instead. 4. **Expensive [Liquid](/en/glossary/liquid/).** Nested loops over large collections. The fix is almost always moving the calculation into a metafield. ## What I deliver The before and after measured with the same method, the list of what was changed and why, and what I did not touch because the risk was not worth it. On [the code page](/en/code/) you can see this site's own numbers, measured against the deployed site rather than locally. ## SEO and visibility in AI assistants If the goal is to help search engines and assistants understand your products, [Shopify GEO consulting](/en/services/geo-shopify/) connects technical work with content, structured data and citation tracking. Performance and the theme are part of the review; alone they do not demonstrate AI visibility. ### FAQ **Can I get to 100 in Lighthouse?** On a real store with apps, almost never, and that is not the goal. What is achievable is passing all three Core Web Vitals on real-user data, which is what Google looks at and what the shopper notices. **What is usually the problem?** By frequency: scripts from uninstalled apps that keep loading, images without width and height, the main image inside a carousel that boots with JavaScript, and the cart rebuilt by hand on every change. **Do I need to change theme?** Almost never. In the audits I have run, most of the lost time is not in the theme: it is in what has been added on top of it. --- ## Custom Shopify apps URL: https://nicolasmateos.com/en/services/custom-shopify-apps/ Service: Custom Shopify app development Updated: 2026-10-21 Apps embedded in the Shopify admin with Node.js, Express and the CLI, for what no App Store app does: configurators, internal dashboards, catalog logic, or the container for your Shopify Functions. ## The first thing I will ask If what you need fits in a [metafield](/en/glossary/metafields/), a metaobject or an App Store app, you do not need a custom app. Your own app is code somebody has to maintain, update when the API version changes, and host somewhere. It earns its place when there is no alternative, not by default. ## What I usually build - **Product configurators** with rules no generic app models: compatibility, measurements, mutually exclusive combinations. - **Internal dashboards** embedded in the admin, so the team manages their own data where they already work instead of in a separate spreadsheet. - **Automations** that read and write over the [Admin API](/en/glossary/admin-graphql-api/): recalculating, reclassifying, cleaning up. - **The container for a [Function](/en/services/shopify-functions/)**, when the Function needs configuration and somebody has to be able to change it without touching code. ## How I build them Embedded in the admin with App Bridge, so the app lives inside Shopify instead of being a separate tab with a separate session. Authentication by session token, the API over GraphQL, and the API version pinned — never "latest": an unpinned API version is an app that one day stops working without anybody having touched it. And one thing I always say: a custom app needs an update plan. Shopify ships API versions every quarter and retires the old ones. If nobody is going to look at that app for two years, the project is better off not depending on it. ### FAQ **When does a custom app make sense?** When the flow is yours and no App Store app fits without bending it: a product configurator with your own rules, a dashboard so the team can manage something Shopify does not model, or the container for a Function written for your store. **Does a custom app need Plus?** The app itself, no. If it contains Shopify Functions, yes: only stores on Shopify Plus can install custom apps that carry Functions inside them. **Where is it hosted?** Wherever suits you to maintain. For most cases a serverless function or a small container is enough. Hosting an internal app usually costs a few euros a month, and that is worth knowing before starting. --- ## Custom Shopify themes URL: https://nicolasmateos.com/en/services/custom-shopify-themes/ Service: Custom Shopify theme development Updated: 2026-11-05 I implement your design or your agency’s in Shopify, from scratch or on a paid theme, with sections and blocks your team can edit. Before quoting, I review the templates, features and apps that must keep working. ## What makes the difference two years later Two themes can look identical on delivery day. On one, the client builds a landing page in twenty minutes; on the other, they ask for a quote every time they want to change a line of copy. The difference is in how the [sections and blocks](/en/glossary/sections-and-blocks/) were split, and that does not show in the mockup. My rule: one section per page intention, not per row of the design. Three text-and-image bands that differ only in which side the photo is on are one section with a setting, not three sections. And the other way round: one section with forty settings nobody understands is split just as badly. ## What is always included - **Sections with sensible defaults**, which look right before anything is configured. - **Capped blocks**, because a carousel that accepts thirty blocks will end up with thirty. - **Copy in the settings**, not in the code, and names in your team's language. - **Images with declared dimensions** and the main one loaded early, which is half of performance. - **Whatever repeats across pages in [metaobjects](/en/glossary/metaobjects/)**: the client edits it once and it changes on 200 product pages. ## Performance from the start A fast theme is not achieved by optimising at the end. It is achieved by not introducing the problem: not loading the main image inside a carousel that boots with JavaScript, not walking entire collections in [Liquid](/en/glossary/liquid/) to calculate something that fits in a metafield, and not repainting the cart by hand when you can ask for the rendered section. ## Projects to review before hiring For [Qurado](/en/projects/#qurado), I implemented a store from an existing design system, with custom filtering and a product and cart flow built for mobile. It is a relevant example if you already have a design and need someone to implement it in Shopify. For [Fernando de Cárcer](/en/projects/#fernando-de-carcer), I developed the theme from architecture to launch, with collection filtering, size guides and wishlist integration. The project entries describe my contribution; they do not attribute an unmeasured sales increase to the development work. ## What I need to scope your design Send the available design, your store URL and current theme, the required templates and the apps that affect products, cart or search. Also explain which changes your team should be able to make in the editor and who will approve the work. We can then distinguish adapting the current theme, creating new sections and building a complete theme. Graphic design, copywriting, catalog entry and external integrations should be separate items if they are part of the brief. ## How we check the delivery Before starting, we agree on screens and journeys: editing a section, finding a product, choosing a variant, adding to cart and continuing to checkout. The review covers mobile and desktop, the apps in scope and code handover with editing instructions. [Tell me about the design you want to implement](/en/contact/) and what your team needs to manage so we can scope the work. ## SEO and visibility in AI assistants If the goal is to help search engines and assistants understand your products, [Shopify GEO consulting](/en/services/geo-shopify/) connects technical work with content, structured data and citation tracking. Performance and the theme are part of the review; alone they do not demonstrate AI visibility. ### FAQ **Custom theme or a customised paid one?** A customised paid one, almost always, and I say that even though it bills less. A custom theme earns its place when the paid one has been modified so much that updating it is impossible, or when the brand needs something no theme in the store does. **Can I still update the theme afterwards?** If we start from a paid theme and the changes live in new sections and in a file of their own, yes, carefully. If the theme is written from scratch, updates are yours or mine, but they do not come from a vendor. **Is design included?** I do not design. I work with your design, your agency’s, or the theme’s. What I do is the front-end, and where the design clashes with how Shopify actually works, I say so before building it. --- ## Customer account area and extensions in Shopify URL: https://nicolasmateos.com/en/services/customer-accounts/ Service: Shopify customer account development Updated: 2026-10-21 The account area is where a wholesale buyer lives: their history, their outstanding orders, their price tier, their location. I build that area with customer account extensions and the front-end that makes it useful instead of decorative. ## Why it matters more in B2B than in B2C A B2C customer visits their account once, to see where the parcel is. A wholesale buyer logs in every week: it is a work tool. If they cannot find what they are looking for, they do not go to a competitor, they phone — and your team pays for that call. ## What I build, in order of how much it gets used 1. **Reorder the last order.** The most used feature of any wholesale portal. A button that recreates the order in the cart, with its quantities, and flags whatever is no longer available. 2. **Outstanding balance and due dates.** If the company is on [payment terms](/en/glossary/payment-terms/), this is the first thing they check. It has to be there, and it has to match the invoice. 3. **Downloadable invoices**, where the buyer looks for them rather than in an email from two months ago. 4. **A [location picker](/en/glossary/company-location/)**, if they buy for several branches — and in the header, not buried in here: switching location can change every price in the cart. ## The detail about prices The rule I repeat on every project: if the visitor is not B2B, the price **must not reach the HTML**. The Liquid condition on `customer.b2b?` is the right way; hiding it with CSS leaves the price in the page source, visible to anyone who looks and to any crawler. ## What does not depend on the plan Almost everything above is built in the theme and works without Plus. What needs [Shopify Plus](/en/glossary/shopify-plus/) is custom-written account extensions, because they ship inside a custom app. It is worth knowing which part of the budget depends on the plan before promising it. ### FAQ **What does a B2B buyer actually want in their account?** Four things, in order: reorder the last order, see what is outstanding and when it is due, download invoices, and switch location. The rest is decoration. **Do I need Plus for customer account extensions?** An extension written specifically for your store ships inside a custom app, and that requires Shopify Plus. A good share of the value, though, is achieved in the theme and without Plus. **Can prices be hidden until the buyer logs in?** Yes, and it is the right thing to do: with the customer.b2b? condition the price never reaches the HTML of someone without a session. Hiding it with CSS does not count, because it is still in the page source. --- ## Shopify integrations with ERPs and external systems URL: https://nicolasmateos.com/en/services/erp-integrations/ Service: Shopify integration with external systems Updated: 2026-10-21 I connect Shopify to the ERP, warehouse or PIM you already run: inventory, prices, customers, orders and invoices. The hard part is never GraphQL, it is deciding who wins when both sides change the same field. ## The three decisions to make before any code None of them is technical, and all three are expensive if left undecided: **Which system owns each field.** If the ERP and Shopify can both modify inventory, you have to decide the direction and write it down. Almost every integration I have seen break had left this half-decided. **What happens to what fails.** A rejected line cannot fail silently. You need retries, a log and somebody who looks at it. Without that, the failure shows up three weeks later as "we're missing an order". **How things are identified.** The ERP's reference and Shopify's catalog SKU almost never match. That mapping has to live somewhere, and the usual home is a [metafield](/en/glossary/metafields/). ## What the platform brings The [Admin GraphQL API](/en/glossary/admin-graphql-api/) has a budget per query and per time window: a sync that walks 20,000 variants one at a time eats it, and the same sync in batches does not. For large loads there are bulk operations, which take longer to write and are the difference between a nightly sync that finishes and one that stops halfway. And in the other direction, webhooks: Shopify tells you about a new order instead of you asking every five minutes. ## In B2B there is one more field A wholesale portal adds companies, their locations and their price tier. If the ERP decides which tier a customer belongs to, that assignment gets synced too — and it is worth deciding who may change it from Shopify: usually, nobody. ### FAQ **Custom app or an off-the-shelf connector?** If your ERP is one of the big ones and your data model is standard, an off-the-shelf connector is cheaper and somebody else maintains it. A custom integration earns its place when the model is not standard: B2B pricing per company, inventory per warehouse, SKUs that do not match. **Can a Shopify Function query the ERP?** No. A Function makes no network calls. If a cart rule depends on ERP data, that data is synced into a metafield first and the Function reads it from there. **How often does it sync?** It depends on the field. Inventory, as close to real time as the ERP can stand, with webhooks in the Shopify-to-ERP direction. Prices and catalog, in batches overnight, which is when you can retry without rushing. --- ## Shopify GEO consulting: SEO and AI visibility URL: https://nicolasmateos.com/en/services/geo-shopify/ Service: Shopify GEO consulting and implementation Updated: 2026-11-05 GEO for Shopify improves how search engines and AI assistants can find, understand and cite a store. I am Nicolás Mateos: I provide audits, content and technical implementation to connect your products and brand with real buying questions, supported by a baseline and measured outcomes. ## What the Shopify GEO service includes Consulting starts with the questions buyers ask before choosing a product or supplier. The audit maps each intent to an existing URL to improve the primary answer and avoid pages competing for the same query. | Area | Work | Deliverable | | --- | --- | --- | | Diagnosis | Review products, collections, guides, competitors and Spanish or English queries | Query and URL map with prioritised issues | | Technical SEO | Check HTML, crawling, indexability, canonicals, sitemaps, languages and performance | Evidence and agreed fixes for each issue | | Answer content | Definitions, selection criteria, tables, FAQs and usage limits with sources | Revised pages and self-contained answer blocks | | Entities and catalogue | Review identity, authorship, structured data and consistency with visible products | Validated markup and consistent product data | | Measurement | Record responses, mentions, citations, traffic and enquiries | Baseline and comparable tracking by engine and language | ## How GEO applies to a Shopify catalogue A useful product page explains what the product is, who it is for, materials, dimensions, compatibility and limitations when those facts are available. Collections help buyers choose; guides answer questions a product page cannot cover. Shipping and return policies must be clear and consistent with actual operations. I inspect the HTML and markup already generated by the theme and apps before adding another block. The goal is to avoid duplicate entities, conflicting prices or invented attributes. Where theme changes are needed, I can handle the [Shopify implementation](/en/services/custom-shopify-themes/); loading issues can be scoped through a [performance audit](/en/services/core-web-vitals/). For B2B, the audit separates public information from private terms. GEO work must not expose negotiated prices, restricted catalogues or customer data to make crawling easier. ## Method: diagnosis, implementation and tracking 1. **Define the opportunity.** We agree priority products or services, countries, languages and buying queries. We record which URLs appear and which sources are cited before editing content. 2. **Prioritise with evidence.** Each issue includes a URL, observed problem, proposal and acceptance criterion. Technical blockers, editorial improvements and team dependencies are tracked separately. 3. **Implement and verify.** We review visible copy, internal links, metadata, structured data and language equivalence. Theme fixes are tested before publication. 4. **Compare using the same method.** We repeat the agreed queries, save responses and analyse traffic and enquiries where data exists. Reporting separates observed changes from hypotheses about their cause. ## Evidence you can inspect This portfolio provides an implementation you can inspect: [services](/en/services/), a [glossary](/en/glossary/), bilingual pages, an [assistant index](/llms.txt) and [reference text with attribution URLs](/llms-full.txt). These demonstrate architecture and publishing, rather than a case of increased sales attributed to GEO. My [Shopify development work](/en/about/) since 2021 connects editorial proposals with theme changes and validation. I do not present client GEO results unless they are documented and authorised. ## How we measure AI visibility The record includes date, exact query, language, engine, visible model, geographic context, saved response, brand mention and cited URLs. A sample of web searches is not a substitute for testing an assistant, and a mention without a link is not a citation. We track mentions, citations, referred visits and enquiries with a declared source separately. Where Search Console, analytics or enquiry data are unavailable, reporting states that limitation. We do not attribute sales or causality to an isolated screenshot or set a universal deadline for earning citations. ## Foundations and sources The approach relies on useful content, technical access and verifiable information. [Google documentation on AI features](https://developers.google.com/search/docs/appearance/ai-features) explains their relationship with SEO foundations. The [Shopify SEO guide](https://help.shopify.com/en/manual/promoting-marketing/seo) provides a reference for store reviews. No markup can force an engine to recommend a brand. ## Request a Shopify GEO diagnosis Send your store URL, markets, languages and priority categories. I will define the audit scope, required access and proposed deliverables before implementing changes. [Request a Shopify GEO audit](/en/contact/#geo). ## Concepts and criteria before commissioning work Read the definitions of [GEO](/en/glossary/geo/) and [AEO](/en/glossary/aeo/), the [SEO versus GEO comparison](/en/compare/seo-vs-geo-shopify/) and [how to measure results](/en/questions/measure-shopify-geo/). ### FAQ **What is GEO for a Shopify store?** GEO stands for Generative Engine Optimization: improving store information and technical access so generative engines can understand and cite it. On Shopify this covers products, collections, guides, brand identity and theme HTML. **How do SEO, AEO and GEO differ?** SEO addresses search visibility; AEO organises clear answers to questions; GEO addresses a brand or source appearing in AI-generated responses. They share foundations and are addressed together, with separate metrics. **Can you guarantee ChatGPT will recommend my store?** No. Engines choose their sources and responses vary with the query and context. This service delivers verifiable improvements and measurement; an observed citation does not guarantee future recommendations or sales. **How much does a Shopify GEO audit cost?** Pricing depends on catalogue size, markets, languages, technical condition and implementation scope. You can commission the diagnosis first and then decide which improvements to implement; there is no universal price or mandatory retainer. **Do I need an app or an llms.txt file?** The audit checks content, HTML and access barriers first. An app or llms.txt file can be assessed as an addition, but its presence alone does not demonstrate indexing, citations or improved rankings. --- ## Shopify Scripts to Functions migration URL: https://nicolasmateos.com/en/services/scripts-to-functions-migration/ Service: Shopify Scripts to Shopify Functions migration Updated: 2026-10-21 Shopify Scripts stopped executing in June 2026. If your store had discounts, shipping or payment methods driven by a Script, that rule is not being applied today. I audit what each Script did, what is still needed, and rewrite it as a Function. ## The order I work in **1. Inventory.** Which Scripts existed, what each did and when it was last touched. On stores with a few years behind them there is usually one Script nobody remembers asking for. **2. Culling.** For each rule, the question is whether it is still needed and whether the platform now covers it. The three most common Scripts were a discount by customer tag, hiding shipping based on the cart, and reordering payment methods. In B2B, two of those are solved without code today: a tier discount is a [catalog](/en/glossary/b2b-catalog/) and a case-pack minimum is [quantity rules](/en/glossary/quantity-rules/). **3. Rewrite.** What survives gets written as a [Function](/en/services/shopify-functions/), with a tight input query and tests. **4. Verification.** It deploys to a development store and runs against the carts that actually matter: the big order, the one mixing tiers, the one sitting right on the minimum. ## What changes versus a Script Three things, and they are what force a redesign rather than a translation. A Script saw the whole cart; a Function receives only the fields its input query asks for. A Script had no visible budget; a Function does, and that rules out walking the catalog inside the code. And a Function deploys as an app, with versions and configuration, instead of being text saved in the admin: more work the first time, far less risk afterwards. ## The plan requirement A custom-written Function ships inside a custom app, and that can only be installed on stores with [Shopify Plus](/en/glossary/shopify-plus/). If you had Scripts you already have Plus, so this point rarely blocks this particular migration. ### FAQ **What happens if I do not migrate?** Nothing visible, and that is the problem. Scripts stopped executing in June 2026: there is no error, the rule simply is not applied. A customer-tier discount that quietly stopped applying shows up in your margin, not in your dashboard. **Is it just translating Ruby to JavaScript?** No. The model is different: a Function declares in its input query what data it needs and receives only that, it has an instruction budget, and it deploys as an app with versions. It is a short redesign, not a translation. **How many of my Scripts will I actually need?** In the projects I have seen, half. Several of the most common rules are solved without code today: a tier discount is a B2B catalog and a case-pack minimum is quantity rules. That comes out of the audit before anything is written. --- ## Shopify Functions development URL: https://nicolasmateos.com/en/services/shopify-functions/ Service: Shopify Functions development Updated: 2026-11-05 I write discount, cart validation, line transformation, shipping and payment Functions in JavaScript or Rust, with a tight input query and tests. If your business rule does not fit an App Store app, it fits here. ## When a Function is the answer When the rule is yours. The three cases that reach me most: - **Validations that block checkout.** Full cases, a minimum per company, not mixing price tiers, a product that requires another. The platform ships per-variant minimums and, since April 2026, a single order value minimum in Checkout Blocks; nothing that changes with the company or with what is in the cart. - **Discounts no app calculates the same way.** Tiered by product family, by company location, mutually exclusive combinations. - **Conditional shipping and payments.** Hiding cash on delivery above a value, reordering methods by weight, hiding a carrier for one zone. If what you need is one of the standard discounts, an App Store app is cheaper and somebody else maintains it. I will tell you if that is the case. ## How I write them What separates a Function that holds up from one that fails on the first large order is not the logic: it is the input. A Function has an execution budget on the order of 11 million instructions and a 128 kB cap on its input. On a ten-line cart that is invisible. On a 200-line wholesale order pad, every extra field you ask for is multiplied by 200. So the input query asks for exactly the fields the code reads, with aliases so metafields arrive under a readable name. The second detail, the one that costs two days of support when forgotten: `buyerJourney`. A validation that blocks at every step stops the buyer from typing 7 on the way to 12. You block at checkout, not while the cart is being edited. ## What you can see before hiring me A complete validation Function, with its input query and its tests, is published in [shopify-checkout-lab](https://github.com/NicolasShopiDev/shopify-checkout-lab), and on the [home page](/en/) there is a Checkout Lab where you can change its configuration and watch what stops working. It is the same file that ships to a store. ## How we work First you describe the rule in words, with a real case and an edge case. If the rule can be solved without code (a [catalog](/en/glossary/b2b-catalog/), some [quantity rules](/en/glossary/quantity-rules/)), I say so and you save the development. If not, I write the Function with its tests, we deploy it to a development store and we try it against your ugliest cart before touching production. ## What we need to quote your rule Prepare your current plan, the rule in one sentence and three anonymised examples: a valid order, one that should be rejected or changed, and an exception. For each example, explain the expected result and where the data comes from. This lets us define what belongs in the Function and which integration work would be quoted separately. ## What we review before accepting delivery The proposal should identify the included rule, exceptions, required data and agreed test cases. At handover, we review those results in the development store and the documentation for locating the code, changing configuration and understanding limitations. The [Checkout Lab](/en/#lab) is a technical demonstration with examples, not a client case study with attributed business results. To scope your own rule, [tell me about those three cases](/en/contact/) before choosing the implementation. ### FAQ **Do I need Shopify Plus for a custom Function?** Yes. Only stores on Shopify Plus can install custom apps containing Shopify Functions. On Basic, Grow and Advanced you can use functions that ship inside a public App Store app, but not one written for your store. **JavaScript or Rust?** JavaScript for most cases: it reads, it tests and anybody can maintain it. Rust when the function walks very large carts and the instruction budget gets tight. I decide with the case in front of me, not by default. **Can a Function query my ERP?** No. A Function makes no network calls: it only sees the data its input query asks for. If the rule depends on external data, that data has to be in a metafield first, and that is integration work. **What exactly do you deliver?** The custom app with the Function, its input query, its unit tests, the admin configuration and a short document saying what it does, what data it needs and how to change it. The code is yours and it is reviewable. --- ## Shopify Markets and international selling URL: https://nicolasmateos.com/en/services/shopify-markets/ Service: Shopify Markets setup and development Updated: 2026-10-21 Selling in several countries from one store: markets with their currency, language and taxes, a picker that does not break the cart, and hreflang set up so your versions stop competing with each other. ## What gets decided before anything is built [Shopify Markets](/en/glossary/shopify-markets/) groups countries with their currency, languages, taxes and price adjustments. The configuration is the easy part. What really has to be drawn first is the overlap with pricing, and in B2B that is critical: without Plus, a [catalog](/en/glossary/b2b-catalog/) is assigned to a B2B market, not to a company, and you only get three active ones. The example that comes up in almost every meeting: if the tiers are "wholesale Spain", "wholesale Portugal" and "distributor", all three are spent and there is no room for key accounts. Half an hour at a whiteboard saves the redesign. ## The front-end work - **The country and language picker** has to be visible and must not reset the cart when it changes. - **Per-market rounded prices** change what the product page shows. If the theme caches prices in JavaScript, they have to be invalidated on a market change, or the buyer sees one price and pays another. - **Translated strings** that live in the theme rather than the content: shipping notices, form labels, error messages. ## International SEO, where the traffic gets lost Each version needs its `hreflang`, pointing at its equivalents and at itself, with an `x-default`. A store with four markets and a single `hreflang` competes with itself, and Google picks for you — usually badly. The second common mistake: redirecting by IP. If a German buyer cannot see the Spanish version, and Google's crawler is not allowed to see every version either, only one gets indexed. You detect the country and **offer** the switch, you do not force it. ### FAQ **One store per country or Markets?** Markets, unless each country has a different catalog, tax setup and team. Several stores mean several themes to maintain and several inventories to reconcile; most projects that start that way end up consolidating. **How does Markets affect a B2B portal?** Far more than it looks. Without Shopify Plus, B2B catalogs are assigned through B2B markets, so your price segmentation has to fit inside your geographic segmentation, with a cap of three active catalogs. **Subfolder or a domain per country?** Subfolder in almost every case: it concentrates domain authority and it is less infrastructure. A country domain earns its place when the brand needs to be perceived as local and that is worth more than the accumulated authority. --- ## Migrating to Shopify from another platform URL: https://nicolasmateos.com/en/services/shopify-migration/ Service: Migration to Shopify Updated: 2026-10-21 Migrations to Shopify from WooCommerce, PrestaShop, Magento or a custom build, with the front-end rebuilt and — the part that hurts most when skipped — the URLs redirected one by one. ## The order that causes fewest surprises **1. URL inventory before anything else.** Before design comes up, I pull the list of URLs with traffic and with inbound links. That list decides the new store's structure, not the other way round. **2. Data model.** What was a product, what was a variant and what was a custom field on the old platform. Whatever does not map onto Shopify natively goes into [metafields](/en/glossary/metafields/) or metaobjects, and that is decided before importing, not after. **3. Catalog and history.** Products, variants, images, customers and orders as history. **4. Front-end.** On a paid theme or a [custom one](/en/services/custom-shopify-themes/), with the sections your team will actually use. **5. Redirects, one by one.** Every URL with value to its equivalent. Not to the home page: to its equivalent. **6. Verification after launch.** A crawl of the new site looking for 404s and redirect chains, plus tracking rankings over the following weeks. ## What gets forgotten and then costs The old platform's custom features. A PrestaShop module or a WooCommerce plugin that spent years doing something nobody remembers asking for. If it is not inventoried before the migration, it shows up the day after launch, usually phrased as "but we used to be able to...". How I reduce that: list the features with the team that deals with customers, not only with whoever manages the website. The things that really matter are known by whoever takes the calls. ### FAQ **Will I lose rankings?** Not if the redirects are done properly. Traffic loss in a migration almost always comes from the same thing: old URLs landing on a 404 or all redirected to the home page. Every URL with traffic or links has to go to its specific equivalent. **Can old orders be migrated?** They can be imported as history, without real payment or fulfilment state. That is enough for the buyer to see what they bought and for reporting; it is not enough to process returns on those orders. **How long does it take?** It depends on the catalog and on how many custom features existed. What is never fast is the URL inventory and the redirect map, and that is exactly the part you cannot cut. --- ## A freelancer vs An agency URL: https://nicolasmateos.com/en/compare/freelancer-or-agency-for-shopify/ Updated: 2026-10-21 Facts checked: 2026-10-21 Verdict: A freelancer for a project with clear scope and one specific specialism: you talk to whoever writes the code and there is no layer in between. An agency when you need several disciplines at once (design, campaigns, content) or when your company cannot depend on one person for years. | Criterion | A freelancer | An agency | | --- | --- | --- | | Who you talk to | Whoever writes the code | A project manager | | Specialisation | High and specific | Broad, with varying levels per profile | | Continuity risk | One person; mitigate it with the repository | Lower, if they document and rotate well | | Several disciplines at once | You coordinate several freelancers | Included | | Speed on small changes | High: no layer in between | Depends on the process | | Cost per development hour | Generally lower | Higher; it includes the structure | ## The real risk of each, said plainly The freelancer risk is obvious: it is one person. If they disappear, the project loses its memory. That is mitigated with three specific things, and all three are yours by contract: the code in a repository that is **yours** from day one, changes in files of their own rather than scattered through the theme, and the decisions written down somewhere. The agency risk is less visible: distance. You talk to whoever manages, not whoever writes, and on technical projects that introduces a translation step in every iteration. It also happens that the profile shown in the proposal is not the one who ends up touching your store. ## The hybrid case, which is the most common and nobody mentions Plenty of brands work with an agency for design, content and campaigns, and with a specialist for the hard technical part. I work that way myself: since October 2024 I have been the sole front-end developer at a B2B-focused Shopify Plus agency whose client storefronts add up to over €36M in annual GMV, while also running direct projects. It is the combination that works best when there is an agency that already knows the brand and a technical piece that needs specialisation: B2B, [Functions](/en/glossary/shopify-functions/), checkout or performance. ## How to decide, in one sentence If you can write the scope on one page and the problem is technical, a freelancer. If the problem is "we need to grow and we do not know where to start", an agency. And if you already have an agency and what is missing is a specialism, do not change agency: add the specialist. The [six questions worth asking before hiring](/en/questions/what-to-ask-a-shopify-developer/) apply equally to both. --- ## Native B2B vs A wholesale app URL: https://nicolasmateos.com/en/compare/native-b2b-or-wholesale-app/ Updated: 2026-10-21 Facts checked: 2026-10-21 Verdict: Native B2B, by default and on any plan that supports it: the price arrives at the theme already resolved instead of being recalculated on top, with no monthly fee and no third-party dependency. A public app only wins when you need per-account discounts and do not have Plus, or when the app brings the whole flow and its model suits you. | Criterion | Native B2B | A wholesale app | | --- | --- | --- | | How the price is calculated | In the platform; reaches the theme already resolved | On top, by the app, usually in the cart | | Risk of showing one price and charging another | No: the HTML price is the catalog price | Yes, if the app applies the discount later | | Per-account pricing without Plus | No: catalogs are assigned per market | Yes, it is their main use case | | Recurring cost | None beyond the plan | A monthly fee per store | | Order flow (table, SKU search) | Not included: it is front-end work | Depends on the app, and in its design | | What happens if it is uninstalled | Not applicable | Prices go, and sometimes the script keeps loading | ## What changed, and why the question is new For years, selling wholesale on Shopify meant installing an app. Today Shopify's documentation lists B2B on Basic, Grow, Advanced and Plus, and excludes it only from Starter and Retail. That turns the app, in most cases, into a layer you no longer need. The technical difference has a very practical consequence: with native B2B, the [catalog](/en/glossary/b2b-catalog/) price is **already resolved** when the theme asks for it. With an app that calculates the discount in the cart, there is a window where the buyer sees one price and pays another, and that window is the source of half the support tickets on a wholesale portal. ## Where an app still wins One case, and it is specific: **a negotiated price account by account without Shopify Plus**. Without Plus, catalogs are assigned to B2B markets rather than companies, so a per-account list leaves two routes: move to Plus or use a public app. If the plan upgrade is not in the budget, the app is the right answer. The second case is about the calendar rather than the technology: if you need the portal live next week and the app brings the whole flow with its own design, it can work as a bridge. It is worth knowing it is a bridge. ## The mistake that costs money Paying a monthly app fee expecting it to solve the order flow. Almost everything people ask a wholesale app for is not pricing: it is a per-variant [order table](/en/glossary/quick-order/) with stock, SKU search, quantity rules on the field itself, reordering the last order. That is front-end work on the theme, it works on any plan with B2B, and no pricing app brings it ready-made for your brand. It is where I have seen the most budget wasted: a monthly fee covering 20% of the problem, with the other 80% still missing. --- ## A paid theme vs A custom theme URL: https://nicolasmateos.com/en/compare/paid-or-custom-shopify-theme/ Updated: 2026-10-21 Facts checked: 2026-10-21 Verdict: A customised paid theme, in the large majority of projects, and I say that even though it bills less: you launch sooner, a vendor maintains it, and the budget goes to what converts. A custom one earns its place when the paid theme has been modified so much that updating is impossible, or when the brand needs something no theme in the store does. | Criterion | A paid theme | A custom theme | | --- | --- | --- | | Time to launch | Short | Long | | Updates | Published by the theme author | Yours, or whoever wrote it | | Starting performance | Good or middling, depending on the theme | Whatever you decide; you only pay for what you use | | Sections for your team to build pages | The theme’s, generic | Your business’s | | Risk of getting stuck | Low if changes live in their own files | Depends who documented it | | Up-front cost | Lower | Higher | ## What you are actually buying in a theme It is not the design. It is what your team will be able to do without calling anybody. Two themes can look identical on delivery day and, six months later, one builds a landing page in twenty minutes while the other turns every change into a quote. That depends on how the [sections and blocks](/en/glossary/sections-and-blocks/) are split, and it is exactly the part that does not show in a mockup or in a paid theme's demo. ## Why I recommend the paid one almost always Because most of the value is elsewhere. With a well-chosen paid theme, customised, you launch sooner, somebody else publishes the updates, and the budget you save goes to what moves the needle: order flow, speed, search. I have worked that way on large projects: Émolo's wholesale portal is built on the Prestige theme the store was already using, and the work went entirely into the order table and the per-company access. ## The two signals that it is time for a custom theme **1. The paid one can no longer be updated.** If the changes are scattered inside the original files and nobody remembers which, every update is a project. There comes a point where rewriting is cheaper than continuing to patch. **2. The brand needs something no theme does.** A configurator, a product page that is not a product page, a navigation model of its own. Not "we want something unique": something specific that no theme in the store solves. ## The third route, the one I use most A paid theme as the base, with everything custom in **new files and new sections**, never scattered through the originals. That way the theme stays updatable, your work is identifiable, and the next person to touch it knows where to look. It is the difference between [being able to update the theme](/en/questions/can-i-update-a-customised-shopify-theme/) and not. --- ## SEO vs GEO URL: https://nicolasmateos.com/en/compare/seo-vs-geo-shopify/ Updated: 2026-11-05 Verdict: Prioritise access barriers and missing product answers before splitting SEO and GEO into separate budgets. They share foundations; add AI response tracking once you have buying queries and a reproducible baseline. | Criterion | SEO | GEO | | --- | --- | --- | | Goal | Search result visibility | Mentions and citations in generated answers | | Shared work | Access, links, useful content and consistent data | The same foundations, with self-contained answers | | Measurement | Impressions, clicks, queries and conversions | Saved responses, mentions, cited URLs and enquiries | | Limitation | Indexing and rankings are not guaranteed | Citations and recommendations are not guaranteed | ## When to prioritise technical SEO If a collection is not indexable, links point to the wrong URLs or product content is absent from HTML, start with those issues. An additional editorial layer cannot fix an access barrier. Review languages, canonicals and sitemaps before multiplying pages. ## When to add GEO tracking Once you can define relevant buying questions and save comparable responses, observing which brands and sources appear becomes useful. A store with incomplete product data needs to complete its information first; a store with solid information can investigate unanswered questions. ## How to allocate a budget Commission a diagnosis connecting each query, URL, issue and deliverable. Separate theme fixes, content review and measurement. Avoid paying twice for the same fix because it appears under two acronyms. [Google Search Central](https://developers.google.com/search/docs/appearance/ai-features) relates AI features to SEO foundations. See the [measurement method](/en/questions/measure-shopify-geo/) and request a [Shopify GEO and SEO audit](/en/services/geo-shopify/). --- ## Shopify vs WooCommerce URL: https://nicolasmateos.com/en/compare/shopify-or-woocommerce/ Updated: 2026-10-21 Facts checked: 2026-10-21 Verdict: Shopify if you want to sell rather than administer: the checkout, the hosting, the updates and payment compliance are not your problem. WooCommerce if you need total control of the code, or the store is a small part of a content site already living in WordPress, and you have somebody to maintain it. | Criterion | Shopify | WooCommerce | | --- | --- | --- | | Hosting and updates | Included; no server to maintain | Yours: server, versions, backups | | The checkout | Shopify’s; you extend it, you do not rewrite it | Entirely yours, maintenance included | | B2B / wholesale | Native on Basic, Grow, Advanced and Plus | Via plugins; you choose the model | | Customisation ceiling | High in the storefront, bounded at checkout | None; you can change anything | | Who fixes an outage on a Saturday | Shopify | You or your supplier | | Cost | Predictable plan fee and transaction costs | Hosting, plugins and maintenance hours | ## The right question is not technical Both platforms sell online perfectly well. The difference that actually decides is **whose problem it is when something breaks**. On Shopify, the checkout, the hosting, the scaling and payment compliance belong to Shopify. On WooCommerce they belong to you, and that is not a flaw: it is the price of total control. The mistake is choosing WooCommerce for the control and then having nobody to exercise it. ## Where WooCommerce still wins - **When the store is a small part of a content site.** A publication, a community, or a project with hundreds of articles already in WordPress that sells something on the side. - **When you need to change the buying process in a way Shopify does not allow.** [Shopify's checkout](/en/glossary/checkout-extensibility/) extends at specific points; it is not reordered or laid out freely. - **When the data model is genuinely strange.** Products that are not products, calculations that are not prices. ## Where Shopify wins, which is the usual case When the business is selling. There is no server to size for a campaign, the checkout has been tested by millions of orders, and what used to be a wholesale plugin is now [native B2B](/en/glossary/shopify-b2b/) on nearly every plan. And there is one advantage that rarely makes the comparison tables: on Shopify, maintenance cost tends towards zero when nobody touches the store. On WooCommerce, an unmaintained store degrades by itself, because PHP, WordPress and the plugins keep moving. ## If you are considering migrating The risk in a migration is not the data: it is the URLs. Traffic loss almost always comes from old addresses landing on a 404 or all redirected to the home page. The URL inventory comes first, before design is discussed, and it is the part you cannot cut. --- ## Shopify Plus vs Shopify Advanced URL: https://nicolasmateos.com/en/compare/shopify-plus-or-advanced/ Updated: 2026-10-23 Facts checked: 2026-10-23 Verdict: Advanced, unless you tick one of these four: more than three B2B price lists actually in use, a negotiated price per account, different catalogs per branch, or Shopify Functions written for your store. If you tick none, the budget for the plan upgrade goes further spent on order flow. | Criterion | Shopify Plus | Shopify Advanced | | --- | --- | --- | | Active B2B catalogs | Unlimited | 3 in total, counting all B2B markets | | Catalog assignment | Directly to a company or a specific location | Through B2B markets; companies inherit it | | Custom Functions | Yes: can install custom apps containing Functions | No: only Functions shipping inside a public app | | Checkout | Extensions and Functions written for your store | Editor and public apps | | Quantity rules and volume pricing | Yes | Yes, the same as on Plus | | Companies and locations | No company limit; 10,000 locations per company | Same as Plus | ## The row that decides it, and it is not the one people look at Of the whole table, the one that settles 80% of cases is the first: **three active catalogs** on Advanced, unlimited on Plus. And the way to use it is not technical, it is arithmetic. Take last year's orders and count how many different price lists were **actually** used. Not the ones in the sales PDF. I have seen lists of eight tiers that, once the orders were checked, were two and one exception. If the count is three or fewer, Advanced is enough and the conversation ends. ## The second row is the one that surprises people Assignment. Without Plus, a [catalog](/en/glossary/b2b-catalog/) is not plugged into a company: it is plugged into a B2B market and the companies in that market inherit it. The consequence is that **your price segmentation has to match your geographic segmentation**. The example that comes up in almost every meeting: if your three tiers are "wholesale Spain", "wholesale Portugal" and "distributor", they are spent and there is no room for key accounts. Half an hour at a whiteboard before choosing a plan saves the redesign afterwards. ## What is not a reason to move to Plus - **"We want to customise the checkout."** If what you want is colours, a logo, a font or a notice, that is the editor and public apps, on Advanced. - **"We are going to grow a lot."** Plus can be bought the day it is needed. The wall appears in the number of price lists long before the number of orders. - **"We need volume discounts."** They are on Advanced, inside the catalog. ## What is Your own [Functions](/en/glossary/shopify-functions/). Only stores on Plus can install custom apps that contain them. And that is the difference that breaks the most quotes mid-project: with a public app you adapt to its data model, with your own Function you set the model. If your cart rule looks at the whole order (a different minimum per company, not mixing tiers, a product that requires another), there is no way to do it without Plus. The exception is one order value minimum for every B2B buyer: since April 2026, Checkout Blocks enforces it on Advanced too. --- ## Can I customise the Shopify checkout? URL: https://nicolasmateos.com/en/questions/can-i-customise-shopify-checkout/ Updated: 2026-10-21 Facts checked: 2026-10-21 Answer: Yes, but within specific limits. You can change the logo, colours, fonts and block order from the editor, add content and fields with extensions at the allowed points, and change discounts, shipping and payments with Functions. What you cannot do is freely reorder the checkout steps or lay it out like a normal page. ## What you can do, in order of difficulty **No code and no Plus.** Logo, colours, fonts and block order from the checkout editor. It is more than people assume, and it covers what most brands mean when they say "we want the checkout to feel like ours". **With a public app.** Notices, upsells, extra fields, tracking. There are App Store apps for nearly all of this and they work on plans without Plus. **With custom development, and this is where Plus comes in.** Your own UI extension or a [Function](/en/glossary/shopify-functions/) written for your store ship inside a custom app, and that can only be installed with [Shopify Plus](/en/glossary/shopify-plus/). ## What you cannot do, and it is worth saying early - Reorder or merge the checkout steps. - Inject arbitrary JavaScript into the payment page. - Lay the checkout out freely, as if it were a theme template. - Edit `checkout.liquid`. That stopped being the route; what lived there gets rebuilt with extensions and Functions. If a quote or a mockup assumes any of those four, the quote is wrong. Better to know that before showing it upstairs than after. ## What actually moves conversion in B2B On a wholesale portal, the two changes that make the biggest difference are not visual. The first is stating the **payment terms** where the buyer sees them: if they pay in 60 days, saying so in the cart and at checkout cuts abandonment more than any trust badge. The second is letting them enter a **purchase order number** and having that reference reach the order, the invoice and the ERP. Both fit in an extension, and both are the kind of thing buyers thank you for out loud. --- ## Can I update a Shopify theme that has been customised? URL: https://nicolasmateos.com/en/questions/can-i-update-a-customised-shopify-theme/ Updated: 2026-10-21 Facts checked: 2026-10-21 Answer: It depends where the changes live. If they are in new sections and files of their own, the update is viable and only the contact points need reviewing. If they are scattered inside the theme’s original files, updating means redoing each change one by one, and that is a project rather than an update. ## Why some themes can be updated and others cannot Shopify does not apply updates on top of a theme you have edited: what happens is that the new version gets installed and the changes get carried over. So the real question is not technical, it is archaeological: **where are your changes**. Two stores with the same amount of customisation can be in opposite situations. In one, everything custom lives in three new sections, a `custom.css` and a `custom.js`; updating means installing, moving those files and reviewing four touch points. In the other, there are stray conditions inside ten of the original theme files and nobody remembers which; there, updating means redoing it. ## How to tell which one you are in Without looking at the code, three fairly reliable signals: - **Is there a stylesheet of your own**, or was the CSS edited directly in the theme's? - **Are the new features sections** that can be added and removed from the editor, or are they embedded in the templates? - **Is it in version control?** If the repository exists, you can see exactly what was touched. If the only place the theme lives is the admin, the answer is that nobody knows. ## How I leave it so this does not happen When I customise, everything of mine goes into new files and new [sections](/en/glossary/sections-and-blocks/), and the places where an original file has to be touched get written down. It is not about elegance: it is so the next update costs an afternoon instead of a quote. And where an original file genuinely has to be touched, the change is kept as small as possible: one line calling something of mine, rather than twenty of my lines inside their file. ## If you are already in the bad case You do not have to rebuild the whole theme at once. What works is extracting the changes into your own files gradually, starting with the ones that get touched most. A few months later the theme is updatable again, and the store never stopped. --- ## Can I use Shopify Functions without Shopify Plus? URL: https://nicolasmateos.com/en/questions/can-i-use-shopify-functions-without-plus/ Updated: 2026-10-23 Facts checked: 2026-10-23 Answer: Only the ones that ship inside a public App Store app. A Function written specifically for your store lives inside a custom app, and only stores on Shopify Plus can install custom apps containing Shopify Functions. ## The difference that matters when quoting It is a detail almost nobody mentions and it decides entire projects: with a public app you adapt to **its** data model, with your own [Function](/en/glossary/shopify-functions/) you set the model. If your rule is "10% off above €500", there are App Store apps that do it and somebody else maintains them. If your rule is "10% off above €500, except on product family X, and only for the Spanish locations, and not stacking with volume pricing", no public app is going to model it the same way — and that is where Plus stops being a preference. ## What you can do without Plus Rather more than it looks, and it is worth exhausting before changing plan: - **[Quantity rules](/en/glossary/quantity-rules/)** in the catalog: minimum, maximum and increment per variant. That is what forces full-case ordering, without a line of code. - **[Volume pricing](/en/glossary/volume-pricing/)**: price breaks by quantity inside the catalog. - **Native automatic discounts** for standard promotions. - **Public apps** that carry Functions inside them, for discounts the above cannot hold. Of the B2B projects that reach me asking for a Function, a good number are solved by the first two. ## When there is no alternative When the rule looks at the **whole cart** and changes with who is buying or what is in it. Quantity rules are per variant: they do not know whether you are mixing two price tiers, whether one product requires another, or whether this particular company reaches its own minimum. A single order value minimum for every B2B buyer has been a no-code setting in Checkout Blocks on every plan since April 2026. Everything else needs your own validation, which means a Function, which means Plus. If you want to see what one of those validations looks like from the inside before deciding, there is one published with its tests in [shopify-checkout-lab](https://github.com/NicolasShopiDev/shopify-checkout-lab) and you can poke at it on [the home page](/en/). --- ## Can I have a different price for each customer in Shopify? URL: https://nicolasmateos.com/en/questions/different-price-per-customer-in-shopify/ Updated: 2026-10-21 Facts checked: 2026-10-21 Answer: By customer tier, yes, and without Shopify Plus: up to three active B2B catalogs each with their own price list. A negotiated price account by account, natively, needs Shopify Plus, because it is the only plan that can assign a catalog directly to a company or one of its locations. ## The question before the question Before deciding whether you need per-account pricing, count your **real** price lists, with last year's orders in front of you rather than the sales PDF. I have seen lists of eight tiers that, once the orders were checked, were two and one exception. If the count comes to three or fewer, you fit on a plan without Plus and the conversation ends here. ## What a catalog gives you without Plus Three active [catalogs](/en/glossary/b2b-catalog/), counting all B2B markets together. Inside each one: - A fixed price per variant or a percentage off the whole price list. - [Quantity rules](/en/glossary/quantity-rules/): minimums, maximums and increments. - [Volume pricing](/en/glossary/volume-pricing/): the price drops past X units. That last one solves more cases than it looks. When somebody asks for a fourth catalog because "this customer buys much more", they are almost always describing a different quantity, not a different price. And a volume break has the side benefit of showing the buyer the incentive to move up a step. ## The wall, and how it shows up Without Plus, a catalog is not assigned to a company: it is assigned to a B2B market and the companies in that market inherit it. That has a consequence worth drawing on a whiteboard before choosing a plan: your price segmentation has to match your geographic segmentation. If your tiers are "wholesale Spain", "wholesale Portugal" and "distributor", all three are spent and there is no room for key accounts. ## The alternatives if you do not want Plus In order of the technical debt they leave: arrange the three catalogs as three clean tiers and move each company into the market it belongs to; use volume breaks for the differences that are really about quantity; and, if per-account discounts are genuinely required, a public App Store app. What is **not** an option without Plus is a [Function](/en/glossary/shopify-functions/) written for your store with your own discount rules. --- ## Do I need a new theme to sell B2B on Shopify? URL: https://nicolasmateos.com/en/questions/do-i-need-a-new-theme-to-sell-b2b/ Updated: 2026-10-21 Facts checked: 2026-10-21 Answer: No. A wholesale portal can be built on the theme you already have, a paid one included: the catalog price arrives at the theme already resolved, and access is decided with a Liquid condition on customer.b2b?. What is usually needed is front-end work on that theme, not starting over. ## Why you do not need to start over The part of B2B that looks hardest — every company seeing its own price — is not done by the theme. It is done by the platform: the catalog assigned to the company resolves the price before the theme asks for it. That leaves the theme with one decision, which is who sees prices and who does not. That means a well-built paid theme already works as a base. The wholesale portal for [Émolo](/en/projects/#emolo-b2b), a jewelry brand from Murcia, is built on top of the Prestige theme the store was already using. ## What does have to be added This is where the real budget of a B2B portal goes, and it has nothing to do with design: - **Deciding access** with a Liquid condition, in every place a price appears and not only on the product page. - **A per-variant [order table](/en/glossary/quick-order/)**, with stock and quantity per row, which is how a wholesale buyer orders. - **SKU search**, because a professional searches by reference rather than by product name. - **The catalog's quantity rules applied to the field itself**, with `min` and `step`, so the buyer is warned before typing rather than at payment. - **Reordering the last order**, the most used feature of any portal. ## When a new theme is the answer For the same reasons as in B2C, not because of B2B: when the paid theme has been modified so much that updating it is impossible, or when the brand needs something no theme in the store does. If neither applies, the budget goes much further spent on order flow than on rebuilding the whole front-end. --- ## Do I need an app to sell B2B on Shopify? URL: https://nicolasmateos.com/en/questions/do-i-need-an-app-to-sell-b2b-on-shopify/ Updated: 2026-10-23 Facts checked: 2026-10-23 Answer: No. B2B features are native on the Basic, Grow, Advanced and Shopify Plus plans: companies, locations, catalogs with their own prices, quantity rules and volume pricing all ship with the platform. An app is only needed for what the native model does not cover, and the first job is working out which part that is. ## What already ships with the platform For years, selling wholesale on Shopify meant installing a wholesale app or building a workaround with customer tags and automatic discounts. That changed: Shopify's documentation now lists B2B on Basic, Grow, Advanced and Plus, and excludes it only from Starter and Retail. Native means the wholesale price **arrives at the theme already resolved**: the front-end asks for the variant price and gets the one that belongs to the buyer's company. No app calculating anything in the cart, no discount applied at the end that the buyer does not understand. ## What people mistake for "I need an app" Almost everything people ask a wholesale app for is not pricing: it is **order flow**. A size table with stock and quantity per row, SKU search, [quick order](/en/glossary/quick-order/), reordering last month's order, hiding prices on screen. None of that is solved by a pricing app: it is front-end work on the theme, and it works on any plan with B2B. This is where most budget gets wasted: a monthly app that solves 20% of the problem gets paid for, and the other 80% is still missing. ## When you do need something more Three specific cases: 1. **Per-account discounts without Shopify Plus.** [Catalogs](/en/glossary/b2b-catalog/) are assigned per market, so a per-account list needs Plus or a public app. 2. **Cart rules that look at the whole order.** A different order minimum per company, not mixing price tiers. That is a Function, and a custom Function needs Plus. A single order minimum for every B2B buyer no longer does: since April 2026 it is a Checkout Blocks setting on every plan. 3. **Data that lives in your ERP.** A credit limit, a discount negotiated outside Shopify. That is an integration, not a catalog app. If you are in none of those three, the honest answer is that you do not need an app: you need somebody to build the order flow properly. --- ## How do I hide prices from visitors who are not wholesale customers? URL: https://nicolasmateos.com/en/questions/how-do-i-hide-prices-from-non-wholesale-visitors/ Updated: 2026-10-21 Facts checked: 2026-10-21 Answer: With a Liquid condition on customer.b2b? around every price, stock badge and buy button. The rule is that if the visitor is not a logged-in B2B customer, the price must not reach the HTML: hiding it with CSS or JavaScript does not count, because the price is still in the page source. ## The condition, and where it goes ```liquid {% if customer.b2b? %} {{ product.selected_or_first_available_variant.price | money }} {% else %} Log in to see prices {% endif %} ``` What matters is that this condition does not only belong on the product page. It has to be in **every** place a price reaches the HTML, and in a Shopify theme there are more of those than you would think: the collection card, search results, related products, the cart, the cart draft some themes print as JSON, the product structured data, and the Google Shopping feed if it is enabled. The failure I find most often in audits is exactly that: the product page is properly protected and the collection listing still shows the wholesale price to anyone. ## Why CSS is not enough If the price is printed and then covered with `display: none`, it is in the page source. Anyone can see it with "view source", any extension can read it, and a search engine can index it. On a wholesale portal that means a competitor can pull your entire price list in ten minutes without an account. The same goes for JavaScript solutions that delete the price on load: between the HTML arriving and the script running, the price is there — and in the source it is there permanently. ## The case of one company with several locations If the buyer can purchase for several [locations](/en/glossary/company-location/), knowing they are B2B is not enough: you have to know **which location** they are buying from, because the price tier can change. `customer.current_location` tells you, and the location picker is best kept visible in the header: switching location can recalculate the whole cart, and the buyer needs to notice. ## One extra that buyers ask for A button to hide their own prices on screen. It sounds odd until a buyer explains they are standing in the warehouse with their phone out and a retail customer next to them. It is solved with a preference in `localStorage` applied in the `head`, before the page paints. --- ## How much does a Shopify B2B portal cost? URL: https://nicolasmateos.com/en/questions/how-much-does-a-shopify-b2b-portal-cost/ Updated: 2026-11-05 Facts checked: 2026-11-05 Answer: The cost of a Shopify B2B portal depends on the plan, customer pricing, order flow and ERP integration. To compare quotes, separate the initial development from recurring fees and ask for a list of deliverables, exclusions and acceptance tests. ## The four things that move the price **1. The plan, which is a separate cost.** Basic, Grow and Advanced allow up to three active catalog assignments across active B2B markets. One catalog assigned to two markets counts twice; counting price lists alone is not enough. Plus removes this limit and supports direct catalog assignments to company locations, according to [Shopify's B2B catalog documentation](https://help.shopify.com/en/manual/b2b/catalogs/index), checked in November 2026. **2. How many price lists and how they are assigned.** Setting up [catalogs](/en/glossary/b2b-catalog/) with clean data differs from correcting SKUs, importing prices and handling customer exceptions. If you need [Functions](/en/glossary/shopify-functions/) in a custom app, Shopify requires Plus; public apps containing Functions can be used on any plan, with restrictions depending on the function. Source: [Shopify Functions availability](https://shopify.dev/docs/apps/build/functions), checked in November 2026. **3. The order flow.** This is where most of the real work sits and it is what is almost never in the initial quote: a per-variant [order table](/en/glossary/quick-order/) with stock, SKU search, quantity rules on the field itself, reordering the last order, a location picker. Each of those can be dropped, and dropping them changes the price more than the plan does. **4. Whether the ERP is involved.** A portal that reads inventory and prices from the ERP is a second project on top of the first. If nobody asks about the ERP on the first call, half the scope is missing. ## Three scopes with different costs These are examples for comparing proposals, not packages with fixed prices or timelines: | Scope | Deliverables to include in the quote | Excluded unless agreed | | --- | --- | --- | | Adapt the current theme | Wholesale access, price display and a purchase test with sample customers | New design, ERP sync and a custom order table | | Portal with quick ordering | The above, plus a variant order table, SKU search and quantity validation | ERP integration, historical migration and unspecified rules | | ERP-connected portal | Agreed order flow, data mapping, defined sync and error handling | Third-party connectors, licences and ongoing maintenance unless included | Agree on a test order before accepting the work: which customer signs in, which price they see, which quantities they can buy and where the order should appear. For an integration, also define how a failure is detected and recovered. ## Initial development and recurring expenses The quote should separate implementation and testing from the Shopify subscription, apps, connectors and support. I do not publish my own price range because the scope still needs defining; comparing a proposal with integration against one that only adapts the theme will not give you a useful price comparison. ## How to compare two quotes Check that both describe the same plan, markets, price lists, screens, integrations and tests. Also ask for code and documentation deliverables, included support and how changes are quoted. To scope your [Shopify B2B portal](/en/shopify-b2b-developer/), prepare your current plan, markets, an anonymised price list and order example, your ERP and the essential features. [Tell me about that scope](/en/contact/) so we can separate configuration, development and integration before quoting. --- ## How do you measure GEO results for a Shopify store? URL: https://nicolasmateos.com/en/questions/measure-shopify-geo/ Updated: 2026-11-05 Answer: Shopify GEO results are measured by comparing agreed buying queries before and after changes, saving responses and cited URLs by engine and language. Mentions, linked citations, visits and enquiries are tracked separately; no single metric proves that GEO caused sales. ## What to record for each test Save the date, exact query, language, engine, visible model, geographic context and complete response. Record the brand mentioned, cited URLs and competing sources. Keep conditions comparable and document any context changes. | Indicator | What it establishes | What it cannot establish | | --- | --- | --- | | Mention | The brand appears in the sample | A stable recommendation | | Linked citation | A URL is used as a source | A visit or sale | | Referred visit | Analytics records a visit from the assistant | All exposure without a click | | Enquiry with declared source | The person states how they arrived | Exclusive causality from the change | ## How to interpret before and after Repeat the query set and retain responses, including those that do not mention the store. Changing questions after seeing the outcome prevents an honest comparison. A conventional web search is not a substitute for testing the assistant. Engines and their sources change. Report sample size, observation period and missing data; do not turn one favourable screenshot into a universal visibility rate. ## What to ask a provider Ask for the test log, modified URLs, change dates and acceptance criteria. Without analytics or enquiry access, the report should state that it only measures the response sample. Before commissioning work, review the [differences between SEO and GEO](/en/compare/seo-vs-geo-shopify/) and the deliverables of [Shopify GEO consulting](/en/services/geo-shopify/). --- ## What should I ask a Shopify developer before hiring them? URL: https://nicolasmateos.com/en/questions/what-to-ask-a-shopify-developer/ Updated: 2026-10-21 Facts checked: 2026-10-21 Answer: Six: which live stores can I visit and what exactly did you do on them; which part of this needs no apps; which plan does this leave me on; how do you hand over the code and where does it live; what happens when something breaks in three months; and which of the things I asked for do you recommend I skip? ## The six questions, and what you are listening for **1. Which live stores can I visit, and what exactly did you do on them?** Not screenshots: URLs. And the second half of the question matters more than the first, because several people have worked on any given store. A good answer sounds like "this order table and the location picker"; a bad one sounds like "we handle this account". **2. Which part of this needs no apps and no code?** This is where you find out whether they know the platform or only their own trade. A lot of what gets sent to development in B2B is configuration: [quantity rules](/en/glossary/quantity-rules/), [volume pricing](/en/glossary/volume-pricing/), catalogs. Somebody billing you to build what already ships either does not know, or prefers not to. **3. Which Shopify plan does this leave me on?** If what you are asking for needs [Plus](/en/glossary/shopify-plus/) and nobody mentions it, you will find out at the end. It happens most with custom Functions and with per-account pricing. **4. How do you hand over the code, and where does it live?** The right answer includes a repository you have access to. If the only place the theme exists is your store's admin, your supplier is your backup. **5. What happens when something breaks in three months?** Do not look for an eternal guarantee: look for the question not surprising them. Somebody who has maintained stores will talk about theme updates, API versions and which part stays theirs. **6. Which of the things I asked for do you recommend I skip?** The most useful of the six. Somebody who says everything is a good idea will say yes to a fourth catalog you do not need and to a custom app that could have been a metafield. ## What I would answer To the first: [twenty projects with their URL](/en/projects/), and each entry says what I did. To the fourth: a repository of yours from day one. And on the sixth, the answer I give most often on a first call is that order flow pays off more than changing plan. --- ## Admin GraphQL API URL: https://nicolasmateos.com/en/glossary/admin-graphql-api/ Also called: Admin API, GraphQL Admin API Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: The Admin GraphQL API is the interface an app or an external system uses to read and write a Shopify store’s data: products, variants, inventory, orders, customers, B2B companies and metafields. It is the route ERP integrations and automations come in through. This is the API that matters when a project stops being "a store" and becomes "a store connected to what the company already had". It almost always arrives the same way: inventory and prices live in the ERP, and somebody has to get them into Shopify without typing. ## What to plan before writing code Three things, and none of them is GraphQL: - **The cost of queries.** The API has a budget per query and per time window. A sync that walks 20,000 variants one at a time eats the budget; the same sync done in batches does not. - **Who wins when both sides change.** If the ERP and Shopify can both modify inventory, you have to decide the direction and write it down. Almost every integration I have seen break had left that undecided. - **What happens to what fails.** A rejected line cannot fail silently. You need retries and somewhere to look. ## Bulk operations For importing or exporting a lot, the API has bulk operations: you start the query, wait, and collect a file with the result. It takes longer to write and it is the difference between a nightly sync that finishes and one that stops halfway. ## What it does not do It is not for reading a shopper's cart in the storefront: that is the [Cart API](/en/glossary/ajax-cart-api/). And it cannot be called from inside a Shopify Function. Documentation: [Admin GraphQL API](https://shopify.dev/docs/api/admin-graphql). --- ## AEO (Answer Engine Optimization) URL: https://nicolasmateos.com/en/glossary/aeo/ Also called: answer engine optimisation Updated: 2026-11-05 Definition: AEO is the optimisation of content to answer specific questions directly and clearly outside their original context. In Shopify it helps explain compatibility, use and buying terms; a well-written answer does not guarantee selection by a search engine or assistant. ## How to write a useful answer Answer in the opening sentences, name the product or category and state the condition limiting the answer. Follow with evidence, exceptions and the next step. A compatibility question needs models and requirements rather than a generic statement about quality. For example, “is it suitable outdoors?” needs approved use and its conditions where the manufacturer supplies those facts. Missing facts must be checked before publication. The answer must remain consistent across languages. ## FAQs and markup do not replace information FAQs help when they answer distinct questions left open by the main content. Repeating keywords or hiding answers exclusively in JSON-LD does not improve the explanation for buyers. AEO contributes to [GEO](/en/glossary/geo/). See [how we measure visibility](/en/questions/measure-shopify-geo/) and the scope of [Shopify GEO implementation](/en/services/geo-shopify/). --- ## Ajax Cart API URL: https://nicolasmateos.com/en/glossary/ajax-cart-api/ Also called: Cart API, cart.js, cart/update.js Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: The Ajax Cart API is the set of routes (/cart.js, /cart/add.js, /cart/update.js, /cart/change.js) a theme uses to read and change the cart without reloading the page. It accepts several lines in a single call and can return the rendered HTML of the sections that need updating. This is the API the whole order flow of a B2B portal rides on, and the one most often used wrong. ## update.js versus add.js `add.js` adds. `update.js` sets absolute quantities. For a wholesale order pad, `update.js` is the right one, and not as a matter of taste: with absolute quantities, the first order, the top-up and the correction are the same request. With `add.js` you have to know what was there before, and that is where the mismatches start. ```js await fetch('/cart/update.js', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ updates: { 4631: 12, 4632: 6 }, sections: 'cart-drawer,cart-icon-bubble' }), }); ``` ## The `sections` parameter This is the one that saves half the JavaScript. Instead of receiving the cart as JSON and redrawing it by hand, you ask for the theme's sections and get their HTML already rendered by Shopify, with prices formatted and strings translated. One `innerHTML` and you are done. ## Two details that cause tickets - **Response order.** Several parallel calls can land out of order: the last response is not necessarily the last state. One call per action, with the lines batched together. - **The bfcache.** If the user comes back with the browser's back button, the page can be restored with the old cart. Re-reading the cart on the `pageshow` event fixes it. Documentation: [Ajax Cart API](https://shopify.dev/docs/api/ajax/reference/cart). --- ## B2B catalog URL: https://nicolasmateos.com/en/glossary/b2b-catalog/ Also called: catalog, wholesale catalog, B2B price tier Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: A B2B catalog is the set of products with their prices, quantity rules and volume pricing that gets assigned to specific companies. It is the equivalent of a wholesale price list, and it is the object whose limit decides whether a B2B project fits your plan: three active without Plus, unlimited with it. The catalog is the piece to count before choosing a plan. Everything else in B2B has ceilings nobody reaches in practice; this one does not. ## The limit that decides the project On **Basic, Grow and Advanced** you get **3 active catalogs in total**, counting all your B2B markets together, not three per market. On **Shopify Plus** there is no limit, and the catalog can also be assigned directly to a company or to a [location](/en/glossary/company-location/). Three catalogs are enough for a tiered structure — wholesale, distributor, key accounts — which is how most brands actually work. What they are not enough for is a negotiated price account by account. ## Assignment changes how you build This point drags more decisions behind it than the number itself. Without Plus a catalog is not plugged into a company: it is plugged into a B2B market, and the companies in that market inherit it. The consequence is that your price segmentation has to match your geographic segmentation. If your three tiers are "wholesale Spain", "wholesale Portugal" and "distributor", you have spent all three. When several catalogs price the same product, **the lowest price wins**. Worth knowing before you overlap catalogs to handle an exception: overlapping does not add up, it picks. ## What fits inside one catalog More than it looks. A fixed price per variant or a percentage off the whole price list, [quantity rules](/en/glossary/quantity-rules/) and [volume pricing](/en/glossary/volume-pricing/). Before asking for a fourth catalog it is worth checking whether the difference between two customers is about price or about quantity: if it is quantity, volume breaks solve it inside one. The caps are in the [catalogs documentation](https://help.shopify.com/en/manual/b2b/catalogs). --- ## Cart Transform URL: https://nicolasmateos.com/en/glossary/cart-transform/ Also called: Cart Transform API, Shopify bundles, expand and merge Updated: 2026-10-22 Definition: Cart Transform is the Shopify Functions API that modifies cart lines before checkout: it can expand one line into several, merge several into a single one, or update a line’s price and title. It is the technical basis for bundles and product kits. This is the least known Function and it solves a very specific problem: selling something the buyer sees as **one** product and the warehouse needs as **several**, or the other way round. ## The three operations - **Expand.** One line becomes several. The buyer adds a "starter pack" and the cart, the order and the warehouse see the three SKUs that make it up, each drawing down its own stock. - **Merge.** Several lines display as one. The buyer sees "complete set" instead of four loose lines. - **Update.** Change a line's price or title. ## Why it matters in B2B The case I meet most is boxes. The catalog holds the unit, but the warehouse only moves boxes of six. There are two ways to solve it and it is worth choosing deliberately: 1. **[Quantity rules](/en/glossary/quantity-rules/)** with an increment of six. No code, works on any plan with B2B, and the buyer orders in sixes. 2. **Cart Transform** to sell the box as a product and expand it into six units for stock and the delivery note. The first is almost always right: it is free and adds nothing to maintain. The second only wins when the warehouse genuinely needs to see the units separately. ## The plan requirement Cart Transform is a [Shopify Function](/en/glossary/shopify-functions/), so writing one for your store requires Shopify Plus. And like every Function, it only sees what its [input query](/en/glossary/input-query/) hands it. Documentation: [Cart Transform API](https://shopify.dev/docs/api/functions/latest/cart-transform). --- ## Checkout Extensibility URL: https://nicolasmateos.com/en/glossary/checkout-extensibility/ Also called: checkout extensions, UI extensions, checkout customisation Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Checkout Extensibility is how Shopify checkout is customised today: UI extensions placed at allowed points, Functions that change discounts, shipping or payments, and configuration in the editor. It replaces editing checkout.liquid, which is no longer an option. The shift in thinking is this: checkout used to be a template you edited, and now it is an application you plug pieces into at specific places. You lose freedom and you gain the fact that a Shopify update does not break the store. ## The three pieces - **UI extensions**, which add content at allowed points of the checkout and the thank-you page: a notice, a field, a delivery information block. - **[Functions](/en/glossary/shopify-functions/)**, which change behaviour: discounts, validations that block payment, the order and availability of shipping and payment methods. - **The editor**, for the visual side: logo, colours, fonts and block order, with no code. ## What you can and cannot do You can: warn about a minimum, show a B2B company's payment terms, ask for a purchase order number, hide a shipping method, block checkout with a specific message. You cannot: freely reorder checkout steps, inject arbitrary JavaScript into the page, or lay the checkout out like a normal page. If a quote assumes any of that, the quote is wrong. ## The plan limit The visual side and public apps work on plans without Plus. An extension or a Function **written specifically for the store** needs [Shopify Plus](/en/glossary/shopify-plus/), because it ships inside a custom app. Documentation: [Checkout Extensibility](https://shopify.dev/docs/apps/build/checkout). --- ## checkout.liquid URL: https://nicolasmateos.com/en/glossary/checkout-liquid/ Also called: checkout liquid, checkout template, legacy checkout Updated: 2026-10-22 Definition: checkout.liquid was the template that let Shopify Plus stores edit the checkout like any other page of the theme. Shopify has retired it in favour of Checkout Extensibility, where the checkout is no longer edited: it is extended with extensions and Functions at allowed points. If somebody on your team still talks about "touching checkout.liquid", what they are describing is a model that no longer exists. And migrating is not copying that code somewhere else. ## Why Shopify closed it An editable template meant every Plus store had a different checkout, and that Shopify could not improve its own without risking thousands of customisations. The new model reverses the deal: you lose freedom, and in exchange a Shopify update stops being a risk to your store. ## What to do with what was inside The order that costs least: 1. **Inventory it.** What it actually did, not what the internal documentation says it did. 2. **Cull it.** This is the surprising part: in the projects I have seen, close to half the customisations were workarounds the platform now covers natively. Shipping notices, extra fields, reordering payment methods. 3. **Rebuild what survives.** The visual side from the editor. Content and fields with extensions. Behaviour with [Functions](/en/glossary/shopify-functions/). ## What does not come back Reordering the checkout steps, laying it out freely, or injecting arbitrary JavaScript. If the migration was quoted assuming all of that can be replicated, the quote is wrong — and better to know before starting than halfway through. The same thing happened to [Shopify Scripts](/en/glossary/shopify-scripts/): it was closed, and whatever was still needed got rewritten as a Function. Shopify documents the upgrade path in the [checkout documentation](https://help.shopify.com/en/manual/checkout-settings/checkout-extensibility/checkout-upgrade). --- ## Company URL: https://nicolasmateos.com/en/glossary/company/ Also called: company account, B2B customer, organisation Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: A company is the customer in Shopify B2B: instead of a person, the buyer is an organisation with its locations and its associated buyers. The catalog it sees, its payment terms and who is allowed to order on its behalf all hang off the company. This change of model is what breaks the most assumptions in a theme. In B2C there is a customer and an address; in B2B there is a company, several locations, and people who buy for one or for many of them. A `customer` object alone no longer tells you which price applies. ## The numbers Shopify does not limit how many companies a store can have, on any plan. What is capped is what hangs off each one: up to **10,000 locations** and **10,000 customers** per company. Those are ceilings nobody reaches in practice; the limit that hurts is the one on [active catalogs](/en/glossary/b2b-catalog/), which depends on the plan. ## What to watch when building the portal A company with several locations is not an administrative detail: it changes shipping, taxes, minimums and sometimes the catalog itself. In Liquid, `customer.current_location` tells you which location is buying, and that is enough to change messages, minimums or delivery notices without duplicating templates. The usual mistake is assuming a buyer belongs to one location. If they belong to three and the picker is hidden in the account page, the cart fills up with the wrong location's prices and the complaint arrives two days later, already invoiced. The limits are in the [companies documentation](https://help.shopify.com/en/manual/b2b/companies). --- ## Company location URL: https://nicolasmateos.com/en/glossary/company-location/ Also called: location, company branch, B2B location Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: A company location is the specific address a company buys from, and it is the unit that actually decides the order: its shipping address, its taxes, its payment terms and, on Shopify Plus, its own catalog. A company with three branches can buy at three different prices. The location is the object most often underestimated when quoting a B2B portal. It sounds like a billing detail and it is in fact the piece that decides what the buyer sees. ## What changes between plans On Shopify Plus a catalog can be assigned **directly to a location**. Without Plus it cannot: the catalog is assigned to a B2B market and the companies in that market inherit it, the same for all their locations. That is why "a different price list per branch" is one of the real reasons to move to Plus. The platform ceiling is **25 catalogs per location** and **50 customers per location**, the same on every plan. That 25 sits next to the 3-active-catalog limit of the non-Plus plans: the first is a platform cap, the second is your plan, and the second is the one that stops you. ## The location picker If a buyer has several locations, switching location has to live where the buying happens, not buried in the account pages. Changing location can change the price of every line in the cart, so the change should be visible and the cart should say it has been recalculated. In practice I solve it with a picker in the header that reads `customer.current_location` and reloads the cart when it changes. It is the pattern written out on [the code page](/en/code/). More detail in the [locations documentation](https://help.shopify.com/en/manual/b2b/companies). --- ## Core Web Vitals URL: https://nicolasmateos.com/en/glossary/core-web-vitals/ Also called: LCP, INP, CLS, page experience metrics Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Core Web Vitals are the three metrics Google uses to measure page experience: LCP (how long the main element takes to paint), INP (how long the page takes to respond to an interaction) and CLS (how much content shifts while loading). On Shopify all three are almost always degraded by app scripts and unsized images. They matter for two separate reasons, and it is worth not mixing them up. The first is that they are a ranking signal, small but real. The second, the one that actually moves money, is that a product page taking four seconds on a buyer's phone loses sales. ## Where the problems come from on Shopify By frequency, in the stores I have audited: 1. **App scripts nobody uses any more.** The app gets removed from the dashboard and its `script_tag` or block keeps loading. It is the first thing I look at and there are almost always two or three. 2. **Images without `width` and `height`.** Each one is a CLS jump, and the jump lands exactly when the user is about to tap. 3. **The main image loaded late**, inside a carousel that boots with JavaScript. LCP goes through the roof even when the server responds fast. 4. **Theme JavaScript that blocks interaction**, usually by rebuilding the whole cart on every change instead of asking for the rendered section. ## How I measure it Lighthouse is useful for comparing before and after, but what counts for Google is field data from real users. A store can score 95 in Lighthouse and still have bad Core Web Vitals if 70% of its visits come from a phone on a slow connection. That is why the numbers published on [the code page](/en/code/) are measured against the deployed site, not locally. --- ## Draft order URL: https://nicolasmateos.com/en/glossary/draft-order/ Also called: quote, manual order, draft Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: A draft order is an order created from the admin or the API before a payment exists, with its lines, its customer and its prices already set. In B2B it is the usual way to turn a quote into an order and to enter an order taken over the phone or by email. In wholesale the order does not always start on the website. It starts on a call, in a spreadsheet the sales rep sends, or in an email with fifteen SKUs in it. The draft order is where all of that lands without breaking the store's model. ## What it is actually used for Three things, in order of frequency: 1. **A quote.** Build the order with prices and shipping, send it to the buyer, and convert it to an order when they accept. Nothing gets retyped. 2. **An order taken off the website.** The rep enters it through the admin with the right company and location, and the price comes from the catalog that applies. 3. **Exceptions.** A one-off special price or a negotiated shipping cost that does not justify touching the catalog. ## What to know before automating it If drafts are created over the [API](/en/glossary/admin-graphql-api/) from an ERP or a configurator, it is worth being clear that a draft does not reserve stock and that prices written by hand do not recalculate themselves. A draft created in January with a January price still carries that price in March. The other point: sending the draft to the buyer sends a payment link. If the company is on deferred [payment terms](/en/glossary/payment-terms/), that link is not the right flow — converting it to an order with its due date is. Detail in the [draft orders documentation](https://help.shopify.com/en/manual/fulfillment/managing-orders/create-orders). --- ## GEO (Generative Engine Optimization) URL: https://nicolasmateos.com/en/glossary/geo/ Also called: generative engine optimisation, AI search optimisation Updated: 2026-11-05 Definition: GEO is the optimisation of content, identity and technical access so generative engines can find, understand and cite a source. On Shopify it applies to products, collections, guides and brand information; it cannot guarantee an assistant will recommend a store. ## What changes in a Shopify store A product page should answer buying questions with verifiable facts: use, dimensions, materials, compatibility and limitations. Guides explain how to choose and link to relevant products. Visible content and structured data should describe the same product without duplicate entities or invented reviews. Technical access is checked before producing more content. Allowing a crawler in robots.txt does not prove that it accessed, indexed or cited a page. For B2B, improving public access must not expose negotiated prices or restricted catalogues. ## GEO, SEO and AEO SEO addresses search visibility. [AEO](/en/glossary/aeo/) organises direct answers. GEO also examines how a source is mentioned and cited in generated responses. The [SEO and GEO comparison](/en/compare/seo-vs-geo-shopify/) separates goals and metrics. ## What an implementation cannot prove Publishing FAQs, JSON-LD or llms.txt demonstrates that these components exist. Visibility claims require recorded queries, context, responses and cited URLs. Business claims require visits and enquiries. [Google Search Central](https://developers.google.com/search/docs/appearance/ai-features) explains how AI features relate to SEO foundations. See the scope of [Shopify GEO consulting](/en/services/geo-shopify/). --- ## Headless commerce URL: https://nicolasmateos.com/en/glossary/headless-commerce/ Also called: headless, decoupled storefront Updated: 2026-10-22 Definition: Headless means building the storefront yourself and asking Shopify only for the data, through the Storefront API, instead of letting Shopify render pages from a theme. You gain complete control of the front-end and you lose the theme editor, part of the app ecosystem, and maintenance that used to be somebody else’s. Of all the decisions people bring me, this is the one with the worst ratio between what it promises and what it costs. Not because it is wrong, but because it is almost always asked for the wrong reason. ## The wrong reason: "we want it to be fast" A well-built theme on Shopify is fast. When a store is slow, the cause is almost never [Liquid](/en/glossary/liquid/): it is app scripts nobody uses, unsized images, and a cart rebuilt by hand on every change. Going headless with those habits produces a slow headless store, and now the server is yours too. ## The good reasons - **The storefront is not a store.** A large content site, an application, an unusual point of sale, where buying is one part of it. - **Several brands or channels** sharing one front-end. - **A front-end that already exists** and works, which now needs to sell. ## What you give up, best written down before starting The theme editor: your client stops building pages alone and goes back to depending on development. Apps that install as theme blocks stop being useful. Checkout is still Shopify's, so the freedom is not total. And hosting, deployment and updates become yours. In B2B there is an extra toll: the company context, the catalog and the buyer's price have to be carried by hand over the [Storefront API](/en/glossary/storefront-api/), when a theme hands them to you resolved. If after all that you are still a yes, [Hydrogen](/en/glossary/hydrogen/) is the short road. --- ## Hydrogen URL: https://nicolasmateos.com/en/glossary/hydrogen/ Also called: Shopify Hydrogen, Oxygen, React on Shopify Updated: 2026-10-22 Definition: Hydrogen is Shopify’s React-based framework for building headless storefronts that read their data from the Storefront API. Shopify pairs it with Oxygen, its own hosting, so the path from development to production is covered by the platform instead of assembled by you. If you have already decided to go [headless](/en/glossary/headless-commerce/), Hydrogen is the road with the fewest loose parts: it ships the [Storefront API](/en/glossary/storefront-api/) queries, cart handling and product components already solved, and it deploys to Oxygen without you building infrastructure. The real question is not "Hydrogen or another framework?", it is "headless or theme?". If the answer is theme, Hydrogen never enters the conversation. ## When I would recommend it When the team that will maintain the store **already works in React** and the storefront has interface logic a theme would make awkward. In that case, what would be weeks of fighting the editor in Liquid becomes ordinary code for them. ## When I would not When the reason is speed. A well-built theme competes easily, and the weight of a slow store is almost never in server rendering: it is in what has been piled on top of it. And when the client builds their own pages. That is the cost that shows up later: with Hydrogen, every new landing page goes back through development, while with [sections and blocks](/en/glossary/sections-and-blocks/) the marketing team builds it in an afternoon. ## In B2B, a warning Hydrogen does not hand you the company context for free. The catalog, the buyer's price and the location have to be requested and propagated by you, when a theme delivers them resolved. That is work the demo does not show. Documentation: [Hydrogen](https://shopify.dev/docs/storefronts/headless/hydrogen). --- ## Input query URL: https://nicolasmateos.com/en/glossary/input-query/ Also called: run.graphql, Function input, input GraphQL Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: The input query is the GraphQL file that declares what data a Shopify Function receives at run time. A Function only sees what its input query asks for, and because the input is capped at 128 kB, deciding which fields go in is as much work as the logic itself. This is the most underestimated file when writing a Function. The logic is usually short; what decides whether the Function works on a large cart is what you asked for. ## The 128 kB limit is not theoretical With a 10-line cart there is room for everything. With a 200-line wholesale order pad, every extra field is multiplied by 200. Asking for every variant's title, description and images "just in case" is the fastest way to make a Function that passed its tests fail on a customer's real order. The rule I follow: the input query asks for **exactly** the fields the code reads, and when I add a field to the code I add it here too, in the same commit. ## Aliases are part of the design A [metafield](/en/glossary/metafields/) arrives with its `namespace` and `key`, which makes for ugly code. With an alias it arrives under the name that makes sense to the logic: ```graphql query RunInput { cart { lines { quantity merchandise { __typename ... on ProductVariant { id title casePack: metafield(namespace: "b2b", key: "case_pack") { value } } } } } } ``` That `casePack` is the same metafield under a name that reads. And `__typename` is there because a cart line is not always a product variant, and discarding what is not one before touching it avoids the most common error. A complete example with its function and its tests is in [shopify-checkout-lab](https://github.com/NicolasShopiDev/shopify-checkout-lab). --- ## Liquid URL: https://nicolasmateos.com/en/glossary/liquid/ Also called: Liquid language, Liquid templates, Shopify Liquid Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Liquid is the template language Shopify themes are built in. It runs on Shopify’s server before the HTML is sent to the browser, so it can read products, collections, the customer or the cart, but it cannot react to anything that happens on the page afterwards. Understanding where Liquid runs answers 90% of the questions about what a theme can do. Liquid runs **once**, on the server. By the time the HTML reaches the browser, Liquid has finished: from there on, everything is JavaScript. ## What that means in practice - A price that depends on the customer can be decided in Liquid, because the session already exists when the page renders. That is why `customer.b2b?` is the right way to make sure a wholesale price **never reaches the HTML** of a visitor without a session. - A quantity change in the cart cannot be handled by Liquid: that is the [Cart API](/en/glossary/ajax-cart-api/). What you can do is ask Shopify to re-render a section and hand back its HTML. - A collection filter with 20 combinations is not built with Liquid loops: it is built with the store's native filters. ## The cost of a loop Liquid has execution limits per page, and slow themes almost always have the same cause: nested loops over large collections. Walking every variant of every product in a collection to calculate something is the fastest way to make a page take seconds. The alternative is usually a [metafield](/en/glossary/metafields/) holding the value already calculated. Moving the calculation from render time to save time is the optimisation I have applied most often. Reference: [Liquid](https://shopify.dev/docs/api/liquid). --- ## Metafields URL: https://nicolasmateos.com/en/glossary/metafields/ Also called: metafield, custom fields, custom data Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Metafields are custom fields added to a Shopify object — product, variant, customer, order, company — to store data the platform does not ship with. They are typed and validated, and they are readable from the theme in Liquid, from the API, and from inside a Shopify Function. This is the first tool to reach for when a piece of data appears that Shopify does not have: a variant's case pack, a product's technical sheet, a customer code from the ERP. Before installing an app or inventing a convention inside tags, the answer is almost always a metafield. ## Typed, and that matters A metafield is not free text: it has a type (integer, decimal, date, product reference, file, list) and Shopify validates what goes in. That avoids the classic of reading `"6 pcs"` where the code expected `6`. And the type decides how it reads in the theme. A product reference arrives as the product object, not as an ID you have to resolve by hand. ## Variant versus product The decision people get wrong most often. If the data changes by size or colour, it belongs on the **variant**. The case pack is a clear example: not every size ships in boxes of 6. A product-level metafield forces an approximation, and the approximation shows up in the warehouse. ## Why they matter to Functions A [Shopify Function](/en/glossary/shopify-functions/) cannot call anything: all it sees is what its [input query](/en/glossary/input-query/) hands it. So any business rule that depends on your own data needs that data in a metafield, with its alias in the query. If the data lives in an app or in an external system, the Function cannot use it. Documentation: [metafields](https://shopify.dev/docs/apps/build/custom-data/metafields). --- ## Metaobjects URL: https://nicolasmateos.com/en/glossary/metaobjects/ Also called: metaobject, structured content, custom content types Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Metaobjects are content types you define inside Shopify, with their own fields: a size guide, a material, a store location, an author. They exist in their own right, are referenced from products or pages through a metafield, and the theme renders them like any other object. The difference from a [metafield](/en/glossary/metafields/) is ownership. A metafield describes an object that already exists. A metaobject **is** an object: it stands alone, it is edited once, and many products use it. ## When it is worth it The test is simple: does this data repeat across several products, and when it changes do you have to change it in all of them? If yes, it is a metaobject. The cases I meet most: - **A size guide** shared by a whole product family. - **Materials or compositions**, with a name, a description and an icon. - **Store locations**, with address and opening hours, for a stockists page. - **Certifications**, which carry a logo and legal text. The real benefit is not technical: the client edits it once and it updates on 200 product pages, without touching the theme. ## What to plan for Two things. First, a metaobject can have its own URL if you give it one, at which point it becomes indexable content; decide that on purpose rather than by accident. Second, the theme has to render it: a metaobject with no section to display it is data nobody sees. And the usual warning: metaobjects are not a database. If what you want is a 50,000-row catalog with search, this is not it. Documentation: [metaobjects](https://shopify.dev/docs/apps/build/custom-data/metaobjects). --- ## Payment terms URL: https://nicolasmateos.com/en/glossary/payment-terms/ Also called: net 30, deferred payment, credit terms Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Payment terms in Shopify B2B are the window a company has to pay an order: immediately, net 30, 45 or 60, or on receipt. They are assigned to the company or the location, and they let the buyer complete an order without entering a card. This is the feature that turns a cart into a real wholesale order. A professional buyer does not pay by card: they have an agreement and they pay on terms against an invoice. ## What changes at checkout With terms assigned, checkout offers to complete the order without taking payment. The order lands as payment pending with its due date, and collection is handled afterwards. For the front-end that means the pay button is not the end of the flow: the end is a confirmed order the buyer can download. ## Where it shows in the front-end Two places, and both get forgotten: - **The cart.** If the buyer knows they are paying in 60 days, saying so in the cart cuts abandonment far more than any trust badge. - **The account area.** A buyer on deferred payment logs in to see what is outstanding and when it is due. If that is missing, they phone and ask. ## What it does not solve It is not credit control. Shopify stores the term, not the risk: there is no credit limit that stops an order when the company already owes too much. If that is needed it comes from the ERP, and it enters the project as an [integration](/en/services/erp-integrations/) or as a cart validation. Detail in the [payment terms documentation](https://help.shopify.com/en/manual/b2b/payment-terms). --- ## Price list URL: https://nicolasmateos.com/en/glossary/price-list/ Also called: pricing, wholesale price list, B2B pricing Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: The price list is the part of a B2B catalog that decides what the buyer pays. It can be a percentage adjustment off the retail price or a fixed price per variant, and both forms can be mixed inside the same catalog. The choice between a percentage and a fixed price looks minor and it decides how much maintenance the store costs you every season. ## Percentage off retail A discount applied on top of the retail price. When you raise B2C prices, the wholesale ones move with them. This is what I recommend by default: no list goes stale. The problem shows up when margin is not uniform. If wholesale pays 40% less in one product family and 25% less in another, a single global percentage does not cover it and you either split the catalog or move to fixed prices. ## Fixed price per variant The price list written by hand, SKU by SKU. It gives total control and it has a cost: every B2C price change has to be replicated here, and if it is not, the wholesale buyer ends up paying more than the retail customer. I have seen that in production more than once. My rule: percentage by default, fixed price only on the SKUs where the agreement with the customer forces it, and a price review on the calendar. If you mix them, write down somewhere which SKUs are fixed, because inside the admin they do not stand out at a glance. ## What a price list is not It is not the way to give every account its own price without Plus: catalogs are assigned per market, so the list reaches every company in that market. Per-account pricing needs [Shopify Plus](/en/glossary/shopify-plus/) or a public app. Detail in the [B2B pricing documentation](https://help.shopify.com/en/manual/b2b/catalogs). --- ## Quantity rules URL: https://nicolasmateos.com/en/glossary/quantity-rules/ Also called: minimum order quantity, increments, case pack, MOQ Updated: 2026-10-23 Facts checked: 2026-10-23 Definition: Quantity rules are the minimum, maximum and increment a variant can be ordered in inside a B2B catalog. They are the native way to force full-case ordering or a minimum order, and they work on every plan that supports B2B. Three numbers per variant: minimum, maximum, increment. That covers most of what gets described in a meeting as "they can't order loose units". ## Where they apply and where they do not The rules live in the catalog, so the same product can have different minimums for the wholesaler and for the distributor. The theme receives them and should use them on the `input` itself: `min`, `max` and `step` on the quantity field. That is the difference between telling the buyer before they type and telling them once they have already tried to pay. What they do not do: validate combinations across lines. "€300 minimum per order" or "tier A and tier B cannot be mixed in one order" are not quantity rules. Since April 2026, a single order value minimum for everyone, or for every B2B buyer, is a no-code [order limit validation in Checkout Blocks](https://help.shopify.com/en/manual/checkout-settings/checkout-blocks/order-value-limits) on every plan that has B2B. Anything that changes with the company or with what is in the cart is a validation [Shopify Function](/en/glossary/shopify-functions/), and a custom-written Function needs Plus. ## The full-case case The example I repeat most: a product that leaves the warehouse in boxes of 6. With an increment of 6 in the quantity rule, the field will not accept 7 and the problem disappears at the source. If for any reason the rule cannot apply (an imported order, a line created from the admin), the fallback is a validation Function that blocks checkout and says exactly what to change. That Function is published with its tests in [shopify-checkout-lab](https://github.com/NicolasShopiDev/shopify-checkout-lab). Setup in the [catalogs documentation](https://help.shopify.com/en/manual/b2b/catalogs). --- ## Quick order URL: https://nicolasmateos.com/en/glossary/quick-order/ Also called: order pad, order form, bulk order table, SKU ordering Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Quick order is the table where a wholesale buyer enters quantities for many SKUs at once and sends them to the cart in a single operation. It is not a Shopify feature but a front-end pattern, and it is what separates a usable B2B portal from a good-looking catalog. A B2C buyer compares and chooses. A B2B buyer already knows what they want and needs to type it fast. That difference is the whole design of the portal. ## The mistake that breaks half the implementations A table with 40 SKUs and a quantity box per row invites one request per line. Forty requests in a row do two bad things: the cart flashes forty times and, worse, **the last response can land before the first**, so the total the buyer sees is not the total they have. The [Cart API](/en/glossary/ajax-cart-api/) accepts an object with several lines at once, and it hands back the rendered HTML of the sections that need repainting. One request, one state, one repaint. ## Absolute quantities, not increments The second detail that saves support tickets: send the total quantity of each line, not "add 3". With absolute quantities, a first order, a top-up and a correction are exactly the same request, and a rejected line leaves the cart as it was. ## What cannot be left out - **SKU search**, because that is how a professional buyer searches, not by product name. - **Stock per row**, because ordering what is not there is complaint number one. - **[Quantity rules](/en/glossary/quantity-rules/) applied to the field itself**, with `min` and `step`. - **Staying in sync with the rest of the theme**: the same variant has to show the same quantity on the product page, in the listing and in search. The full pattern, rebuilt on Dawn with no client code in it, is in [shopify-b2b-order-portal](https://github.com/NicolasShopiDev/shopify-b2b-order-portal). --- ## Sections and blocks URL: https://nicolasmateos.com/en/glossary/sections-and-blocks/ Also called: sections, blocks, theme sections, Online Store 2.0 Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Sections are the modules of a Shopify template that a client can add, reorder and configure from the editor; blocks are the pieces that go inside a section. Since Online Store 2.0 they work on any template, and they are what makes a theme maintainable without a developer. This is the part of theme work that does not show in the mockup and decides whether the project ages well. Two themes can look identical on delivery day: on one the client builds a landing page in twenty minutes, on the other they ask for a quote every time. ## How to split sections One section per **page intention**, not per row of the design. If the design has three text-and-image bands that differ only in which side the photo is on, that is not three sections: it is one with a position setting. The opposite mistake is just as common: one giant section with forty settings. If the client needs a manual to use it, the section is split wrong. ## What makes a section actually useful - **Sensible defaults.** A freshly added section has to look right before anything is configured. - **Capped blocks.** A carousel that accepts 30 blocks will end up with 30 blocks. - **Copy in settings, not in code.** Everything the client might one day want to change. - **Names in their language.** "Featured band", not "hero_section_2". ## Where they meet content When the data a section shows repeats across pages, it does not belong in the settings: it belongs in [metaobjects](/en/glossary/metaobjects/), with the section referencing them. The client edits the data once and it changes everywhere it appears. Documentation: [theme sections](https://shopify.dev/docs/storefronts/themes/architecture/sections). --- ## Shopify B2B URL: https://nicolasmateos.com/en/glossary/shopify-b2b/ Also called: native B2B, Shopify wholesale, B2B on Shopify Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Shopify B2B is the set of wholesale features built into the store itself: the customer stops being a person and becomes a company with its locations, and prices come from catalogs assigned to those companies. It is not an app or a separate theme, it is a data model inside the store you already have. What separates native B2B from the workarounds people used before it (customer tags, automatic discounts, a second store running in parallel) is that the wholesale price **arrives at the theme already resolved**. The front-end calculates nothing: it asks for the variant price and gets the one that belongs to the company of whoever is logged in. ## Which plans have it Shopify's documentation lists B2B on **Basic, Grow, Advanced and Shopify Plus**, and excludes it only from Starter and Retail. The difference between plans is not whether you can sell wholesale, it is how many active [catalogs](/en/glossary/b2b-catalog/) you can have: three in total on the plans without Plus, unlimited on Plus. ## What the theme has to do One thing, and it is the one most often done wrong: decide who sees prices. The condition is `customer.b2b?`, and the rule is that if the visitor is not B2B the price **must not reach the HTML** — hiding it with CSS is not enough. ```liquid {% if customer.b2b? %} {{ product.selected_or_first_available_variant.price | money }} {% else %} Log in to see prices {% endif %} ``` The rest of the work in a wholesale portal depends on neither the plan nor B2B: it is order flow. A size table with live stock, SKU search, reordering last month's order. That is front-end work, and it is where the buyer notices the difference. The model is documented under [B2B on Shopify](https://help.shopify.com/en/manual/b2b). --- ## Shopify Functions URL: https://nicolasmateos.com/en/glossary/shopify-functions/ Also called: Functions, function extension Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Shopify Functions are your own code executed inside Shopify’s back end at specific points of the cart and checkout: discounts, validations, line transformation, shipping and payment methods. They are written in JavaScript or Rust, compiled to WebAssembly, and a custom Function can only be installed on stores with Shopify Plus. Functions are Shopify's answer to "I need a business rule the platform does not ship". They replaced [Shopify Scripts](/en/glossary/shopify-scripts/) and differ in something important: they do not run in the browser or on a server of yours, they run inside Shopify, before the checkout is drawn. ## The budget, which is the part that surprises people A Function is not an ordinary function. It has an execution budget — on the order of **11 million instructions** — and a **128 kB cap on its input**. That changes how you write one: - The [input query](/en/glossary/input-query/) is half the work: a Function only sees what it asks for, and an order pad with 200 lines cannot afford stray fields. - There are no network calls. You cannot query your ERP from inside a Function. - Data the Function needs that is not native goes in [metafields](/en/glossary/metafields/), which is what does arrive in the input. ## The plan limit This is the point that breaks the most quotes: **only stores on Shopify Plus can install custom apps containing Functions**. On Basic, Grow and Advanced you can use functions that ship inside a public App Store app, but not one written for your store. The practical difference: with a public app you adapt to its data model, with your own Function you set the model. ## A complete example A validation Function that blocks checkout when a line is not a multiple of the warehouse case pack, with its input query and its tests, is published in [shopify-checkout-lab](https://github.com/NicolasShopiDev/shopify-checkout-lab) and can be poked at live in the Checkout Lab on [the home page](/en/). Official documentation: [Shopify Functions](https://shopify.dev/docs/api/functions). --- ## Shopify Markets URL: https://nicolasmateos.com/en/glossary/shopify-markets/ Also called: Markets, international selling, multi-market Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Shopify Markets is how one store sells in several countries from a single admin: each market has its countries, its currency, its languages, its taxes and its price adjustments. In B2B it has an extra role, because without Shopify Plus catalogs are assigned through B2B markets. For a B2C store, Markets is what saves you from running four stores to sell in four countries. For a B2B store it is more than that: it is the piece your whole price structure depends on if you are not on Plus. ## The B2B overlap you have to draw first Without Shopify Plus a [catalog](/en/glossary/b2b-catalog/) is not assigned to a company: it is assigned to a B2B market, and the companies in that market inherit it. Since you can only have three active catalogs, your price segmentation and your geographic segmentation have to fit in the same scheme. What that looks like in a real meeting: if the tiers are "wholesale Spain", "wholesale Portugal" and "distributor", all three are spent and there is no room left for key accounts. Drawing it on a whiteboard before choosing a plan saves the conversation. ## What it changes in the front-end - **The country and language picker** has to exist and must not reset the cart. - **Rounded prices** per market change what the product page shows; if the theme caches prices in JavaScript, they have to be invalidated when the market changes. - **International SEO** is decided here: each market with its domain or subfolder and its `hreflang`. A store with four markets and a single `hreflang` competes with itself. Documentation: [Shopify Markets](https://help.shopify.com/en/manual/markets). --- ## Shopify Plus URL: https://nicolasmateos.com/en/glossary/shopify-plus/ Also called: Plus, Plus plan, Shopify enterprise Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Shopify Plus is Shopify’s top plan. What it unlocks that genuinely changes a project is four things: unlimited B2B catalogs assignable to a specific company or location, the ability to install custom apps containing your own Shopify Functions, checkout customisation beyond what a public app allows, and development stores. Plus is sold as "for large brands", which does not help anyone decide. The useful question is not the size of the brand, it is whether the project hits one specific wall in the plans below. ## The five real reasons In order of how often they come up in the projects I get: 1. **More than three price lists actually in use.** The [active catalog](/en/glossary/b2b-catalog/) limit without Plus is three across the whole store. 2. **A negotiated price per account** instead of per tier. Without Plus, catalogs are assigned per market. 3. **Different catalogs per branch** of the same company. Without Plus a catalog cannot be assigned to a [location](/en/glossary/company-location/). 4. **Custom [Functions](/en/glossary/shopify-functions/).** Only stores on Plus can install custom apps that contain Shopify Functions. Without Plus you can use functions that ship inside a public app, but not one written for your store. 5. **Checkout** beyond what a public app allows. If you tick one, the conversation stops being technical and becomes arithmetic. If you tick none, the budget for the plan upgrade goes further spent on order flow. ## What is not a reason "We want to customise the checkout" is not enough on its own if what you want is colours, a logo or an extra field: that is done with extensions and public apps on plans without Plus. And "we are going to grow a lot" is not one either: Plus can be bought the day it is needed, and the wall shows up in the number of price lists long before the number of orders. Compared in detail in [Shopify Plus or Advanced](/en/compare/shopify-plus-or-advanced/). --- ## Shopify Scripts URL: https://nicolasmateos.com/en/glossary/shopify-scripts/ Also called: Scripts, Ruby scripts, Script Editor Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Shopify Scripts was the system that came before Functions for applying your own discount, shipping and payment rules on Shopify Plus stores, written in Ruby from the Script Editor. It stopped executing in June 2026, and what replaces it is Shopify Functions. If a store still has Scripts in its internal documentation, its wiki or its maintenance contract, what it has is a business rule that is no longer being applied. ## What changes when you migrate It is not a translation from Ruby to JavaScript. The model differs in three places that force a redesign rather than a rewrite: - **Scripts ran at checkout and saw the whole cart.** A [Function](/en/glossary/shopify-functions/) declares in its [input query](/en/glossary/input-query/) which fields it needs, and receives only those. - **A Script had no visible instruction budget.** A Function does, and that rules out walking the entire catalog inside the code. - **Functions deploy as an app**, with versions and configuration, not as text saved in the admin. That is better to maintain and more work the first time. ## What you actually find The three most common Scripts were: a discount by customer tag, hiding shipping methods based on the cart, and reordering payment methods. All three have a Function equivalent today, and in B2B two of them are solved without code at all: a tier discount is a [catalog](/en/glossary/b2b-catalog/) and a case-pack minimum is [quantity rules](/en/glossary/quantity-rules/). Before quoting a migration it is worth checking which of the old Scripts are no longer needed. In the projects I have seen, half of them. Documentation for what replaces them: [Shopify Functions](https://shopify.dev/docs/api/functions). --- ## Storefront API URL: https://nicolasmateos.com/en/glossary/storefront-api/ Also called: Storefront GraphQL API, buyer-side API Updated: 2026-10-22 Definition: The Storefront API is the GraphQL interface meant for the buyer side: it reads products, collections and content, and creates and updates carts. It is designed to be used from the browser or an app with a public token, and it is what a headless store is built on. The usual confusion is thinking it is "the other API" and that it does not matter which one you use. It does: the [Admin API](/en/glossary/admin-graphql-api/) is private and manages the store, the Storefront one is public and is for buying. ## Public means public The Storefront API token travels to the browser, so anybody can read it and use it. That is normal and intended, but it has a consequence worth understanding: **whatever you expose through it is visible to everyone**. On a B2C store that rarely matters, because the catalog is public anyway. On a wholesale portal it matters a great deal: if you build a component with the Storefront API that returns B2B catalog prices, you are publishing your price list. That is why on the portals I build the wholesale price is decided in [Liquid](/en/glossary/liquid/), on the server, and never requested from the browser. ## You do not have to go headless to use it It is associated with [headless](/en/glossary/headless-commerce/) and it works perfectly well inside a normal theme, for one specific piece: a fast search, a complex product picker, a configurator. It is a decision per component, not per store. Documentation: [Storefront API](https://shopify.dev/docs/api/storefront). --- ## Theme app extension URL: https://nicolasmateos.com/en/glossary/theme-app-extension/ Also called: app block, app embed, theme extension Updated: 2026-10-22 Definition: A theme app extension is how an app adds functionality to a theme without modifying its files: it contributes blocks the merchant places from the editor, or an embed enabled across the store. When the app is uninstalled, its blocks leave with it. This solves the most expensive problem in maintaining a Shopify store: apps that leave things behind. ## The old model, and why it hurt Apps used to install by putting their code into your theme: a script tag, a snippet pasted into `theme.liquid`, sometimes a whole template. Uninstalling the app removed the app, but **the code stayed**, loading its script on every page with nobody remembering where it came from. Those leftovers are, by a distance, the first thing I find when auditing a slow store: two or three scripts from apps that are no longer installed. And when such an app uninstalls badly, the theme is left with broken snippets that blow up on the next update. ## The current model With a theme app extension, the app's code lives in the app, not in your theme. The merchant places the block where they want from the editor, exactly like a [section](/en/glossary/sections-and-blocks/), and the app updates without touching your theme. Practical consequences worth using in your favour: - **Uninstalling leaves nothing.** No more archaeology hunting orphan scripts. - **Your theme stays updatable**, because the app never edited it. - **If an app still asks you to paste code into `theme.liquid`**, that tells you something about how it is maintained. Not disqualifying, but worth knowing before installing it. Documentation: [theme app extensions](https://shopify.dev/docs/apps/build/online-store/theme-app-extensions). --- ## Volume pricing URL: https://nicolasmateos.com/en/glossary/volume-pricing/ Also called: quantity breaks, tiered pricing, price breaks Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Volume pricing is a set of price steps inside a B2B catalog: past X units of a variant, the unit price drops. It is configured per product within the catalog and is available on every plan that supports B2B, Shopify Plus included or not. This is the B2B feature that rescues the most projects and gets used the least. When somebody asks for a fourth catalog because "this customer buys much more", what they are describing is almost never a different price: it is a different quantity. ## A price break, not a discount A volume break is not a discount applied at the end: it is the unit price of that variant from that quantity onwards. That has two practical consequences. The first is that the buyer sees the incentive while ordering, not while paying. The second is that the theme has to show it: if the price changes at 12 units and the product page does not say so, the buyer orders 10 and nobody wins. ## What the front-end has to show On the portals I build, the break table sits next to the quantity stepper, and the active row is highlighted based on what is in the cart. Two details that matter: - The break is calculated per **variant**, not per product. Twelve units spread across four sizes are not twelve of one size. - If you use [quantity rules](/en/glossary/quantity-rules/) with increments, the breaks should land on valid multiples. A break that starts at 10 when the increment is 6 is a break nobody ever reaches. ## When it is not enough When the difference between two customers really is price — a negotiated agreement, not a volume — a break will not solve it. That is when another catalog is needed or, if you already have three, [weighing up Plus](/en/compare/shopify-plus-or-advanced/). The setup is in the [catalogs and pricing documentation](https://help.shopify.com/en/manual/b2b/catalogs). --- ## WebAssembly (Wasm) URL: https://nicolasmateos.com/en/glossary/webassembly/ Also called: Wasm, WebAssembly, wasm32 Updated: 2026-10-22 Definition: WebAssembly is the format Shopify Functions are compiled to before they are uploaded. Shopify does not run your JavaScript or your Rust as written: it runs the resulting Wasm module, in a sandbox, with no network access and an instruction budget. This is not an implementation detail you can ignore: it explains the three [Functions](/en/glossary/shopify-functions/) rules that confuse people most at the start. ## Where the limits come from **There are no network calls.** A Wasm module only sees what is handed to it as input. That is why a Function cannot query your ERP or an external API, and why any custom data has to arrive in [metafields](/en/glossary/metafields/) through the [input query](/en/glossary/input-query/). **There is an instruction budget.** Shopify runs your module inside its checkout, for every buyer of every store, so it caps it. That is why walking the whole catalog inside a Function is not an option. **It is fast and isolated.** A Wasm module starts in microseconds and cannot touch anything outside its box. That is what lets Shopify run third-party code on the critical path of a payment. ## What it means for choosing a language Shopify officially supports JavaScript and Rust, but underneath **any language that compiles to Wasm works**. In practice I pick JavaScript unless the budget gets tight: it reads, it tests with ordinary tooling, and anyone on the team can maintain it. Rust comes in when the function walks very large carts and instructions have to be squeezed. The decision is rarely technical, it is about maintenance: who is going to touch this in a year? Documentation: [Functions programming languages](https://shopify.dev/docs/apps/build/functions/programming-languages). --- ## Webhooks URL: https://nicolasmateos.com/en/glossary/webhooks/ Also called: webhook, webhook subscription, Shopify events Updated: 2026-10-22 Definition: A webhook is an HTTP request Shopify sends to a URL of yours when something happens in the store: a new order, an updated product, a customer created. It is the right way to find out about changes, instead of asking the API every few minutes. The difference from a sync that polls every five minutes is twofold: you find out immediately, and you stop spending API budget asking about things that have not changed. ## What you have to do, without exception **Verify the signature.** Every delivery carries an HMAC header computed with your app's secret. An endpoint that does not check it will accept orders invented by anyone who knows the URL. It is the security hole I have seen most often in integrations built in a hurry. **Answer fast, work afterwards.** Shopify expects a response within a few seconds. If your endpoint starts writing to the ERP before answering, you end up timing out even though the work was done. The right shape is to store the notice, return 200, and process it from a queue. **Assume duplicates.** The same event can reach you twice. If every notice creates an order in your system, you will end up with duplicates. Store the event id and discard what you have already processed. ## What happens when your server is down Shopify retries for a while and, if it keeps failing, eventually removes the subscription. That is the scenario to design for: not "what if one notice fails?" but "how do I recover what I missed while I was down?". The answer is usually a sweep over the [Admin API](/en/glossary/admin-graphql-api/) covering the outage window. The exact retry conditions are in the [webhooks documentation](https://shopify.dev/docs/apps/build/webhooks). # Español --- ## Apps de Shopify a medida URL: https://nicolasmateos.com/servicios/apps-shopify-a-medida/ Service: Desarrollo de apps de Shopify a medida Updated: 2026-10-21 Apps embebidas en el admin de Shopify con Node.js, Express y el CLI, para lo que ninguna app del App Store hace: configuradores, paneles internos, lógica de catálogo o el contenedor de tus Shopify Functions. ## Lo primero que te voy a preguntar Si lo que necesitas cabe en un [metacampo](/glosario/metacampos/), en un metaobjeto o en una app del App Store, no necesitas una app a medida. Una app propia es código que alguien tiene que mantener, actualizar cuando cambia la versión de la API y alojar en algún sitio. Vale la pena cuando no hay alternativa, no por defecto. ## Lo que suelo construir - **Configuradores de producto** con reglas que ninguna app genérica modela: compatibilidades, medidas, combinaciones excluyentes. - **Paneles internos** embebidos en el admin, para que el equipo gestione datos propios donde ya trabaja, en lugar de en una hoja de cálculo aparte. - **Automatizaciones** que leen y escriben por la [Admin API](/glosario/api-graphql-de-admin/): recalcular, reclasificar, limpiar. - **El contenedor de una [Function](/servicios/shopify-functions/)**, cuando la Function necesita configuración y alguien tiene que poder cambiarla sin tocar el código. ## Cómo las monto Embebidas en el admin con App Bridge, para que la app viva dentro de Shopify y no sea una pestaña aparte con otra sesión. La autenticación por token de sesión, la API por GraphQL y la versión de la API fijada, nunca "la última": una API sin versión fijada es una app que un día deja de funcionar sin que nadie haya tocado nada. Y una cosa que digo siempre: una app a medida necesita un plan de actualización. Shopify saca versiones de API cada trimestre y las antiguas se retiran. Si nadie va a mirar esa app en dos años, mejor que el proyecto no dependa de ella. ### FAQ **¿Cuándo tiene sentido una app a medida?** Cuando el flujo es tuyo y ninguna app del App Store encaja sin doblarlo: un configurador de producto con reglas propias, un panel para que el equipo gestione algo que Shopify no modela, o el contenedor de una Function escrita para tu tienda. **¿Una app a medida necesita Plus?** La app en sí, no. Si contiene Shopify Functions, sí: solo las tiendas con Shopify Plus pueden instalar apps personalizadas que lleven Functions dentro. **¿Dónde se aloja?** Donde te convenga mantenerla. Para la mayoría de los casos basta una función serverless o un contenedor pequeño. El coste de alojamiento de una app interna suele ser de unos pocos euros al mes, y eso conviene saberlo antes de empezar. --- ## Personalización del checkout de Shopify URL: https://nicolasmateos.com/servicios/checkout-extensibility/ Service: Personalización del checkout de Shopify Updated: 2026-10-21 Extensiones de interfaz, validaciones que bloquean el pago, campos propios y reglas de envío y de pago, dentro de Checkout Extensibility. Lo que se puede hacer, lo hago; lo que no, te lo digo antes de presupuestar. ## Lo que de verdad se pide Casi nunca es un rediseño. En los proyectos que me llegan, el checkout se toca por cuatro motivos: 1. **Avisar de algo antes de pagar.** Un mínimo que no se cumple, un producto que tarda tres semanas, un plazo de pago que la empresa ya tiene concedido. 2. **Pedir un dato.** Número de pedido de compra, CIF, referencia interna del comprador, fecha de entrega deseada. 3. **Bloquear.** Que no se pueda pagar un carrito que el almacén no va a poder servir. 4. **Ordenar métodos.** Esconder o reordenar envíos y pagos según el carrito, el país o la empresa. Los cuatro caben en Checkout Extensibility. Lo que no cabe es mover los pasos del checkout o maquetarlo libremente, y conviene saberlo antes de prometerlo a dirección. ## Las piezas y cuál toca - **El editor** para lo visual: logotipo, colores, tipografías, orden de bloques. Sin código y sin Plus. - **Extensiones de interfaz** para añadir contenido o campos en los puntos permitidos del checkout y de la página de gracias. - **[Functions](/servicios/shopify-functions/)** para el comportamiento: validaciones que bloquean, descuentos, disponibilidad y orden de métodos de envío y de pago. La diferencia que más importa al presupuestar: una extensión que muestra un aviso es una tarde; una validación que decide si un carrito puede pagarse toca reglas de negocio y hay que escribir los casos límite antes de tocar el código. ## En B2B, dos cosas concretas El checkout de un portal mayorista se juega en dos detalles. El primero es decir el plazo de pago donde el comprador lo ve: si paga a 60 días, decirlo en el carrito y en el checkout baja el abandono más que cualquier sello. El segundo es el pedido de compra: un comprador profesional tiene que poder meter su referencia, y esa referencia tiene que llegar al pedido. ## Qué entrego La extensión o la Function con su configuración, probada en una tienda de desarrollo con los carritos que de verdad dan problemas, y escrito qué se puede cambiar desde el admin sin volver a llamarme. ### FAQ **¿Se puede maquetar el checkout como una página normal?** No. Checkout Extensibility coloca extensiones en puntos permitidos y permite cambiar logotipo, colores, tipografías y orden de bloques desde el editor, pero no reordenar libremente los pasos ni inyectar JavaScript arbitrario. Si un presupuesto da por hecho eso, está mal. **¿Necesito Plus para tocar el checkout?** Para lo visual y para apps públicas, no. Para una extensión o una Function escritas a medida para tu tienda, sí: van dentro de una app personalizada y eso requiere Shopify Plus. **¿Qué pasó con checkout.liquid?** Dejó de ser el camino. Lo que había en checkout.liquid se rehace con extensiones y Functions, y en la mayoría de los casos la mitad de lo que había ya no hace falta: eran apaños que la plataforma ahora cubre. **¿Puedo pedir un número de pedido de compra en el checkout?** Sí, con un campo en una extensión, y se puede guardar en el pedido para que llegue a la factura y al ERP. Es una de las cosas que más pide un comprador B2B. --- ## Optimización de velocidad y Core Web Vitals en Shopify URL: https://nicolasmateos.com/servicios/core-web-vitals/ Service: Optimización de rendimiento en Shopify Updated: 2026-11-05 Mido la tienda con datos de usuarios reales, no solo con Lighthouse, y arreglo lo que de verdad cuesta segundos: scripts de apps que ya nadie usa, imágenes sin dimensionar y JavaScript del tema que bloquea la interacción. ## Primero medir, y medir lo que cuenta Lighthouse sirve para comparar antes y después en condiciones iguales. Lo que decide tu posicionamiento son los datos de campo de usuarios reales: una tienda puede marcar 95 en Lighthouse y tener malos [Core Web Vitals](/glosario/core-web-vitals/) si el 70 % de sus visitas llegan desde un móvil con conexión mala. Así que la auditoría empieza por los datos reales y por saber de dónde vienen tus visitas. Optimizar el escritorio de una tienda cuyo tráfico es 80 % móvil es trabajo tirado. ## El orden en el que arreglo 1. **Apps fantasma.** La app se quita del panel y su script sigue cargando. Es lo primero que miro y casi siempre hay dos o tres. Es también el arreglo más rentable: quitar peso no tiene riesgo de diseño. 2. **Imágenes.** Tamaño declarado, formato moderno, la principal cargada pronto y fuera de cualquier carrusel que necesite JavaScript para pintar el primer fotograma. 3. **JavaScript del tema.** Normalmente es el carrito: reconstruirlo a mano en cada cambio cuando se puede pedir la sección ya renderizada a Shopify. 4. **[Liquid](/glosario/liquid/) caro.** Bucles anidados sobre colecciones grandes. La solución casi siempre es mover el cálculo a un metacampo. ## Lo que entrego El antes y el después medidos con el mismo método, la lista de lo que se tocó y por qué, y lo que no he tocado porque el riesgo no compensaba. En [la página de código](/codigo/) puedes ver los números de esta web, medidos sobre el sitio desplegado y no en local. ## SEO y visibilidad en asistentes de IA Si el objetivo es que buscadores y asistentes comprendan mejor tus productos, la [consultoría GEO para Shopify](/servicios/geo-shopify/) conecta el trabajo técnico con contenido, datos estructurados y medición de citas. El rendimiento y el tema son parte de la revisión; por sí solos no demuestran visibilidad en IA. ### FAQ **¿Puedo llegar a 100 en Lighthouse?** En una tienda real con apps, casi nunca, y no es el objetivo. Lo que se puede conseguir es pasar los tres Core Web Vitals con datos de usuarios reales, que es lo que mira Google y lo que nota el comprador. **¿Qué suele ser el problema?** Por frecuencia: scripts de apps desinstaladas que siguen cargando, imágenes sin width y height, la imagen principal dentro de un carrusel que arranca con JavaScript, y el carrito reconstruido a mano en cada cambio. **¿Hay que cambiar de tema?** Casi nunca. En las auditorías que he hecho, la mayor parte del tiempo perdido no está en el tema: está en lo que se le ha ido añadiendo encima. --- ## Área de cliente y extensiones de cuenta en Shopify URL: https://nicolasmateos.com/servicios/cuentas-de-cliente/ Service: Desarrollo del área de cliente en Shopify Updated: 2026-10-21 El área de cliente es donde vive un comprador mayorista: su histórico, sus pedidos pendientes, su tarifa, su sede. Monto esa zona con extensiones de cuenta y el front-end que la hace útil en lugar de decorativa. ## Por qué importa más en B2B que en B2C Un cliente B2C entra a su cuenta una vez, para ver dónde está el envío. Un comprador mayorista entra cada semana: es su herramienta de trabajo. Si no encuentra lo que busca, no se va a la competencia, llama por teléfono, y esa llamada la paga tu equipo. ## Lo que monto, por orden de lo que se usa 1. **Repetir el último pedido.** La función más usada de cualquier portal mayorista. Un botón que recrea el pedido en el carrito, con sus cantidades, y que avisa de lo que ya no está disponible. 2. **Pendiente de pago y vencimientos.** Si la empresa tiene [plazo de pago](/glosario/condiciones-de-pago/), esto es lo primero que mira. Que esté, y que cuadre con la factura. 3. **Facturas descargables**, donde el comprador las busca y no en un email de hace dos meses. 4. **[Selector de sede](/glosario/sede-de-empresa/)**, si compra para varias delegaciones, y en la cabecera, no enterrado aquí: cambiar de sede puede cambiar todos los precios del carrito. ## El detalle de los precios La regla que repito en todos los proyectos: si el visitante no es B2B, el precio **no debe llegar al HTML**. La condición de Liquid sobre `customer.b2b?` es la forma correcta; esconderlo con CSS deja el precio en el código fuente, visible para cualquiera que mire y para cualquier buscador. ## Lo que no depende del plan Casi todo lo de arriba se monta en el tema y funciona sin Plus. Lo que necesita [Shopify Plus](/glosario/shopify-plus/) son las extensiones de cuenta escritas a medida, porque van dentro de una app personalizada. Conviene saber qué parte del presupuesto depende del plan antes de prometerlo. ### FAQ **¿Qué pide de verdad un comprador B2B en su cuenta?** Cuatro cosas, por orden: repetir el último pedido, ver qué tiene pendiente de pago y cuándo vence, descargar facturas y cambiar de sede. Lo demás es decoración. **¿Necesito Plus para las extensiones de cuenta?** Una extensión escrita a medida para tu tienda va dentro de una app personalizada, y eso requiere Shopify Plus. Buena parte del valor, en cambio, se consigue en el tema y sin Plus. **¿Se puede ocultar el precio hasta que el comprador entra?** Sí, y es lo correcto: con la condición customer.b2b? el precio no llega al HTML de quien no tiene sesión. Ocultarlo por CSS no cuenta, porque sigue estando en el código fuente. --- ## Consultoría GEO para Shopify: SEO y visibilidad en IA URL: https://nicolasmateos.com/servicios/geo-shopify/ Service: Consultoría e implementación GEO para Shopify Updated: 2026-11-05 El GEO para Shopify mejora la forma en que buscadores y asistentes de IA pueden encontrar, comprender y citar una tienda. Soy Nicolás Mateos: ofrezco auditoría, contenido e implementación técnica para conectar tus productos y tu marca con preguntas reales de compra, con una línea base y resultados medidos. ## Qué incluye el servicio de GEO para Shopify La consultoría empieza por las preguntas que tus compradores hacen antes de elegir un producto o proveedor. La auditoría relaciona cada intención con una URL existente para mejorar la respuesta principal y evitar páginas que compitan por la misma consulta. | Área | Trabajo | Entregable | | --- | --- | --- | | Diagnóstico | Revisar productos, colecciones, guías, competencia y consultas en español o inglés | Mapa de consultas, URLs y problemas priorizados | | SEO técnico | Comprobar HTML, rastreo, indexabilidad, canonical, sitemap, idiomas y rendimiento | Lista de incidencias con evidencia y correcciones acordadas | | Contenido para respuestas | Definiciones, criterios de elección, tablas, FAQ y límites de uso con fuentes | Páginas revisadas y bloques que se entienden fuera de contexto | | Entidades y catálogo | Revisar identidad, autoría, datos estructurados y coherencia con el producto visible | Marcado validado y datos de producto coherentes | | Medición | Registrar respuestas, menciones, citas, tráfico y contactos | Línea base y seguimiento comparable por motor e idioma | ## Cómo se aplica al catálogo de Shopify Una ficha útil explica qué es el producto, para quién sirve, materiales, medidas, compatibilidades y límites, cuando esos datos están disponibles. Las colecciones ayudan a elegir; las guías resuelven dudas que una ficha no cubre. Las políticas de envío y devolución deben ser claras y coherentes con la operativa real. Reviso el HTML y el marcado que ya generan el tema y las apps antes de añadir otro bloque. El objetivo es evitar entidades duplicadas, precios contradictorios o atributos inventados. Si hace falta modificar el tema, puedo ejecutar la [implementación en Shopify](/servicios/temas-shopify-a-medida/); si el problema es la carga, se concreta en una [auditoría de rendimiento](/servicios/core-web-vitals/). En B2B, la auditoría separa información pública de condiciones privadas. El trabajo GEO no debe exponer precios negociados, catálogos restringidos ni datos de clientes para facilitar el rastreo. ## Método: diagnóstico, implementación y seguimiento 1. **Definir la oportunidad.** Acordamos productos o servicios prioritarios, países, idiomas y consultas de compra. Registramos qué URLs aparecen y qué fuentes se citan antes de cambiar contenido. 2. **Priorizar con evidencia.** Cada incidencia incluye URL, problema observado, propuesta y criterio de aceptación. Separamos bloqueos técnicos de mejoras editoriales y dependencias del equipo. 3. **Implementar y comprobar.** Revisamos texto visible, enlaces internos, metadatos, datos estructurados y equivalencia entre idiomas. Las correcciones del tema se prueban antes de publicarlas. 4. **Comparar con el mismo método.** Repetimos las consultas acordadas, guardamos respuestas y analizamos tráfico y contactos cuando existen datos. El informe diferencia cambios observados de hipótesis sobre su causa. ## Qué evidencia puedo mostrar Este portfolio permite inspeccionar una implementación propia: [servicios](/servicios/), [glosario](/glosario/), páginas bilingües, [índice para asistentes](/llms.txt) y [texto de referencia con URLs de atribución](/llms-full.txt). Son ejemplos de arquitectura y publicación, no un caso de aumento de ventas atribuido a GEO. Mi trabajo de [desarrollo Shopify](/sobre-mi/) desde 2021 permite conectar la propuesta editorial con cambios en el tema y su validación. No presento resultados GEO de clientes que no estén documentados y autorizados. ## Cómo medimos la visibilidad en IA El registro incluye fecha, consulta exacta, idioma, motor, modelo visible, contexto geográfico, respuesta guardada, mención de marca y URLs citadas. Una muestra de búsquedas web no sustituye una prueba en un asistente, y una mención sin enlace no equivale a una cita. Medimos por separado menciones, citas, visitas referidas y contactos con origen declarado. Si no hay acceso a Search Console, analítica o datos de contacto, el informe explica ese límite. No atribuimos ventas ni causalidad a una captura aislada y no fijamos un plazo universal para conseguir citas. ## Fundamentos y fuentes La propuesta se apoya en contenido útil, acceso técnico e información verificable. La [documentación de Google sobre funciones de IA](https://developers.google.com/search/docs/appearance/ai-features) explica la relación con los fundamentos SEO. La [guía SEO de Shopify](https://help.shopify.com/en/manual/promoting-marketing/seo) sirve de referencia para revisar la tienda. Ningún marcado obliga a un motor a recomendar una marca. ## Pide un diagnóstico GEO de tu Shopify Envíame la URL de tu tienda, mercados, idiomas y las categorías que quieres priorizar. Prepararé el alcance de la auditoría, los accesos necesarios y una propuesta de entregables antes de implementar cambios. [Solicitar una auditoría GEO para Shopify](/contacto/#geo). ## Conceptos y criterios antes de contratar Consulta qué significan [GEO](/glosario/geo/) y [AEO](/glosario/aeo/), la [comparativa SEO frente a GEO](/comparativas/seo-vs-geo-shopify/) y [cómo medir los resultados](/preguntas/medir-geo-shopify/). ### FAQ **¿Qué es GEO en una tienda Shopify?** GEO significa Generative Engine Optimization: mejorar la información y el acceso técnico de una tienda para que los motores generativos puedan comprenderla y citarla. En Shopify se trabaja sobre productos, colecciones, guías, identidad de marca y el HTML del tema. **¿Qué diferencia hay entre SEO, AEO y GEO?** SEO busca visibilidad en buscadores; AEO organiza respuestas claras a preguntas; GEO aborda la presencia de una marca o una fuente en respuestas generadas por IA. Comparten fundamentos y se trabajan juntos, con métricas distintas. **¿Puedes garantizar que ChatGPT recomiende mi tienda?** No. Los motores deciden qué fuentes usan y sus respuestas cambian según la consulta y el contexto. El servicio entrega mejoras comprobables y medición; una cita observada no garantiza futuras recomendaciones ni ventas. **¿Cuánto cuesta una auditoría GEO para Shopify?** El presupuesto se define por tamaño del catálogo, mercados, idiomas, estado técnico y alcance de la implementación. Puedes contratar el diagnóstico primero y decidir después qué mejoras ejecutar; no hay una tarifa universal ni una cuota obligatoria. **¿Necesito una app o un archivo llms.txt?** La auditoría comprueba primero el contenido, el HTML y los obstáculos de acceso. Una app o un archivo llms.txt pueden evaluarse como complemento, pero su presencia por sí sola no demuestra indexación, citas ni mejora de posición. --- ## Integraciones de Shopify con ERP y sistemas externos URL: https://nicolasmateos.com/servicios/integraciones-erp/ Service: Integración de Shopify con sistemas externos Updated: 2026-10-21 Conecto Shopify con el ERP, el almacén o el PIM que ya tienes: stock, precios, clientes, pedidos y facturas. Lo difícil nunca es GraphQL, es decidir quién gana cuando los dos lados cambian el mismo dato. ## Las tres decisiones que hay que tomar antes del código Ninguna es técnica, y las tres se pagan caras si se dejan sin decidir: **Quién es la fuente de verdad de cada dato.** Si el ERP y Shopify pueden modificar el stock, hay que decidir el sentido y escribirlo. Casi todas las integraciones que he visto romperse tenían este punto a medias. **Qué pasa con lo que falla.** Una línea rechazada no puede quedarse en silencio. Hace falta reintento, un registro y alguien que lo mire. Sin eso, el fallo aparece tres semanas después como "nos falta un pedido". **Cómo se identifican las cosas.** La referencia del ERP y la del catálogo de Shopify casi nunca coinciden. Esa correspondencia tiene que vivir en algún sitio, y lo normal es un [metacampo](/glosario/metacampos/). ## Lo que la plataforma pone de su parte La [Admin API GraphQL](/glosario/api-graphql-de-admin/) tiene presupuesto por consulta y por ventana de tiempo: una sincronización que recorre 20.000 variantes de una en una se lo come, y hecha por lotes no. Para cargas grandes están las operaciones masivas, que son más lentas de programar y la diferencia entre una sincronización nocturna que termina y una que se queda a medias. Y en el otro sentido, los webhooks: Shopify avisa de un pedido nuevo en lugar de que tú preguntes cada cinco minutos. ## En B2B hay un dato más Un portal mayorista añade las empresas, sus sedes y su tarifa. Si el ERP es el que decide a qué nivel pertenece cada cliente, esa asignación también se sincroniza, y conviene decidir quién puede cambiarla desde Shopify: normalmente, nadie. ### FAQ **¿App a medida o conector del mercado?** Si tu ERP es uno de los grandes y tu modelo de datos es estándar, un conector del mercado sale más barato y lo mantiene otro. Una integración a medida se justifica cuando el modelo no es estándar: tarifas B2B por empresa, stock por almacén, referencias que no coinciden. **¿Puede una Shopify Function consultar el ERP?** No. Una Function no hace llamadas de red. Si una regla de carrito depende de un dato del ERP, ese dato se sincroniza antes a un metacampo y la Function lo lee de ahí. **¿Cada cuánto se sincroniza?** Depende del dato. El stock, lo más cerca de tiempo real que aguante el ERP, con webhooks en el sentido Shopify a ERP. Los precios y el catálogo, por lotes y de noche, que es cuando se puede reintentar sin prisa. --- ## Migración a Shopify desde otra plataforma URL: https://nicolasmateos.com/servicios/migracion-a-shopify/ Service: Migración a Shopify Updated: 2026-10-21 Migraciones a Shopify desde WooCommerce, PrestaShop, Magento o un desarrollo propio, con el front-end rehecho y, lo que más duele si se olvida, las URLs redirigidas una por una. ## El orden que menos sorpresas da **1. Inventario de URLs antes que nada.** Antes de hablar de diseño, saco la lista de URLs con tráfico y con enlaces entrantes. Esa lista es la que decide la estructura de la tienda nueva, no al contrario. **2. Modelo de datos.** Qué era un producto, qué era una variante y qué era un campo propio en la plataforma vieja. Lo que no encaja en Shopify de serie va a [metacampos](/glosario/metacampos/) o a metaobjetos, y eso se decide antes de importar, no después. **3. Catálogo e históricos.** Productos, variantes, imágenes, clientes y pedidos como histórico. **4. Front-end.** Sobre un tema de pago o [a medida](/servicios/temas-shopify-a-medida/), con las secciones que tu equipo va a usar. **5. Redirecciones, una por una.** Cada URL con valor a su equivalente. No a la portada: a su equivalente. **6. Comprobación después de publicar.** Rastreo del sitio nuevo buscando 404 y cadenas de redirección, y seguimiento de las posiciones las semanas siguientes. ## Lo que se olvida y luego cuesta Las funcionalidades propias de la plataforma vieja. Un módulo de PrestaShop o un plugin de WooCommerce que llevaba años haciendo algo que nadie recuerda haber pedido. Si no se inventaría antes de migrar, aparece el día después de publicar, normalmente en forma de "es que antes se podía...". Mi forma de reducirlo: listar las funcionalidades con el equipo que atiende a los clientes, no solo con quien gestiona la web. Las cosas que importan de verdad las conoce quien recibe las llamadas. ### FAQ **¿Voy a perder posicionamiento?** No si las redirecciones se hacen bien. La pérdida de tráfico en una migración casi siempre viene de lo mismo: URLs viejas que acaban en un 404 o redirigidas todas a la portada. Cada URL con tráfico o enlaces tiene que ir a su equivalente concreta. **¿Se pueden migrar los pedidos antiguos?** Se pueden importar como histórico, sin estado real de pago ni de envío. Sirve para que el comprador vea lo que compró y para los informes; no sirve para gestionar devoluciones de esos pedidos. **¿Cuánto se tarda?** Depende del catálogo y de cuántas funcionalidades propias había. Lo que nunca va rápido es el inventario de URLs y el mapa de redirecciones, y es justo lo que no se puede recortar. --- ## Migración de Shopify Scripts a Functions URL: https://nicolasmateos.com/servicios/migracion-scripts-a-functions/ Service: Migración de Shopify Scripts a Shopify Functions Updated: 2026-10-21 Shopify Scripts dejó de ejecutarse en junio de 2026. Si tu tienda tenía descuentos, portes o métodos de pago controlados por un Script, hoy esa regla no se está aplicando. Reviso qué hacía cada Script, qué sigue hacen falta y lo reescribo como Function. ## El orden que sigo **1. Inventario.** Qué Scripts había, qué hacía cada uno y cuándo se tocó por última vez. En tiendas con varios años encima suele aparecer algún Script que nadie recuerda haber pedido. **2. Descarte.** Por cada regla, la pregunta es si sigue hacen falta y si la plataforma ya la cubre. Los tres Scripts más comunes eran descuento por etiqueta de cliente, ocultar envíos según el carrito y reordenar métodos de pago. En B2B, dos de ellos se resuelven hoy sin código: el descuento por nivel es un [catálogo](/glosario/catalogo-b2b/) y el mínimo por caja son [reglas de cantidad](/glosario/reglas-de-cantidad/). **3. Reescritura.** Lo que queda se escribe como [Function](/servicios/shopify-functions/), con su input query ajustada y sus pruebas. **4. Comprobación.** Se despliega en una tienda de desarrollo y se pasan los carritos que de verdad importan: el pedido grande, el que mezcla tarifas, el que está en el límite del mínimo. ## Lo que cambia respecto a un Script Tres cosas, y son las que obligan a rediseñar en lugar de traducir. Un Script veía el carrito entero; una Function solo recibe los campos que su input query pide. Un Script no tenía presupuesto visible; una Function sí, y eso descarta recorrer el catálogo dentro del código. Y una Function se despliega como app, con versiones y configuración, en lugar de ser texto guardado en el admin: más trabajo la primera vez, mucho menos riesgo después. ## El requisito de plan Una Function escrita a medida va dentro de una app personalizada, y eso solo se puede instalar en tiendas con [Shopify Plus](/glosario/shopify-plus/). Si tenías Scripts, ya tienes Plus, así que este punto rara vez bloquea esta migración en concreto. ### FAQ **¿Qué pasa si no migro?** Nada visible, y eso es el problema. Scripts dejó de ejecutarse en junio de 2026: no da error, simplemente la regla no se aplica. Un descuento por nivel de cliente que dejó de aplicarse se nota en el margen, no en el panel. **¿Se traduce el Ruby a JavaScript y listo?** No. El modelo es distinto: una Function declara en su input query qué datos necesita y solo recibe esos, tiene un presupuesto de instrucciones y se despliega como una app con versiones. Es un rediseño corto, no una traducción. **¿Cuántos de mis Scripts voy a necesitar de verdad?** En los proyectos que he visto, la mitad. Varias de las reglas más comunes hoy se resuelven sin código: un descuento por nivel es un catálogo B2B y un mínimo por caja son reglas de cantidad. Eso sale en la auditoría antes de escribir nada. --- ## Desarrollo de Shopify Functions URL: https://nicolasmateos.com/servicios/shopify-functions/ Service: Desarrollo de Shopify Functions Updated: 2026-11-05 Escribo Functions de descuento, validación de carrito, transformación de líneas y métodos de envío y de pago, en JavaScript o Rust, con su input query ajustada y sus pruebas. Si tu regla de negocio no cabe en una app del App Store, cabe aquí. ## Cuándo hace falta una Function Cuando la regla es tuya. Los tres casos que más me llegan: - **Validaciones que bloquean el checkout.** Cajas completas, mínimo por empresa, no mezclar tarifas, un producto que exige otro. La plataforma trae mínimos por variante y, desde abril de 2026, un [pedido mínimo](/blog/pedido-minimo-shopify/) único con Checkout Blocks; nada que cambie según la empresa o lo que lleva el carrito. - **Descuentos que ninguna app calcula igual.** Escalados por familia de producto, por sede de la empresa, combinaciones excluyentes. - **Envíos y pagos condicionados.** Ocultar contra reembolso por encima de un importe, reordenar métodos según el peso, esconder una transportadora para una zona. Si lo que necesitas es uno de los descuentos estándar, una app del App Store sale más barata y la mantiene otro. Te lo diré si es el caso. ## Cómo las escribo Lo que diferencia una Function que aguanta de una que falla el primer pedido grande no es la lógica: es el input. Una Function tiene un presupuesto de ejecución del orden de 11 millones de instrucciones y un tope de 128 kB en su input. En un carrito de diez líneas eso no se nota. En un bloc de pedido mayorista de 200 líneas, cada campo que pides de más se multiplica por 200. Así que la input query pide exactamente los campos que lee el código, con alias para que los metacampos lleguen con un nombre legible. El segundo detalle, que cuesta dos días de soporte cuando se olvida: el `buyerJourney`. Una validación que bloquea en todos los pasos impide al comprador escribir 7 camino de 12. Se bloquea en el checkout, no mientras se edita el carrito. ## Lo que puedes ver antes de contratarme Una Function de validación completa, con su input query y sus pruebas, está publicada en [shopify-checkout-lab](https://github.com/NicolasShopiDev/shopify-checkout-lab), y en la [portada](/) hay un Checkout Lab donde puedes cambiarle la configuración y ver qué deja de funcionar. Es el mismo archivo que se despliega a una tienda. ## Cómo trabajamos Primero me cuentas la regla en palabras, con un caso real y un caso límite. Si la regla se puede resolver sin código (un [catálogo](/glosario/catalogo-b2b/), unas [reglas de cantidad](/glosario/reglas-de-cantidad/)), te lo digo y te ahorras el desarrollo. Si no, escribo la Function con sus pruebas, la desplegamos en una tienda de desarrollo y la probamos con tu carrito más feo antes de tocar producción. ## Qué necesitamos para presupuestar la regla Prepara tu plan actual, la regla en una frase y tres ejemplos anonimizados: un pedido válido, uno que deba rechazarse o cambiar y una excepción. En cada ejemplo, indica el resultado esperado y de dónde salen los datos. Así podemos delimitar qué parte corresponde a la Function y qué trabajo de integración se presupuestaría aparte. ## Qué revisamos antes de aceptar la entrega La propuesta debe identificar la regla incluida, las excepciones, los datos necesarios y los casos de prueba acordados. Al entregar, revisamos esos resultados en la tienda de desarrollo y la documentación que permite localizar el código, cambiar la configuración y entender las limitaciones. El [Checkout Lab](/#lab) es una demostración técnica con ejemplos, no un caso de cliente al que atribuir resultados comerciales. Si quieres valorar una regla propia, [cuéntame los tres casos](/contacto/) antes de decidir la implementación. ### FAQ **¿Necesito Shopify Plus para una Function a medida?** Sí. Solo las tiendas con Shopify Plus pueden instalar apps personalizadas que contengan Shopify Functions. En Basic, Grow y Advanced puedes usar funciones que vengan dentro de una app pública del App Store, pero no una escrita para tu tienda. **¿JavaScript o Rust?** JavaScript para la mayoría de los casos: se lee, se prueba y lo puede mantener cualquiera. Rust cuando la función recorre carritos muy grandes y el presupuesto de instrucciones aprieta. Lo decido con el caso delante, no por defecto. **¿Puede una Function consultar mi ERP?** No. Una Function no hace llamadas de red: solo ve los datos que pide en su input query. Si la regla depende de un dato externo, ese dato tiene que estar antes en un metacampo, y eso es trabajo de integración. **¿Qué entregas exactamente?** La app personalizada con la Function, su input query, sus pruebas unitarias, la configuración en el admin y un documento corto con qué hace, qué datos necesita y cómo se cambia. El código es tuyo y es revisable. --- ## Shopify multimercado e internacional URL: https://nicolasmateos.com/servicios/shopify-markets/ Service: Configuración y desarrollo de Shopify Markets Updated: 2026-10-21 Vender en varios países desde una sola tienda: mercados con su moneda, idioma e impuestos, el selector que no rompe el carrito y el hreflang bien puesto para que tus versiones no compitan entre ellas. ## Lo que se decide antes de tocar nada [Shopify Markets](/glosario/shopify-markets/) agrupa países con su moneda, sus idiomas, sus impuestos y sus ajustes de precio. La configuración es la parte fácil. Lo que de verdad hay que dibujar antes es el cruce con los precios, y en B2B eso es crítico: sin Plus, un [catálogo](/glosario/catalogo-b2b/) se asigna a un mercado B2B, no a una empresa, y solo puedes tener tres activos. El ejemplo que sale en casi todas las reuniones: si los niveles son "mayorista España", "mayorista Portugal" y "distribuidor", ya están gastados los tres y no queda hueco para cuentas clave. Media hora de pizarra ahorra el rediseño. ## El trabajo de front-end - **El selector de país e idioma** tiene que estar visible y no reiniciar el carrito al cambiar. - **Los precios redondeados por mercado** cambian lo que muestra la ficha. Si el tema guarda precios en JavaScript, hay que invalidarlos al cambiar de mercado, o el comprador ve un precio y paga otro. - **Los textos traducidos** que están en el tema, no en el contenido: avisos de envío, etiquetas de formulario, mensajes de error. ## El SEO internacional, que es donde se pierde tráfico Cada versión necesita su `hreflang`, apuntando a sus equivalentes y a sí misma, con un `x-default`. Una tienda con cuatro mercados y un solo `hreflang` compite consigo misma y Google elige por ti, normalmente mal. El segundo error habitual: redirigir por IP. Si un comprador alemán no puede ver la versión española ni al robot de Google se le deja ver todas las versiones, lo que se indexa es una sola. Se detecta el país y se **ofrece** el cambio, no se impone. ### FAQ **¿Una tienda por país o Markets?** Markets, salvo que cada país tenga catálogo, fiscalidad y equipo distintos. Varias tiendas significan varios temas que mantener y varios inventarios que cuadrar; la mayoría de los proyectos que empiezan así acaban unificando. **¿Cómo afecta Markets a un portal B2B?** Mucho más de lo que parece. Sin Shopify Plus los catálogos B2B se asignan a través de mercados B2B, así que tu segmentación de precios tiene que caber en tu segmentación geográfica, con un tope de tres catálogos activos. **¿Subcarpeta o dominio por país?** Subcarpeta en casi todos los casos: concentra la autoridad del dominio y es menos infraestructura. Un dominio propio por país se justifica cuando la marca se percibe como local y eso vale más que la autoridad acumulada. --- ## Temas Shopify a medida URL: https://nicolasmateos.com/servicios/temas-shopify-a-medida/ Service: Desarrollo de temas Shopify a medida Updated: 2026-11-05 Implemento tu diseño o el de tu agencia en Shopify, desde cero o sobre un tema de pago, con secciones y bloques que tu equipo puede editar. Antes de presupuestar, reviso las plantillas, las funciones y las apps que deben seguir funcionando. ## Lo que marca la diferencia dos años después Dos temas pueden verse igual el día de la entrega. En uno, el cliente monta una landing en veinte minutos; en el otro, pide presupuesto cada vez que quiere cambiar un texto. La diferencia está en cómo se partieron las [secciones y los bloques](/glosario/secciones-y-bloques/), y eso no se ve en la maqueta. Mi criterio: una sección por intención de página, no por fila del diseño. Tres bandas de texto con imagen que solo cambian el lado de la foto son una sección con un ajuste, no tres secciones. Y al revés: una sección con cuarenta ajustes que nadie entiende está igual de mal partida. ## Lo que entra siempre - **Secciones con valores por defecto sensatos**, que se ven bien antes de configurar nada. - **Bloques con límite**, porque un carrusel que admite treinta bloques acabará con treinta. - **Textos en los ajustes**, no en el código, y nombres en español si el equipo trabaja en español. - **Imágenes con tamaño declarado** y la principal cargada pronto, que es la mitad del rendimiento. - **Lo que se repite entre páginas en [metaobjetos](/glosario/metaobjetos/)**: el cliente lo edita una vez y cambia en 200 fichas. ## Rendimiento desde el principio Un tema rápido no se consigue optimizando al final. Se consigue no metiendo el problema: no cargar la imagen principal dentro de un carrusel que arranca con JavaScript, no recorrer colecciones enteras en [Liquid](/glosario/liquid/) para calcular algo que cabe en un metacampo, y no repintar el carrito a mano cuando se puede pedir la sección ya renderizada. ## Proyectos que puedes revisar antes de contratar En [Qurado](/proyectos/#qurado) implementé una tienda a partir de un sistema de diseño ya definido, con filtros personalizados y un flujo de producto y carrito pensado para móvil. Es un ejemplo pertinente si ya tienes diseño y buscas a quien lo lleve a Shopify. En [Fernando de Cárcer](/proyectos/#fernando-de-carcer) desarrollé el tema desde la arquitectura hasta el lanzamiento, con filtrado de colecciones, guías de tallas e integración de lista de deseos. Las fichas describen mi contribución; no atribuyen al desarrollo un aumento de ventas que no se haya medido. ## Qué necesito para valorar tu diseño Envíame el diseño disponible, la URL de la tienda y del tema actual, las plantillas necesarias y las apps que afectan a producto, carrito o búsqueda. Indica también qué cambios debe poder hacer tu equipo desde el editor y quién valida el trabajo. Con eso podemos separar adaptar el tema actual, crear secciones nuevas o desarrollar un tema completo. El diseño gráfico, la redacción, la carga de catálogo y las integraciones externas deben figurar como partidas aparte si forman parte del encargo. ## Cómo comprobamos la entrega Antes de empezar, acordamos una lista de pantallas y recorridos: editar una sección, buscar un producto, elegir una variante, añadir al carrito y continuar al checkout. La revisión incluye móvil y escritorio, las apps del alcance y el traspaso del código con instrucciones de edición. [Cuéntame qué diseño quieres implementar](/contacto/) y qué debe poder gestionar tu equipo para valorar el alcance. ## SEO y visibilidad en asistentes de IA Si el objetivo es que buscadores y asistentes comprendan mejor tus productos, la [consultoría GEO para Shopify](/servicios/geo-shopify/) conecta el trabajo técnico con contenido, datos estructurados y medición de citas. El rendimiento y el tema son parte de la revisión; por sí solos no demuestran visibilidad en IA. ### FAQ **¿Tema a medida o uno de pago personalizado?** Uno de pago personalizado, casi siempre, y lo digo aunque facture menos. Un tema a medida se justifica cuando el de pago ya se ha tocado tanto que actualizarlo es imposible, o cuando la marca necesita algo que ningún tema del catálogo hace. **¿Puedo seguir actualizando el tema después?** Si partimos de un tema de pago y los cambios van en secciones nuevas y en un archivo propio, sí, con cuidado. Si el tema se escribe desde cero, las actualizaciones las haces tú o las hago yo, pero no vienen de un proveedor. **¿Entra el diseño?** No diseño. Trabajo con tu diseño, con el de tu agencia o con el del tema. Lo que hago es el front-end, y donde el diseño choca con cómo funciona Shopify, lo digo antes de maquetarlo. --- ## B2B nativo vs App de wholesale URL: https://nicolasmateos.com/comparativas/b2b-nativo-o-app-de-wholesale/ Updated: 2026-10-21 Facts checked: 2026-10-21 Verdict: B2B nativo, por defecto y en cualquier plan que lo soporte: el precio llega resuelto al tema en lugar de recalcularse encima, y no hay cuota mensual ni dependencia de un tercero. Una app pública solo gana cuando necesitas descuentos por cuenta y no tienes Plus, o cuando el flujo lo pone la app entera y te vale su modelo. | Criterion | B2B nativo | App de wholesale | | --- | --- | --- | | Cómo se calcula el precio | En la plataforma; llega al tema ya resuelto | Encima, por la app, normalmente en el carrito | | Riesgo de que el comprador vea un precio y pague otro | No: el precio del HTML es el del catálogo | Sí, si la app aplica el descuento más tarde | | Precio por cuenta sin Plus | No: los catálogos se asignan por mercado | Sí, es su caso de uso principal | | Coste recurrente | Ninguno más allá del plan | Cuota mensual por tienda | | Flujo de pedido (tabla, búsqueda por SKU) | No incluido: es trabajo de front-end | Según la app, y con su diseño | | Qué pasa si se desinstala | No aplica | Se van los precios y a veces queda el script cargando | ## Lo que cambió y por qué la pregunta es nueva Durante años, vender al por mayor en Shopify quería decir instalar una app. Hoy la documentación de Shopify lista B2B en Basic, Grow, Advanced y Plus, y lo excluye solo de Starter y Retail. Eso convierte la app, en la mayoría de los casos, en una capa que ya no hace falta. La diferencia técnica tiene una consecuencia muy práctica: con B2B nativo, el precio del [catálogo](/glosario/catalogo-b2b/) **ya está resuelto** cuando el tema lo pide. Con una app que calcula el descuento en el carrito, existe una ventana en la que el comprador ve un precio y paga otro, y esa ventana es el origen de la mitad de las incidencias de un portal mayorista. ## Donde la app todavía gana Un caso, y es concreto: **precio negociado cuenta por cuenta sin Shopify Plus**. Sin Plus los catálogos se asignan a mercados B2B, no a empresas, así que para una lista por cuenta solo quedan dos caminos: pasar a Plus o usar una app pública. Si el salto de plan no entra en el presupuesto, la app es la respuesta correcta. El segundo caso es más de calendario que de técnica: si necesitas el portal funcionando la semana que viene y la app trae el flujo entero con su diseño, puede valer como puente. Conviene saber que es un puente. ## El error que cuesta dinero Pagar una app mensual esperando que resuelva el flujo de pedido. Casi todo lo que se le pide a una app de wholesale no es precio: es [tabla de pedido](/glosario/pedido-rapido/) por variante con stock, búsqueda por referencia, reglas de cantidad en el propio campo, repetir el último pedido. Eso es front-end sobre el tema, funciona en cualquier plan con B2B, y ninguna app de precios lo trae resuelto para tu marca. Es el punto donde más presupuesto he visto tirar: una cuota mensual que cubre el 20 % del problema, y el 80 % sigue sin estar. --- ## Un freelance vs Una agencia URL: https://nicolasmateos.com/comparativas/freelance-o-agencia-shopify/ Updated: 2026-10-21 Facts checked: 2026-10-21 Verdict: Un freelance para un proyecto con alcance claro y una especialidad concreta: hablas con quien escribe el código y no hay capa en medio. Una agencia cuando necesitas varias disciplinas a la vez (diseño, campañas, contenido) o cuando tu empresa no puede depender de una sola persona durante años. | Criterion | Un freelance | Una agencia | | --- | --- | --- | | Con quién hablas | Con quien escribe el código | Con un gestor de proyecto | | Especialización | Alta y concreta | Amplia, con niveles distintos por perfil | | Riesgo de continuidad | Una persona; hay que mitigarlo con el repositorio | Menor, si documentan y rotan bien | | Varias disciplinas a la vez | Hay que coordinar a varios freelance | Incluidas | | Velocidad en cambios pequeños | Alta: no hay capa intermedia | Depende del proceso | | Coste por hora de desarrollo | Menor en general | Mayor; incluye la estructura | ## El riesgo real de cada opción, dicho sin adornos El de un freelance es obvio: es una persona. Si desaparece, el proyecto se queda sin su memoria. Eso se mitiga con tres cosas concretas, y las tres son tuyas por contrato: el código en un repositorio **tuyo** desde el primer día, los cambios en archivos propios y no repartidos por el tema, y lo que se decidió escrito en algún sitio. El de una agencia es menos visible: la distancia. Hablas con quien gestiona, no con quien escribe, y en proyectos técnicos eso introduce una traducción en cada iteración. También pasa que el perfil que te enseñaron en la propuesta no es el que acaba tocando tu tienda. ## El caso híbrido, que es el más común y nadie cuenta Muchas marcas trabajan con una agencia para diseño, contenido y campañas, y con un especialista para la parte técnica difícil. Yo trabajo así de hecho: desde octubre de 2024 soy el único desarrollador front-end de una agencia Shopify Plus centrada en B2B, cuyas tiendas mueven en conjunto más de 36 M€ al año, y a la vez llevo proyectos directos. Es la combinación que mejor funciona cuando hay una agencia que ya conoce la marca y una pieza técnica que requiere especialización: B2B, [Functions](/glosario/shopify-functions/), checkout o rendimiento. ## Cómo decidir en una frase Si puedes escribir el alcance en una página y el problema es técnico, un freelance. Si el problema es "necesitamos crecer y no sabemos por dónde", una agencia. Y si ya tienes agencia y lo que falta es una especialidad, no cambies de agencia: añade al especialista. Las [seis preguntas que conviene hacer antes de contratar](/preguntas/que-preguntar-a-un-desarrollador-shopify/) valen igual para los dos casos. --- ## SEO vs GEO URL: https://nicolasmateos.com/comparativas/seo-vs-geo-shopify/ Updated: 2026-11-05 Verdict: Prioriza los bloqueos de acceso y las respuestas de producto que faltan antes de separar SEO y GEO en presupuestos distintos. Comparten fundamentos; añade un seguimiento de respuestas de IA cuando tengas consultas de compra y una línea base reproducible. | Criterion | SEO | GEO | | --- | --- | --- | | Objetivo | Visibilidad en resultados de búsqueda | Menciones y citas en respuestas generadas | | Trabajo compartido | Acceso, enlaces, contenido útil y datos coherentes | Los mismos fundamentos, con respuestas autosuficientes | | Medición | Impresiones, clics, consultas y conversiones | Respuestas guardadas, menciones, URLs citadas y contactos | | Límite | Indexación y posición no garantizadas | Citas y recomendaciones no garantizadas | ## Cuándo priorizar SEO técnico Si una colección no es indexable, los enlaces apuntan a URLs equivocadas o el contenido del producto no aparece en el HTML, empieza por esos problemas. Una capa editorial adicional no corrige un bloqueo de acceso. Revisa también idiomas, canonical y sitemap antes de multiplicar páginas. ## Cuándo añadir seguimiento GEO Cuando puedes definir preguntas de compra relevantes y guardar respuestas comparables, merece la pena observar qué marcas y fuentes aparecen. Una tienda con datos de producto incompletos necesita primero completar información; una tienda con información sólida puede investigar qué preguntas no está resolviendo. ## Cómo repartir el presupuesto Encarga un diagnóstico que conecte consulta, URL, incidencia y entregable. Separa las correcciones del tema, la revisión de contenido y la medición. Evita pagar dos veces por el mismo arreglo porque figure bajo dos siglas. [Google Search Central](https://developers.google.com/search/docs/appearance/ai-features) relaciona las funciones de IA con los fundamentos SEO. Consulta el [método de medición](/preguntas/medir-geo-shopify/) y solicita una [auditoría GEO y SEO para Shopify](/servicios/geo-shopify/). --- ## Shopify vs WooCommerce URL: https://nicolasmateos.com/comparativas/shopify-o-woocommerce/ Updated: 2026-10-21 Facts checked: 2026-10-21 Verdict: Shopify si quieres vender y no administrar: el checkout, el alojamiento, las actualizaciones y el cumplimiento de pagos no son tu problema. WooCommerce si necesitas control total del código o la tienda es una parte pequeña de un sitio de contenidos que ya vive en WordPress, y tienes a alguien que lo mantenga. | Criterion | Shopify | WooCommerce | | --- | --- | --- | | Alojamiento y actualizaciones | Incluidos; no hay servidor que mantener | Tuyos: servidor, versiones, copias de seguridad | | El checkout | De Shopify; se extiende, no se reescribe | Tuyo por completo; también su mantenimiento | | B2B / mayorista | Nativo en Basic, Grow, Advanced y Plus | Con plugins; el modelo lo eliges tú | | Límite de personalización | Alto en el escaparate, acotado en el checkout | Ninguno; puedes cambiar cualquier cosa | | Quién arregla una caída un sábado | Shopify | Tú o tu proveedor | | Coste | Cuota de plan y comisiones previsibles | Alojamiento, plugins y horas de mantenimiento | ## La pregunta correcta no es técnica Las dos plataformas venden online perfectamente. La diferencia que de verdad decide es **de quién es el problema cuando algo se rompe**. En Shopify, el checkout, el alojamiento, la escalabilidad y el cumplimiento normativo de los pagos son de Shopify. En WooCommerce son tuyos, y eso no es malo: es el precio del control total. El error es elegir WooCommerce por el control y luego no tener a nadie que ejerza ese control. ## Donde WooCommerce sigue ganando - **Cuando la tienda es una parte pequeña de un sitio de contenidos.** Un medio, una comunidad o un proyecto con cientos de artículos que ya viven en WordPress y venden algo al margen. - **Cuando necesitas tocar el proceso de compra de una forma que Shopify no permite.** El [checkout de Shopify](/glosario/checkout-extensibility/) se extiende en puntos concretos; no se reordena ni se maqueta libremente. - **Cuando el modelo de datos es raro de verdad.** Productos que no son productos, cálculos que no son precios. ## Donde gana Shopify, y es lo habitual Cuando el negocio es vender. No hay servidor que dimensionar en una campaña, el checkout está probado por millones de pedidos, y lo que antes era un plugin de wholesale hoy es [B2B nativo](/glosario/shopify-b2b/) en casi todos los planes. Y hay una ventaja que no suele estar en las comparativas: en Shopify, el coste de mantenimiento tiende a cero cuando nadie toca la tienda. En WooCommerce, una tienda sin mantener se degrada sola, porque PHP, WordPress y los plugins siguen avanzando. ## Si te estás planteando migrar El riesgo de una migración no está en los datos: está en las URLs. La pérdida de tráfico casi siempre viene de direcciones viejas que acaban en 404 o redirigidas todas a la portada. El inventario de URLs es lo primero, antes de hablar de diseño, y es lo que no se puede recortar. --- ## Shopify Plus vs Shopify Advanced URL: https://nicolasmateos.com/comparativas/shopify-plus-o-advanced/ Updated: 2026-10-23 Facts checked: 2026-10-23 Verdict: Advanced, salvo que marques uno de estos cuatro casos: más de tres tarifas B2B en uso real, precio negociado por cuenta, catálogos distintos por delegación, o Shopify Functions escritas para tu tienda. Si no marcas ninguno, el presupuesto del salto de plan rinde más gastado en el flujo de pedido. | Criterion | Shopify Plus | Shopify Advanced | | --- | --- | --- | | Catálogos B2B activos | Sin límite | 3 en total, contando todos los mercados B2B | | Asignación del catálogo | Directa a una empresa o a una sede concreta | A través de mercados B2B; las empresas lo heredan | | Functions a medida | Sí: puede instalar apps personalizadas con Functions | No: solo Functions que vengan dentro de una app pública | | Checkout | Extensiones y Functions escritas para tu tienda | Editor y apps públicas | | Reglas de cantidad y precios por volumen | Sí | Sí, igual que en Plus | | Número de empresas y sedes | Sin límite de empresas; 10.000 sedes por empresa | Igual que en Plus | ## La fila que decide, y no es la que la gente mira De toda la tabla, la que resuelve el 80 % de los casos es la primera: **tres catálogos activos** en Advanced, sin límite en Plus. Y la forma de usarla no es técnica, es contable. Coge los pedidos del último año y cuenta cuántas tarifas distintas se han usado **de verdad**. No las del PDF comercial. He visto listas de ocho niveles que, mirando los pedidos, eran dos y una excepción. Si el recuento da tres o menos, Advanced llega y la conversación se acaba. ## La segunda fila es la que sorprende La asignación. Sin Plus, un [catálogo](/glosario/catalogo-b2b/) no se enchufa a una empresa: se enchufa a un mercado B2B y las empresas de ese mercado lo heredan. La consecuencia es que **tu segmentación de precios tiene que coincidir con tu segmentación geográfica**. El ejemplo que sale en casi todas las reuniones: si tus tres niveles son "mayorista España", "mayorista Portugal" y "distribuidor", ya los has gastado y no queda hueco para cuentas clave. Media hora de pizarra antes de elegir plan ahorra el rediseño después. ## Lo que no es motivo para pasar a Plus - **"Queremos personalizar el checkout."** Si lo que se quiere son colores, logotipo, tipografía o un aviso, eso se hace con el editor y con apps públicas en Advanced. - **"Vamos a crecer mucho."** Plus se contrata el día que haga falta. El muro aparece en el número de tarifas mucho antes que en el de pedidos. - **"Necesitamos descuentos por volumen."** Están en Advanced, dentro del catálogo. ## Lo que sí lo es Las [Functions](/glosario/shopify-functions/) propias. Solo las tiendas con Plus pueden instalar apps personalizadas que las contengan. Y esa es la diferencia que más presupuestos rompe a mitad de proyecto: con una app pública te adaptas a su modelo de datos, con una Function propia el modelo lo pones tú. Si tu regla de carrito mira el pedido entero (un mínimo distinto por empresa, no mezclar tarifas, un producto que exige otro), no hay forma de hacerlo sin Plus. La excepción es un [pedido mínimo](/blog/pedido-minimo-shopify/) igual para todo el B2B: desde abril de 2026, Checkout Blocks lo valida también en Advanced. --- ## Tema de pago vs Tema a medida URL: https://nicolasmateos.com/comparativas/tema-de-pago-o-a-medida/ Updated: 2026-10-21 Facts checked: 2026-10-21 Verdict: Un tema de pago personalizado, en la gran mayoría de los proyectos, y lo digo aunque facture menos: llegas antes, lo mantiene un proveedor y el presupuesto se va a lo que convierte. Uno a medida se justifica cuando el de pago ya se ha tocado tanto que actualizarlo es imposible, o cuando la marca necesita algo que ningún tema del catálogo hace. | Criterion | Tema de pago | Tema a medida | | --- | --- | --- | | Tiempo hasta publicar | Corto | Largo | | Actualizaciones | Las publica el autor del tema | Tuyas o de quien lo escribió | | Rendimiento de partida | Bueno o regular, según el tema | El que decidas; solo pagas lo que usas | | Secciones para que tu equipo monte páginas | Las del tema, genéricas | Las de tu negocio | | Riesgo de quedar atrapado | Bajo si los cambios van en archivos propios | Depende de quién lo documentó | | Coste inicial | Menor | Mayor | ## Lo que de verdad se compra en un tema No es el diseño. Es lo que tu equipo podrá hacer sin llamar a nadie. Dos temas pueden verse igual el día de la entrega y, seis meses después, en uno se monta una landing en veinte minutos y en el otro cada cambio es un presupuesto. Eso depende de cómo estén partidas las [secciones y los bloques](/glosario/secciones-y-bloques/), y es exactamente la parte que no aparece en la maqueta ni en la demo del tema de pago. ## Por qué recomiendo el de pago casi siempre Porque la mayor parte del valor está en otra parte. Con un tema de pago bien elegido y personalizado llegas antes, las actualizaciones las publica alguien, y el presupuesto que te ahorras se puede gastar en lo que mueve la aguja: el flujo de pedido, la velocidad, el buscador. Lo he hecho así en proyectos grandes: el portal mayorista de Émolo está construido sobre el tema Prestige que la tienda ya usaba, y el trabajo se fue entero a la tabla de pedido y al acceso por empresa. ## Las dos señales de que toca uno a medida **1. El de pago ya no se puede actualizar.** Si los cambios están repartidos dentro de los archivos originales y nadie recuerda cuáles, cada actualización es un proyecto. Llega un punto en que reescribir es más barato que seguir parcheando. **2. La marca necesita algo que ningún tema hace.** Un configurador, una ficha que no es una ficha, un modelo de navegación propio. No "queremos algo único": algo concreto que ningún tema del catálogo resuelve. ## La tercera vía, que es la que uso más Tema de pago como base, y todo lo propio en **archivos y secciones nuevos**, nunca repartido por los originales. Así el tema sigue siendo actualizable, lo tuyo está identificado y la siguiente persona que lo toque sabe dónde mirar. Es la diferencia entre [poder actualizar el tema](/preguntas/puedo-actualizar-un-tema-shopify-personalizado/) y no poder. --- ## ¿Cómo oculto los precios a quien no es mayorista? URL: https://nicolasmateos.com/preguntas/como-oculto-los-precios-a-quien-no-es-mayorista/ Updated: 2026-10-21 Facts checked: 2026-10-21 Answer: Con una condición de Liquid sobre customer.b2b? alrededor de cada precio, badge de stock y botón de compra. La regla es que si el visitante no es un cliente B2B con sesión abierta, el precio no debe llegar al HTML: ocultarlo con CSS o con JavaScript no cuenta, porque el precio sigue estando en el código fuente. ## La condición, y dónde ponerla ```liquid {% if customer.b2b? %} {{ product.selected_or_first_available_variant.price | money }} {% else %} Accede con tu cuenta para ver precios {% endif %} ``` Lo importante es que esa condición no va solo en la ficha de producto. Tiene que estar en **todos** los sitios donde un precio sale al HTML, y en un tema de Shopify son más de los que parece: la tarjeta de colección, los resultados del buscador, los productos relacionados, el carrito, el borrador de carrito que algunos temas pintan en JSON, los datos estructurados de producto y el feed de Google Shopping si está activo. El fallo que me encuentro más veces en auditorías es justo ese: la ficha está bien protegida y el listado de colección sigue mostrando el precio mayorista a cualquiera. ## Por qué el CSS no vale Si el precio se imprime y se tapa con `display: none`, está en el código fuente. Lo ve cualquiera con "ver código fuente", lo ve cualquier extensión y lo puede indexar un buscador. En un portal mayorista eso significa que tu competencia puede sacar tu tarifa completa en diez minutos sin tener cuenta. Lo mismo con las soluciones por JavaScript que borran el precio al cargar: entre que el HTML llega y el script corre, el precio está ahí, y en el código fuente está siempre. ## El caso de la misma empresa con varias sedes Si el comprador puede comprar para varias [sedes](/glosario/sede-de-empresa/), no basta con saber que es B2B: hay que saber **desde dónde** compra, porque la tarifa puede cambiar. `customer.current_location` lo dice, y conviene que el selector de sede esté visible en la cabecera: cambiar de sede puede recalcular todo el carrito, y el comprador tiene que enterarse. ## Un extra que piden los compradores Un botón para ocultar sus propios precios en pantalla. Parece raro hasta que te lo cuenta un comprador que está en el almacén con el móvil en la mano y un cliente final al lado. Se resuelve con una preferencia en `localStorage` aplicada en el `head`, antes de que se pinte la página. --- ## ¿Cuánto cuesta un portal B2B en Shopify? URL: https://nicolasmateos.com/preguntas/cuanto-cuesta-un-portal-b2b-en-shopify/ Updated: 2026-11-05 Facts checked: 2026-11-05 Answer: El coste de un portal B2B en Shopify depende del plan, las tarifas por cliente, el flujo de pedido y la integración con el ERP. Para comparar presupuestos, separa el desarrollo inicial de las cuotas recurrentes y exige una lista de entregables, exclusiones y pruebas de aceptación. ## Las cuatro cosas que mueven el precio **1. El plan, que es una cuenta aparte.** Basic, Grow y Advanced permiten hasta tres asignaciones de catálogo activas en mercados B2B activos. Un catálogo asignado a dos mercados cuenta dos veces; contar solo las tarifas no basta. Plus elimina ese límite y permite asignar catálogos directamente a sucursales de empresa, según la [documentación de catálogos B2B de Shopify](https://help.shopify.com/es/manual/b2b/catalogs), comprobada en noviembre de 2026. **2. Cuántas tarifas y cómo se asignan.** Preparar [catálogos](/glosario/catalogo-b2b/) con datos limpios es distinto de depurar referencias, importar precios y resolver excepciones por cliente. Si hacen falta [Functions](/glosario/shopify-functions/) en una app personalizada, Shopify exige Plus; las apps públicas con Functions pueden usarse en cualquier plan, con restricciones según la función. Fuente: [disponibilidad de Shopify Functions](https://shopify.dev/docs/apps/build/functions), comprobada en noviembre de 2026. **3. El flujo de pedido.** Aquí está la mayor parte del trabajo real y es lo que casi nunca está en el presupuesto inicial: [tabla de pedido](/glosario/pedido-rapido/) por variante con stock, búsqueda por referencia, reglas de cantidad en el propio campo, repetir el último pedido, selector de sede. Cada una de esas se puede quitar, y quitarlas cambia el precio más que el plan. **4. Si hay que hablar con el ERP.** Un portal que lee stock y precios del ERP es otro proyecto encima del portal. Si en la primera llamada nadie pregunta por el ERP, falta la mitad del alcance. ## Tres alcances que no cuestan lo mismo Son ejemplos para comparar propuestas, no paquetes con precio o plazo cerrado: | Alcance | Entregables que habría que presupuestar | Lo que queda fuera salvo acuerdo | | --- | --- | --- | | Adaptar el tema actual | Acceso mayorista, presentación de precios y prueba de compra con clientes de ejemplo | Diseño nuevo, sincronización ERP y tabla de pedido a medida | | Portal con pedido rápido | Lo anterior, más tabla por variantes, búsqueda por referencia y validación de cantidades | Integración ERP, migración histórica y reglas no descritas | | Portal conectado al ERP | Flujo de pedido acordado, mapeo de datos, sincronización definida y tratamiento de errores | Conectores de terceros, licencias y mantenimiento continuo si no se incluyen | Para aceptar el trabajo, acuerda un pedido de prueba: qué cliente entra, qué precio ve, qué cantidad puede comprar y dónde debe aparecer el pedido. En una integración, añade cómo se detecta y recupera un fallo. ## Desarrollo inicial y gastos recurrentes El presupuesto debe separar implementación y pruebas de la suscripción de Shopify, apps, conectores y soporte. No publico una horquilla propia porque todavía hace falta definir el alcance; tampoco conviene comparar una propuesta que incluye integración con otra que solo adapta el tema. ## Cómo comparar dos presupuestos Comprueba que ambos describen el mismo plan, mercados, tarifas, pantallas, integraciones y pruebas. Pide también entregables de código y documentación, soporte incluido y cómo se presupuestan los cambios. Para valorar tu [portal Shopify B2B](/shopify-b2b/), prepara el plan actual, los mercados, un ejemplo anonimizado de tarifa y pedido, el ERP y las funciones imprescindibles. [Cuéntame ese alcance](/contacto/) para distinguir configuración, desarrollo e integración antes de presupuestar. --- ## ¿Cómo se miden los resultados GEO de una tienda Shopify? URL: https://nicolasmateos.com/preguntas/medir-geo-shopify/ Updated: 2026-11-05 Answer: Los resultados GEO de Shopify se miden comparando consultas de compra acordadas antes y después de los cambios, guardando respuestas y URLs citadas por motor e idioma. Las menciones, las citas con enlace, las visitas y los contactos se registran por separado; ninguna métrica aislada demuestra ventas causadas por GEO. ## Qué registrar en cada prueba Guarda fecha, consulta literal, idioma, motor, modelo visible, contexto geográfico y respuesta completa. Anota la marca mencionada, las URLs citadas y las fuentes competidoras. Usa condiciones comparables y documenta cualquier cambio de contexto. | Indicador | Qué acredita | Qué no acredita | | --- | --- | --- | | Mención | La marca aparece en la muestra | Una recomendación estable | | Cita con enlace | Una URL se usa como fuente | Una visita o una venta | | Visita referida | La analítica registra una visita desde el asistente | Toda la exposición sin clic | | Contacto con origen declarado | La persona indica cómo llegó | Causalidad exclusiva del cambio | ## Cómo interpretar el antes y el después Repite el conjunto de consultas y conserva las respuestas, incluidas las que no mencionan la tienda. Cambiar las preguntas después de ver el resultado impide una comparación honesta. Una búsqueda web convencional no sustituye una prueba en el asistente. Los motores y sus fuentes cambian. Informa del tamaño de la muestra, del periodo observado y de los datos que faltan; no conviertas una captura favorable en una tasa universal de visibilidad. ## Qué pedir a un proveedor Pide el registro de pruebas, las URLs modificadas, la fecha del cambio y los criterios de aceptación. Si no hay acceso a analítica o contactos, el informe debe indicar que solo mide la muestra de respuestas. Antes de contratar, revisa las [diferencias entre SEO y GEO](/comparativas/seo-vs-geo-shopify/) y los entregables de la [consultoría GEO para Shopify](/servicios/geo-shopify/). --- ## ¿Necesito un tema nuevo para vender B2B en Shopify? URL: https://nicolasmateos.com/preguntas/necesito-un-tema-nuevo-para-vender-b2b/ Updated: 2026-10-21 Facts checked: 2026-10-21 Answer: No. Un portal mayorista se puede montar sobre el tema que ya tienes, incluido uno de pago: el precio del catálogo llega resuelto al tema y el acceso se decide con una condición de Liquid sobre customer.b2b?. Lo que suele hacer falta es trabajo de front-end sobre ese tema, no empezar de cero. ## Por qué no hace falta empezar de cero La parte de B2B que parece más difícil —que cada empresa vea su precio— no la hace el tema. La hace la plataforma: el catálogo asignado a la empresa resuelve el precio antes de que el tema lo pida. Al tema solo le queda una decisión, que es quién ve precios y quién no. Eso significa que un tema de pago bien hecho ya sirve de base. El portal mayorista de [Émolo](/proyectos/#emolo-b2b), una marca de joyería de Murcia, está construido sobre el tema Prestige que la tienda ya usaba. ## Lo que sí hay que añadir Aquí está el presupuesto real de un portal B2B, y no tiene nada que ver con el diseño: - **Decidir el acceso** con una condición de Liquid, en todos los sitios donde sale un precio y no solo en la ficha. - **[Tabla de pedido](/glosario/pedido-rapido/)** por variante, con stock y cantidad por fila, que es como pide un comprador mayorista. - **Búsqueda por referencia**, porque un profesional busca por SKU y no por nombre de producto. - **Las reglas de cantidad del catálogo aplicadas al propio campo**, con `min` y `step`, para avisar antes de escribir y no al pagar. - **Repetir el último pedido**, que es la función más usada de cualquier portal. ## Cuándo sí toca tema nuevo Por los mismos motivos que en B2C, no por el B2B: cuando el tema de pago se ha tocado tanto que actualizarlo es imposible, o cuando la marca necesita algo que ningún tema del catálogo hace. Si no estás en ninguno de esos dos casos, el presupuesto rinde mucho más gastado en el flujo de pedido que en rehacer el front-end entero. --- ## ¿Necesito una app para vender B2B en Shopify? URL: https://nicolasmateos.com/preguntas/necesito-una-app-para-vender-b2b-en-shopify/ Updated: 2026-10-23 Facts checked: 2026-10-23 Answer: No. Las funciones B2B son nativas en los planes Basic, Grow, Advanced y Shopify Plus: empresas, sedes, catálogos con sus precios, reglas de cantidad y precios por volumen vienen de serie. Una app solo hace falta para lo que el modelo nativo no cubre, y lo primero es saber qué parte es. ## Lo que ya viene de serie Durante años, vender al por mayor en Shopify quería decir instalar una app de wholesale o montar un apaño con etiquetas de cliente y descuentos automáticos. Eso cambió: hoy la documentación de Shopify lista B2B en Basic, Grow, Advanced y Plus, y lo excluye solo de Starter y Retail. Nativo significa que el precio mayorista **llega resuelto al tema**: el front-end pide el precio de la variante y recibe el que corresponde a la empresa del comprador. Ninguna app calculando nada en el carrito, ningún descuento que se aplica al final y que el comprador no entiende. ## Lo que la gente confunde con "necesito una app" Casi todo lo que se pide a una app de wholesale no es precio: es **flujo de pedido**. Tabla de tallas con stock y cantidad por fila, búsqueda por referencia, [pedido rápido](/glosario/pedido-rapido/), repetir el último pedido, ocultar precios en pantalla. Nada de eso lo resuelve una app de precios: es trabajo de front-end sobre el tema, y funciona en cualquier plan con B2B. Esta es la parte donde más presupuesto se tira: se paga una app mensual que resuelve el 20 % del problema y el 80 % sigue sin estar. ## Cuándo sí hace falta algo más Tres casos concretos: 1. **Descuentos por cuenta sin Shopify Plus.** Los [catálogos](/glosario/catalogo-b2b/) se asignan por mercado, así que para una lista por cuenta hace falta Plus o una app pública. 2. **Reglas de carrito que miran el pedido entero.** Un mínimo por importe distinto para cada empresa, no mezclar tarifas. Eso es una Function, y una Function a medida necesita Plus. Un [pedido mínimo](/blog/pedido-minimo-shopify/) único para todo el B2B ya no lo necesita: desde abril de 2026 se pone con Checkout Blocks en cualquier plan. 3. **Un dato que vive en tu ERP.** Límite de crédito, descuento negociado fuera de Shopify. Eso es una integración, no una app de catálogo. Si no estás en ninguno de los tres, la respuesta honesta es que no necesitas una app: necesitas que alguien te monte bien el flujo de pedido. --- ## ¿Puedo tener un precio distinto para cada cliente en Shopify? URL: https://nicolasmateos.com/preguntas/precio-distinto-por-cliente-en-shopify/ Updated: 2026-10-21 Facts checked: 2026-10-21 Answer: Por niveles de cliente, sí, y sin Shopify Plus: hasta tres catálogos B2B activos con su propia tarifa. Un precio negociado cuenta por cuenta, de forma nativa, necesita Shopify Plus, porque es el único plan que permite asignar un catálogo directamente a una empresa o a una de sus sedes. ## La pregunta antes de la pregunta Antes de decidir si necesitas precio por cuenta, cuenta tus tarifas **reales**, con los pedidos del último año delante y no con el PDF comercial. He visto listas de ocho tarifas que al mirar los pedidos eran dos y una excepción. Si al contarlas salen tres o menos, cabes en un plan sin Plus y la conversación se acaba aquí. ## Lo que da un catálogo sin Plus Tres [catálogos](/glosario/catalogo-b2b/) activos, contando todos los mercados B2B juntos. Dentro de cada uno: - Precio fijo por variante o un porcentaje sobre toda la tarifa. - [Reglas de cantidad](/glosario/reglas-de-cantidad/): mínimos, máximos y múltiplos. - [Precios por volumen](/glosario/precios-por-volumen/): el precio baja al pasar de X unidades. Esa última es la que resuelve más casos de los que parece. Cuando alguien pide un cuarto catálogo porque "este cliente compra mucho más", casi siempre está describiendo una cantidad distinta, no un precio distinto. Y un tramo de volumen, además, le enseña al comprador el incentivo de subir de escalón. ## El muro, y cómo se nota Sin Plus, un catálogo no se asigna a una empresa: se asigna a un mercado B2B y las empresas de ese mercado lo heredan. Eso tiene una consecuencia que conviene dibujar en una pizarra antes de elegir plan: tu segmentación de precios tiene que coincidir con tu segmentación geográfica. Si tus niveles son "mayorista España", "mayorista Portugal" y "distribuidor", ya has gastado los tres y no queda hueco para cuentas clave. ## Las alternativas si no quieres Plus Por orden de la deuda técnica que dejan: ordenar los tres catálogos como tres niveles limpios y mover cada empresa al mercado que le toca; usar tramos de volumen para las diferencias que son de cantidad; y, si de verdad hacen falta descuentos por cuenta, una app pública del App Store. Lo que **no** es una opción sin Plus es una [Function](/glosario/shopify-functions/) escrita para tu tienda con tus reglas de descuento. --- ## ¿Puedo actualizar un tema de Shopify que está personalizado? URL: https://nicolasmateos.com/preguntas/puedo-actualizar-un-tema-shopify-personalizado/ Updated: 2026-10-21 Facts checked: 2026-10-21 Answer: Depende de dónde estén los cambios. Si están en secciones nuevas y en archivos propios, la actualización es viable y hay que revisar solo los puntos de contacto. Si están repartidos dentro de los archivos originales del tema, actualizar significa rehacer los cambios uno a uno, y eso ya es un proyecto, no una actualización. ## Por qué algunos temas se pueden actualizar y otros no Shopify no aplica actualizaciones sobre un tema que has editado: lo que se hace es instalar la versión nueva y volver a llevar los cambios. Así que la pregunta real no es técnica, es de arqueología: **dónde están tus cambios**. Dos tiendas con la misma cantidad de personalización pueden estar en situaciones opuestas. En una, todo lo propio vive en tres secciones nuevas, un `custom.css` y un `custom.js`; actualizar es instalar, mover esos archivos y revisar cuatro puntos. En la otra, hay condiciones sueltas dentro de diez archivos del tema original y nadie recuerda cuáles; ahí actualizar es rehacerlo. ## Cómo saber en cuál estás Sin mirar el código, tres indicadores bastante fiables: - **¿Hay un archivo de estilos propio** o el CSS se tocó directamente en el del tema? - **¿Las funcionalidades nuevas son secciones** que se añaden y quitan desde el editor, o están incrustadas en las plantillas? - **¿Está en control de versiones?** Si existe el repositorio, se puede ver exactamente qué se tocó. Si el único sitio donde vive el tema es el admin, la respuesta es que nadie lo sabe. ## Cómo lo dejo yo para que esto no pase Cuando hago una personalización, todo lo propio va en archivos nuevos y en [secciones](/glosario/secciones-y-bloques/) nuevas, y los puntos donde hay que tocar un archivo original se quedan escritos. No es por elegancia: es para que la siguiente actualización cueste una tarde en lugar de un presupuesto. Y donde el tema original hay que tocarlo sí o sí, el cambio se hace lo más pequeño posible: una línea que llama a algo mío, en lugar de veinte líneas propias dentro de su archivo. ## Si ya estás en el caso malo No hace falta rehacer el tema entero de golpe. Lo que funciona es sacar los cambios a archivos propios poco a poco, empezando por los que más se tocan. Al cabo de unos meses el tema vuelve a ser actualizable sin haber parado nunca la tienda. --- ## ¿Puedo personalizar el checkout de Shopify? URL: https://nicolasmateos.com/preguntas/puedo-personalizar-el-checkout-de-shopify/ Updated: 2026-10-21 Facts checked: 2026-10-21 Answer: Sí, pero dentro de unos límites concretos. Puedes cambiar logotipo, colores, tipografías y el orden de los bloques desde el editor, añadir contenido y campos con extensiones en los puntos permitidos, y cambiar descuentos, envíos y pagos con Functions. Lo que no puedes es reordenar libremente los pasos del checkout ni maquetarlo como una página normal. ## Lo que se puede, por orden de dificultad **Sin código y sin Plus.** Logotipo, colores, tipografías y orden de los bloques desde el editor de checkout. Es más de lo que la gente supone, y cubre lo que pide la mayoría de las marcas cuando dicen "queremos que el checkout sea nuestro". **Con una app pública.** Avisos, upsells, campos extra, seguimiento. Hay apps del App Store para casi todo esto y funcionan en planes sin Plus. **Con desarrollo a medida, y aquí entra Plus.** Una extensión de interfaz propia o una [Function](/glosario/shopify-functions/) escritas para tu tienda van dentro de una app personalizada, y eso solo se puede instalar con [Shopify Plus](/glosario/shopify-plus/). ## Lo que no se puede, y conviene decirlo pronto - Reordenar o fusionar los pasos del checkout. - Inyectar JavaScript arbitrario en la página de pago. - Maquetar el checkout libremente, como si fuera una plantilla del tema. - Editar `checkout.liquid`. Eso dejó de ser el camino; lo que había ahí se rehace con extensiones y Functions. Si un presupuesto o una maqueta dan por hecho alguna de estas cuatro cosas, el presupuesto está mal. Es mejor saberlo antes de enseñárselo a dirección que después. ## Lo que de verdad mueve la conversión en B2B En un portal mayorista, los dos cambios que más se notan no son visuales. El primero es decir el **plazo de pago** donde el comprador lo ve: si paga a 60 días, decirlo en el carrito y en el checkout baja el abandono más que cualquier sello de confianza. El segundo es permitir meter el **número de pedido de compra** y que esa referencia llegue al pedido, a la factura y al ERP. Las dos cosas caben en una extensión y las dos son de las que el comprador agradece en voz alta. --- ## ¿Puedo usar Shopify Functions sin Shopify Plus? URL: https://nicolasmateos.com/preguntas/puedo-usar-shopify-functions-sin-plus/ Updated: 2026-10-23 Facts checked: 2026-10-23 Answer: Solo las que vengan dentro de una app pública del App Store. Una Function escrita a medida para tu tienda va dentro de una app personalizada, y únicamente las tiendas con Shopify Plus pueden instalar apps personalizadas que contengan Shopify Functions. ## La diferencia que importa al presupuestar Es un detalle que casi nadie cuenta y que decide proyectos enteros: con una app pública te adaptas a **su** modelo de datos, con una [Function](/glosario/shopify-functions/) propia el modelo lo pones tú. Si tu regla es "un 10 % al pasar de 500 €", hay apps del App Store que lo hacen y además las mantiene otro. Si tu regla es "un 10 % al pasar de 500 €, salvo en la familia de producto X, y solo para las sedes de España, y sin acumular con el precio de volumen", ninguna app pública la va a modelar igual, y ahí Plus deja de ser una preferencia. ## Lo que sí se puede hacer sin Plus Bastante más de lo que parece, y conviene agotarlo antes de cambiar de plan: - **[Reglas de cantidad](/glosario/reglas-de-cantidad/)** en el catálogo: mínimo, máximo e incremento por variante. Es lo que obliga a pedir cajas completas, sin una línea de código. - **[Precios por volumen](/glosario/precios-por-volumen/)**: saltos de precio por cantidad dentro del catálogo. - **Descuentos automáticos** nativos para las promociones estándar. - **Apps públicas** que lleven Functions dentro, para descuentos que no caben en lo anterior. En los proyectos B2B que me llegan pidiendo una Function, un buen número se resuelve con las dos primeras. ## Cuándo no hay alternativa Cuando la regla mira el **carrito entero** y cambia según quién compra o qué lleva. Las reglas de cantidad son por variante: no saben si estás mezclando dos tarifas, ni si un producto exige otro, ni si esta empresa en concreto llega a su mínimo. Un [pedido mínimo](/blog/pedido-minimo-shopify/) igual para todo el B2B sí se resuelve sin Plus desde abril de 2026, con Checkout Blocks. Para el resto hace falta una validación propia, es decir una Function, y por tanto Plus. Si quieres ver cómo es una de esas validaciones por dentro antes de decidir, hay una publicada con sus pruebas en [shopify-checkout-lab](https://github.com/NicolasShopiDev/shopify-checkout-lab) y se puede tocar en [la portada](/). --- ## ¿Qué le pregunto a un desarrollador de Shopify antes de contratarlo? URL: https://nicolasmateos.com/preguntas/que-preguntar-a-un-desarrollador-shopify/ Updated: 2026-10-21 Facts checked: 2026-10-21 Answer: Seis: qué tiendas en vivo puedo visitar y qué hiciste exactamente en ellas; qué parte de esto se resuelve sin apps; en qué plan me deja esto; cómo me entregas el código y dónde vive; qué pasa cuando algo se rompe en tres meses; y qué de lo que te he pedido me recomiendas no hacer. ## Las seis preguntas, y qué estás escuchando en cada una **1. ¿Qué tiendas en vivo puedo visitar, y qué hiciste exactamente en ellas?** No capturas de pantalla: URLs. Y la segunda mitad de la pregunta importa más que la primera, porque en una tienda han trabajado varias personas. Una respuesta buena suena a "esta tabla de pedido y el selector de sede"; una respuesta mala suena a "llevamos esta cuenta". **2. ¿Qué parte de esto se resuelve sin apps y sin código?** Aquí se ve si conoce la plataforma o solo su propio oficio. Mucho de lo que se pide a desarrollo en B2B es configuración: [reglas de cantidad](/glosario/reglas-de-cantidad/), [precios por volumen](/glosario/precios-por-volumen/), catálogos. Quien te cobra por programar lo que ya viene hecho, o no lo sabe o prefiere no saberlo. **3. ¿En qué plan de Shopify me deja esto?** Si lo que pides necesita [Plus](/glosario/shopify-plus/) y nadie lo menciona, te vas a enterar al final. Pasa sobre todo con las Functions a medida y con el precio por cuenta. **4. ¿Cómo me entregas el código y dónde vive?** La respuesta correcta incluye un repositorio al que tú tienes acceso. Si el único sitio donde existe el tema es el admin de tu tienda, tu proveedor es el backup. **5. ¿Qué pasa cuando algo se rompe en tres meses?** No busques una garantía eterna: busca que la pregunta no le sorprenda. Quien ya ha mantenido tiendas te habla de actualizaciones de tema, de versiones de API y de qué parte seguirá siendo suya. **6. ¿Qué de lo que te he pedido me recomiendas no hacer?** La más útil de las seis. Quien dice que todo es buena idea te va a decir que sí a un cuarto catálogo que no necesitas y a una app a medida que podría ser un metacampo. ## Lo que yo contestaría A la primera: [veinte proyectos con su URL](/proyectos/), y en cada ficha está escrito qué hice yo. A la cuarta: un repositorio tuyo desde el primer día. Y sobre la sexta, la respuesta más frecuente que doy en una primera llamada es que el flujo de pedido rinde más que el cambio de plan. --- ## AEO (Answer Engine Optimization) URL: https://nicolasmateos.com/glosario/aeo/ Also called: optimización para motores de respuesta Updated: 2026-11-05 Definition: AEO es la optimización del contenido para responder preguntas concretas de forma directa y comprensible fuera de contexto. En Shopify ayuda a explicar compatibilidad, uso y condiciones de compra; una respuesta bien redactada no garantiza su selección por un buscador o asistente. ## Cómo escribir una respuesta útil Responde en las primeras frases, nombra el producto o la categoría y explica la condición que limita la respuesta. Después añade evidencia, excepciones y el siguiente paso. Una pregunta sobre compatibilidad necesita modelos y requisitos, no una respuesta genérica sobre calidad. Por ejemplo, «¿sirve para exterior?» debe responder con el uso autorizado y sus condiciones cuando el fabricante facilite esos datos. Si el dato falta, se comprueba antes de publicarlo. La respuesta debe mantenerse coherente entre idiomas. ## FAQ y marcado no sustituyen la información Las FAQ sirven cuando resuelven dudas distintas que el contenido principal deja abiertas. Repetir palabras clave o añadir respuestas ocultas solo al JSON-LD no mejora la explicación para quien compra. AEO contribuye al trabajo de [GEO](/glosario/geo/). Consulta [cómo medimos la visibilidad](/preguntas/medir-geo-shopify/) y el alcance de la [implementación GEO en Shopify](/servicios/geo-shopify/). --- ## API Ajax de carrito URL: https://nicolasmateos.com/glosario/api-ajax-de-carrito/ Also called: Cart API, cart.js, cart/update.js, Ajax Cart API Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: La API Ajax de carrito es el conjunto de rutas (/cart.js, /cart/add.js, /cart/update.js, /cart/change.js) con las que el tema lee y modifica el carrito sin recargar la página. Acepta varias líneas en una sola llamada y puede devolver ya renderizado el HTML de las secciones que hay que actualizar. Es la API con la que se juega todo el flujo de pedido de un portal B2B, y la que más se usa mal. ## update.js frente a add.js `add.js` añade. `update.js` fija cantidades absolutas. Para un bloc de pedido mayorista, `update.js` es la correcta, y no por gusto: con cantidades absolutas, el primer pedido, la ampliación y la corrección son la misma petición. Con `add.js` hay que saber qué había antes, y ahí empiezan los descuadres. ```js await fetch('/cart/update.js', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ updates: { 4631: 12, 4632: 6 }, sections: 'cart-drawer,cart-icon-bubble' }), }); ``` ## El parámetro `sections` Es el que ahorra la mitad del JavaScript. En lugar de recibir el carrito en JSON y volver a dibujarlo a mano, se piden las secciones del tema y llega su HTML ya renderizado por Shopify, con los precios formateados y los textos traducidos. Un `innerHTML` y ya está. ## Dos detalles que dan incidencias - **El orden de las respuestas.** Varias llamadas en paralelo pueden llegar desordenadas: la última respuesta no es necesariamente el último estado. Una llamada por acción, con las líneas juntas. - **La bfcache.** Si el usuario vuelve con el botón atrás, el navegador puede restaurar la página con el carrito viejo. Releer el carrito en el evento `pageshow` lo arregla. Documentación: [Ajax Cart API](https://shopify.dev/docs/api/ajax/reference/cart). --- ## API GraphQL de Admin URL: https://nicolasmateos.com/glosario/api-graphql-de-admin/ Also called: Admin API, GraphQL Admin API, API de administración Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: La API GraphQL de Admin es la interfaz con la que una app o un sistema externo lee y escribe los datos de una tienda Shopify: productos, variantes, stock, pedidos, clientes, empresas B2B y metacampos. Es la vía por la que entran las integraciones con un ERP y las automatizaciones. Es la API que importa cuando el proyecto deja de ser "una tienda" y pasa a ser "una tienda conectada a lo que la empresa ya tenía". Casi siempre aparece por el mismo sitio: el stock y los precios viven en el ERP, y alguien tiene que llevarlos a Shopify sin tocar nada a mano. ## Lo que hay que planificar antes de escribir código Tres cosas, y ninguna es GraphQL: - **El coste de las consultas.** La API tiene un presupuesto por consulta y por ventana de tiempo. Una sincronización que recorre 20.000 variantes de una en una se come el presupuesto; la misma hecha por lotes, no. - **Quién gana cuando los dos lados cambian.** Si el ERP y Shopify pueden modificar el stock, hay que decidir el sentido y escribirlo. Casi todas las integraciones que he visto romperse lo tenían sin decidir. - **Qué hacer con lo que falla.** Una línea rechazada no puede quedarse en silencio. Hace falta reintento y un sitio donde mirar. ## Las operaciones masivas Para importar o exportar mucho, la API tiene operaciones masivas: se lanza la consulta, se espera y se recoge un archivo con el resultado. Es más lento de programar y es la diferencia entre una sincronización nocturna que acaba y una que se queda a medias. ## Lo que no hace No sirve para leer el carrito de un comprador en la tienda: eso es la [Cart API](/glosario/api-ajax-de-carrito/). Y no se puede llamar desde dentro de una Shopify Function. Documentación: [Admin API GraphQL](https://shopify.dev/docs/api/admin-graphql). --- ## Cart Transform URL: https://nicolasmateos.com/glosario/cart-transform/ Also called: Cart Transform API, bundles en Shopify, expand y merge Updated: 2026-10-22 Definition: Cart Transform es la API de Shopify Functions que modifica las líneas del carrito antes del checkout: puede expandir una línea en varias, fusionar varias en una sola o actualizar el precio y el título de una línea. Es la base técnica de los packs y de los lotes de producto. Es la Function que menos se conoce y la que resuelve un problema muy concreto: vender algo que el comprador ve como **un** producto y el almacén necesita como **varios**, o al revés. ## Las tres operaciones - **Expandir.** Una línea se convierte en varias. El comprador añade "pack de inicio" y el carrito, el pedido y el almacén ven las tres referencias que lo componen, cada una descontando su propio stock. - **Fusionar.** Varias líneas se muestran como una. El comprador ve "conjunto completo" en lugar de cuatro líneas sueltas. - **Actualizar.** Cambiar el precio o el título de una línea. ## Por qué importa en B2B El caso que más me he encontrado es el de las cajas. El catálogo tiene la unidad, pero el almacén solo mueve cajas de seis. Hay dos formas de resolverlo y conviene elegir a conciencia: 1. **[Reglas de cantidad](/glosario/reglas-de-cantidad/)** con incremento de seis. Sin código, funciona en cualquier plan con B2B, y el comprador pide en unidades de seis en seis. 2. **Cart Transform** para vender la caja como producto y expandirla en seis unidades de cara al stock y al albarán. La primera es casi siempre la correcta: es gratis y no añade nada que mantener. La segunda solo gana cuando el almacén necesita ver las unidades por separado de verdad. ## El requisito de plan Cart Transform es una [Shopify Function](/glosario/shopify-functions/), así que escribirla a medida para tu tienda exige Shopify Plus. Y como toda Function, solo ve lo que su [input query](/glosario/input-query/) le pasa. Documentación: [Cart Transform API](https://shopify.dev/docs/api/functions/latest/cart-transform). --- ## Catálogo B2B URL: https://nicolasmateos.com/glosario/catalogo-b2b/ Also called: catalog, catálogo mayorista, tarifa B2B Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Un catálogo B2B es el conjunto de productos con sus precios, reglas de cantidad y precios por volumen que se asigna a unas empresas concretas. Es el equivalente a una tarifa de mayorista, y es el objeto cuyo límite decide si un proyecto B2B cabe en tu plan: tres activos sin Plus, sin límite con Plus. El catálogo es la pieza que hay que contar antes de elegir plan. Todo lo demás en B2B tiene topes que no se tocan en la práctica; este no. ## El límite que decide el proyecto En **Basic, Grow y Advanced** puedes tener **3 catálogos activos en total**, contando todos tus mercados B2B juntos, no tres por mercado. En **Shopify Plus** no hay límite, y además el catálogo se puede asignar directamente a una empresa o a una [sede](/glosario/sede-de-empresa/). Tres catálogos dan para una estructura por niveles —mayorista, distribuidor, cuentas clave— que es como trabaja la mayoría de las marcas. Lo que no dan es para precio negociado cuenta por cuenta. ## La asignación cambia cómo montas el proyecto Este punto arrastra más decisiones que el propio número. Sin Plus un catálogo no se enchufa a una empresa: se enchufa a un mercado B2B, y las empresas de ese mercado lo heredan. Consecuencia: tu segmentación de precios tiene que coincidir con tu segmentación geográfica. Si tus tres niveles son "mayorista España", "mayorista Portugal" y "distribuidor", ya has gastado los tres. Cuando varios catálogos ponen precio al mismo producto, **gana el más bajo**. Es útil saberlo antes de solapar catálogos para resolver una excepción: el solape no suma, elige. ## Qué cabe dentro de un catálogo Más de lo que parece. Precio fijo por variante o un porcentaje sobre toda la tarifa, [reglas de cantidad](/glosario/reglas-de-cantidad/) y [precios por volumen](/glosario/precios-por-volumen/). Antes de pedir un cuarto catálogo conviene mirar si la diferencia entre dos clientes es de precio o de cantidad: si es de cantidad, los saltos por volumen la resuelven dentro de uno. Los topes están en la [documentación de catálogos](https://help.shopify.com/en/manual/b2b/catalogs). --- ## Checkout Extensibility URL: https://nicolasmateos.com/glosario/checkout-extensibility/ Also called: extensibilidad del checkout, checkout extensions, UI extensions Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Checkout Extensibility es el modelo con el que hoy se personaliza el checkout de Shopify: extensiones de interfaz que se colocan en puntos permitidos, Functions que cambian descuentos, envíos o pagos, y configuración en el editor. Sustituye a editar checkout.liquid, que ya no es una opción. El cambio de mentalidad es este: antes el checkout era una plantilla que se editaba, y ahora es una aplicación en la que se enchufan piezas en sitios concretos. Se pierde libertad y se gana que una actualización de Shopify no rompe la tienda. ## Las tres piezas - **Extensiones de interfaz**, que añaden contenido en puntos permitidos del checkout y de la página de gracias: un aviso, un campo, un bloque de información de entrega. - **[Functions](/glosario/shopify-functions/)**, que cambian el comportamiento: descuentos, validaciones que bloquean el pago, orden y disponibilidad de métodos de envío y de pago. - **El editor**, para lo visual: logotipo, colores, tipografías y orden de los bloques, sin código. ## Lo que se puede y lo que no Se puede: avisar de un mínimo, mostrar el plazo de pago de una empresa B2B, pedir un número de pedido de compra, ocultar un método de envío, bloquear el checkout con un mensaje concreto. No se puede: reordenar libremente los pasos del checkout, inyectar JavaScript arbitrario en la página, o maquetar el checkout como una página normal. Si un presupuesto da por hecho eso, el presupuesto está mal. ## El límite de plan Lo visual y las apps públicas funcionan en planes sin Plus. Una extensión o una Function **escritas a medida para la tienda** necesitan [Shopify Plus](/glosario/shopify-plus/), porque van dentro de una app personalizada. Documentación: [Checkout Extensibility](https://shopify.dev/docs/apps/build/checkout). --- ## checkout.liquid URL: https://nicolasmateos.com/glosario/checkout-liquid/ Also called: checkout liquid, plantilla de checkout, checkout antiguo Updated: 2026-10-22 Definition: checkout.liquid era la plantilla con la que las tiendas Shopify Plus podían editar el checkout como cualquier otra página del tema. Shopify la ha retirado en favor de Checkout Extensibility, donde el checkout ya no se edita: se extiende con extensiones y Functions en puntos permitidos. Si alguien de tu equipo sigue hablando de "tocar el checkout.liquid", lo que describe es un modelo que ya no existe. Y la migración no es copiar aquel código a otro sitio. ## Por qué Shopify lo cerró Una plantilla editable significaba que cada tienda Plus tenía un checkout distinto, y que Shopify no podía mejorar el suyo sin arriesgarse a romper miles de personalizaciones. El modelo nuevo invierte el trato: tú pierdes libertad, y a cambio una actualización de Shopify deja de ser un riesgo para tu tienda. ## Qué hay que hacer con lo que había dentro El orden que menos trabajo da: 1. **Inventariar.** Qué hacía exactamente, no qué dice la documentación interna que hacía. 2. **Descartar.** Esta es la parte que sorprende: en los proyectos que he visto, cerca de la mitad de las personalizaciones eran apaños que la plataforma ya cubre de serie. Avisos de envío, campos extra, reordenar métodos de pago. 3. **Reconstruir lo que queda.** Lo visual, desde el editor. El contenido y los campos, con extensiones. El comportamiento, con [Functions](/glosario/shopify-functions/). ## Lo que no vuelve Reordenar los pasos del checkout, maquetarlo libremente o meter JavaScript arbitrario. Si la migración se presupuestó asumiendo que todo aquello se puede replicar, el presupuesto está mal, y es mejor saberlo antes de empezar que a mitad. Lo mismo le pasó a [Shopify Scripts](/glosario/shopify-scripts/): se cerró y lo que quedaba vivo se reescribió como Function. Shopify explica la ruta de actualización en la [documentación de checkout](https://help.shopify.com/en/manual/checkout-settings/checkout-extensibility/checkout-upgrade). --- ## Comercio headless URL: https://nicolasmateos.com/glosario/comercio-headless/ Also called: headless, headless commerce, desacoplado Updated: 2026-10-22 Definition: Headless es construir el escaparate por tu cuenta y pedirle a Shopify solo los datos, a través de la Storefront API, en lugar de dejar que Shopify renderice las páginas con un tema. Ganas control absoluto del front-end y pierdes el editor de temas, parte del ecosistema de apps y el mantenimiento que antes no era tuyo. Es la decisión con peor relación entre lo que promete y lo que cuesta en la mayoría de los proyectos que me la piden. No porque esté mal, sino porque casi siempre se pide por el motivo equivocado. ## El motivo equivocado: "queremos que vaya rápido" Un tema bien hecho sobre Shopify va rápido. Cuando una tienda va lenta, la causa casi nunca es [Liquid](/glosario/liquid/): son los scripts de apps que ya nadie usa, las imágenes sin dimensionar y el carrito reconstruido a mano en cada cambio. Irse a headless con esos hábitos produce una tienda headless lenta, y además ahora el servidor es tuyo. ## Los motivos buenos - **El escaparate no es una tienda.** Una web de contenido enorme, una aplicación, un punto de venta raro, y la compra es una parte. - **Varias marcas o canales** compartiendo un mismo front-end. - **Un front-end que ya existe** y funciona, al que se le añade comprar. ## Lo que se pierde, y conviene escribirlo antes de empezar El editor de temas: tu cliente deja de montar páginas solo y vuelve a depender de desarrollo. Las apps que se instalan como bloques de tema dejan de servir. El checkout sigue siendo de Shopify, así que la libertad no es total. Y el alojamiento, el despliegue y las actualizaciones pasan a ser tuyos. En B2B hay un peaje extra: el contexto de empresa, el catálogo y el precio del comprador hay que llevarlos a mano por la [Storefront API](/glosario/storefront-api/), que en un tema vienen resueltos. Si después de leer esto sigues en el sí, [Hydrogen](/glosario/hydrogen/) es el camino corto. --- ## Condiciones de pago (payment terms) URL: https://nicolasmateos.com/glosario/condiciones-de-pago/ Also called: payment terms, pago aplazado, net 30, pago a 30 días Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Las condiciones de pago en Shopify B2B son el plazo con el que una empresa paga un pedido: al contado, a 30, 45 o 60 días, o a la recepción. Se asignan a la empresa o a la sede, y permiten que el comprador termine el pedido sin introducir una tarjeta. Es la función que convierte un carrito en un pedido mayorista de verdad. Un comprador profesional no paga con tarjeta: tiene un acuerdo y paga a plazo contra factura. ## Lo que cambia en el checkout Con condiciones asignadas, el checkout ofrece terminar el pedido sin cobro inmediato. El pedido entra como pendiente de pago con su fecha de vencimiento, y el cobro se gestiona después. Para el front-end eso significa que el botón de pagar no es el final del flujo: el final es un pedido confirmado que el comprador puede descargar. ## Dónde se nota en el front-end Dos sitios, y los dos se olvidan: - **El carrito.** Si el comprador sabe que paga a 60 días, decirlo en el carrito baja el abandono mucho más que cualquier sello de confianza. - **El área de cliente.** Un comprador con pago aplazado entra a ver qué tiene pendiente y cuándo vence. Si eso no está, lo pregunta por teléfono. ## Lo que no resuelve No es control de crédito. Shopify guarda el plazo, no el riesgo: no hay un límite de crédito que frene un pedido cuando la empresa ya debe demasiado. Si eso hace falta, sale del ERP, y entra en el proyecto como [integración](/servicios/integraciones-erp/) o como validación de carrito. Detalle en la [documentación de condiciones de pago](https://help.shopify.com/en/manual/b2b/payment-terms). --- ## Core Web Vitals URL: https://nicolasmateos.com/glosario/core-web-vitals/ Also called: LCP, INP, CLS, métricas web esenciales Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Core Web Vitals son las tres métricas con las que Google mide la experiencia de una página: LCP (cuánto tarda en pintarse el elemento principal), INP (cuánto tarda la página en responder a una interacción) y CLS (cuánto se mueve el contenido mientras carga). En Shopify las tres empeoran casi siempre por scripts de apps y por imágenes sin dimensionar. Importan por dos motivos distintos y conviene no mezclarlos. El primero es que son una señal de posicionamiento, pequeña pero real. El segundo, que es el que de verdad mueve dinero, es que una ficha de producto que tarda cuatro segundos en el móvil de un comprador pierde ventas. ## De dónde vienen los problemas en Shopify Por frecuencia, en las tiendas que he auditado: 1. **Scripts de apps que ya no se usan.** La app se desinstala del panel y su `script_tag` o su bloque sigue cargando. Es lo primero que miro y casi siempre hay dos o tres. 2. **Imágenes sin `width` y `height`.** Cada una es un salto de CLS, y el salto se nota justo cuando el usuario va a pulsar. 3. **La imagen principal cargada tarde**, dentro de un carrusel que arranca con JavaScript. El LCP se dispara aunque el servidor responda rápido. 4. **JavaScript del tema que bloquea la interacción**, normalmente por reconstruir el carrito entero en cada cambio en lugar de pedir la sección renderizada. ## Cómo lo mido Lighthouse sirve para comparar antes y después, pero lo que cuenta para Google son los datos de campo de usuarios reales. Una tienda puede tener 95 en Lighthouse y malos Core Web Vitals si el 70 % de sus visitas vienen de un móvil con conexión lenta. Por eso en esta web los números que se publican en [la página de código](/codigo/) se miden sobre el sitio ya desplegado, no en local. --- ## Empresa (company) URL: https://nicolasmateos.com/glosario/empresa-b2b/ Also called: company, cuenta de empresa, cliente B2B Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Una empresa (company) es el cliente en Shopify B2B: en lugar de una persona, el comprador es una organización con sus sedes y sus compradores asociados. De la empresa cuelgan el catálogo que ve, sus condiciones de pago y quién puede comprar en su nombre. Este cambio de modelo es el que rompe más suposiciones del tema. En B2C hay un cliente y una dirección; en B2B hay una empresa, varias sedes, y personas que compran para una o para varias de ellas. Un objeto `customer` ya no basta para saber qué precio toca. ## Los números Shopify no limita el número de empresas en ningún plan. Lo que sí tiene tope es lo que cuelga de cada una: hasta **10.000 sedes** y **10.000 compradores** por empresa. Son techos que en la práctica no se tocan; el límite que duele es el de [catálogos activos](/glosario/catalogo-b2b/), que depende del plan. ## Lo que hay que mirar al montar el portal Una empresa con varias sedes no es un detalle administrativo: cambia portes, impuestos, mínimos y a veces el catálogo. En Liquid, `customer.current_location` dice desde qué sede se está comprando, y con eso se pueden cambiar mensajes, mínimos o avisos de envío sin duplicar plantillas. El error habitual es dar por hecho que un comprador pertenece a una sola sede. Si pertenece a tres y el selector está escondido en la página de cuenta, el carrito se llena con los precios de la sede equivocada y la incidencia llega dos días después, ya facturada. Los límites están en la [documentación de empresas](https://help.shopify.com/en/manual/b2b/companies). --- ## GEO (Generative Engine Optimization) URL: https://nicolasmateos.com/glosario/geo/ Also called: optimización para motores generativos, posicionamiento en IA Updated: 2026-11-05 Definition: GEO es la optimización de contenido, identidad y acceso técnico para que motores generativos puedan encontrar, comprender y citar una fuente. En Shopify se aplica a productos, colecciones, guías y marca; no garantiza que un asistente recomiende la tienda. ## Qué cambia en una tienda Shopify Una ficha debe responder dudas de compra con datos comprobables: uso, medidas, materiales, compatibilidad y límites. Las guías explican cómo elegir y enlazan a productos pertinentes. El contenido visible y los datos estructurados deben describir el mismo producto, sin entidades duplicadas ni reseñas inventadas. El acceso técnico se comprueba antes de crear más contenido. Permitir un rastreador en robots.txt no demuestra que haya accedido, indexado o citado una página. En B2B, facilitar el acceso público tampoco debe exponer precios negociados ni catálogos restringidos. ## GEO, SEO y AEO SEO trabaja la visibilidad en buscadores. [AEO](/glosario/aeo/) organiza respuestas directas. GEO estudia también cómo se menciona y cita una fuente en respuestas generadas. La [comparativa SEO y GEO](/comparativas/seo-vs-geo-shopify/) separa objetivos y métricas. ## Qué no demuestra una implementación Publicar FAQ, JSON-LD o llms.txt demuestra que esas piezas existen. Para hablar de visibilidad hace falta registrar consultas, contexto, respuestas y URLs citadas. Para hablar de negocio hacen falta visitas y contactos. [Google Search Central](https://developers.google.com/search/docs/appearance/ai-features) explica la relación entre funciones de IA y fundamentos SEO. Ver el alcance de la [consultoría GEO para Shopify](/servicios/geo-shopify/). --- ## Hydrogen URL: https://nicolasmateos.com/glosario/hydrogen/ Also called: Hydrogen de Shopify, Oxygen, React en Shopify Updated: 2026-10-22 Definition: Hydrogen es el framework de Shopify, basado en React, para construir escaparates headless que leen los datos de la Storefront API. Shopify lo acompaña de Oxygen, su propio alojamiento, de modo que el camino de desarrollo a producción lo cubre la plataforma en lugar de montarlo tú. Si ya has decidido ir [headless](/glosario/comercio-headless/), Hydrogen es el camino con menos piezas sueltas: trae las consultas a la [Storefront API](/glosario/storefront-api/), el manejo del carrito y los componentes de producto resueltos, y se despliega en Oxygen sin montar infraestructura. La pregunta real no es "¿Hydrogen o otro framework?", es "¿headless o tema?". Si la respuesta es tema, Hydrogen no entra en la conversación. ## Cuándo lo recomendaría Cuando el equipo que va a mantener la tienda **ya trabaja en React** y el escaparate tiene lógica de interfaz que un tema haría incómoda. En ese caso, lo que en Liquid serían semanas de pelearse con el editor se convierte en código normal para ellos. ## Cuándo no Cuando el motivo es la velocidad. Un tema bien construido compite de sobra, y el peso de una tienda lenta casi nunca está en el renderizado del servidor: está en lo que se le ha ido añadiendo encima. Y cuando el cliente monta sus propias páginas. Ese es el coste que más tarde se nota: con Hydrogen, cada landing nueva vuelve a pasar por desarrollo, mientras que con [secciones y bloques](/glosario/secciones-y-bloques/) la monta el equipo de marketing en una tarde. ## En B2B, un aviso Hydrogen no te da gratis el contexto de empresa. El catálogo, el precio del comprador y la sede hay que pedirlos y propagarlos tú, cuando en un tema llegan resueltos. Es trabajo que no aparece en la demo. Documentación: [Hydrogen](https://shopify.dev/docs/storefronts/headless/hydrogen). --- ## Input query URL: https://nicolasmateos.com/glosario/input-query/ Also called: run.graphql, consulta de entrada, Function input Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: La input query es el archivo GraphQL que declara qué datos recibe una Shopify Function en tiempo de ejecución. Una Function solo ve lo que su input query pide, y como el input está limitado a 128 kB, decidir qué campos entran es tanto trabajo como la lógica. Es el archivo que más se subestima al escribir una Function. La lógica suele ser corta; lo que decide si la Function funciona en un carrito grande es lo que pediste. ## El límite de 128 kB no es teórico Con un carrito de 10 líneas sobra espacio para todo. Con un bloc de pedido mayorista de 200 líneas, cada campo de más se multiplica por 200. Pedir el título, la descripción y las imágenes de cada variante "por si acaso" es la forma más rápida de que una Function que pasaba las pruebas falle en el pedido real de un cliente. La regla que sigo: la input query pide **exactamente** los campos que el código lee, y cuando añado un campo al código, lo añado también aquí, en el mismo commit. ## Los alias son parte del diseño Un [metacampo](/glosario/metacampos/) llega con su `namespace` y su `key`, lo que produce un código feo. Con un alias llega con el nombre que tiene sentido para la lógica: ```graphql query RunInput { cart { lines { quantity merchandise { __typename ... on ProductVariant { id title casePack: metafield(namespace: "b2b", key: "case_pack") { value } } } } } } ``` Ese `casePack` es el mismo metacampo, con un nombre que se lee. Y `__typename` está ahí porque una línea de carrito no siempre es una variante de producto, y descartar lo que no lo es antes de tocarlo evita el error más común. Un ejemplo completo con su función y sus pruebas está en [shopify-checkout-lab](https://github.com/NicolasShopiDev/shopify-checkout-lab). --- ## Liquid URL: https://nicolasmateos.com/glosario/liquid/ Also called: lenguaje Liquid, plantillas Liquid, Shopify Liquid Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Liquid es el lenguaje de plantillas con el que se construyen los temas de Shopify. Se ejecuta en el servidor de Shopify antes de enviar el HTML al navegador, así que puede leer productos, colecciones, el cliente o el carrito, pero no puede reaccionar a nada que pase después en la página. Entender dónde se ejecuta Liquid resuelve el 90 % de las dudas sobre qué se puede hacer en un tema. Liquid pasa **una vez**, en el servidor. Cuando el HTML llega al navegador, Liquid ya ha terminado: a partir de ahí todo es JavaScript. ## Lo que eso implica en la práctica - Un precio que depende del cliente se puede decidir en Liquid porque la sesión ya existe cuando se renderiza. Por eso `customer.b2b?` es la forma correcta de que un precio mayorista **no llegue nunca al HTML** de un visitante sin sesión. - Un cambio de cantidad en el carrito no puede resolverlo Liquid: eso es la [Cart API](/glosario/api-ajax-de-carrito/). Lo que sí se puede es pedirle a Shopify que vuelva a renderizar una sección y devolver su HTML. - Un filtro de colección con 20 combinaciones no se monta con bucles de Liquid: se monta con los filtros nativos de la tienda. ## El coste de un bucle Liquid tiene límites de ejecución por página, y los temas lentos casi siempre tienen la misma causa: bucles anidados sobre colecciones grandes. Recorrer todas las variantes de todos los productos de una colección para calcular algo es la forma más rápida de que una página tarde segundos. La alternativa suele ser un [metacampo](/glosario/metacampos/) con el dato ya calculado. Mover el cálculo del render al momento de guardar es la optimización que más veces he aplicado. Referencia: [Liquid](https://shopify.dev/docs/api/liquid). --- ## Lista de precios URL: https://nicolasmateos.com/glosario/lista-de-precios/ Also called: price list, tarifa, pricing B2B Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: La lista de precios es la parte de un catálogo B2B que decide cuánto paga el comprador. Puede ser un ajuste porcentual sobre el precio de venta al público o un precio fijo por variante, y las dos formas se pueden mezclar dentro del mismo catálogo. La elección entre porcentaje y precio fijo parece menor y decide cuánto mantenimiento te va a costar la tienda cada temporada. ## Porcentaje sobre la tarifa Es un descuento que se aplica sobre el precio de venta al público. Cuando subes precios en B2C, los de mayorista se mueven solos. Es lo que recomiendo por defecto: ninguna lista se queda vieja. El problema aparece cuando el margen no es uniforme. Si en una familia de producto el mayorista paga un 40 % menos y en otra un 25 %, un porcentaje global no lo cubre y hay que partir el catálogo o pasar a precio fijo. ## Precio fijo por variante Es la tarifa escrita a mano, referencia por referencia. Da control absoluto y tiene un coste: cada cambio de precio en B2C hay que replicarlo aquí, y si no se replica, el mayorista acaba pagando más que el cliente final. Lo he visto en producción más de una vez. Mi regla: porcentaje por defecto, precio fijo solo en las referencias donde el acuerdo con el cliente obliga, y una revisión de la tarifa en el calendario. Si se mezclan, conviene dejar escrito en algún sitio qué referencias son fijas, porque dentro del admin no se distinguen de un vistazo. ## Lo que no es una lista de precios No es la forma de dar un precio distinto a cada cuenta sin Plus: los catálogos se asignan por mercado, así que la lista llega a todas las empresas de ese mercado. Para precio por cuenta hacen falta [Shopify Plus](/glosario/shopify-plus/) o una app pública. Detalle en la [documentación de precios B2B](https://help.shopify.com/en/manual/b2b/catalogs). --- ## Metacampos (metafields) URL: https://nicolasmateos.com/glosario/metacampos/ Also called: metafields, metafield, campos personalizados Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Los metacampos (metafields) son campos propios que se añaden a un objeto de Shopify —producto, variante, cliente, pedido, empresa— para guardar datos que la plataforma no trae de serie. Tienen tipo y validación, y son accesibles desde el tema en Liquid, desde la API y desde dentro de una Shopify Function. Es la primera herramienta que hay que mirar cuando aparece un dato que Shopify no tiene: la caja de almacén de una variante, la ficha técnica de un producto, el código de cliente del ERP. Antes de instalar una app o de inventar una convención en las etiquetas, casi siempre la respuesta es un metacampo. ## Con tipo, y eso importa Un metacampo no es texto libre: tiene un tipo (entero, decimal, fecha, referencia a producto, archivo, lista) y Shopify valida lo que se guarda. Eso evita el clásico de leer `"6 uds"` donde el código esperaba `6`. Y el tipo decide cómo se lee en el tema. Una referencia a producto llega como el objeto producto, no como un identificador que haya que resolver a mano. ## Variante frente a producto La decisión que más se equivoca. Si el dato cambia por talla o por color, va en la **variante**. La caja de almacén es un caso claro: no todas las tallas van en cajas de 6. Un metacampo de producto obliga a aproximar, y la aproximación aparece en el almacén. ## Por qué importan en las Functions Una [Shopify Function](/glosario/shopify-functions/) no puede llamar a nada: lo único que ve es lo que su [input query](/glosario/input-query/) le pasa. Así que cualquier regla de negocio que dependa de un dato propio necesita ese dato en un metacampo, con su alias en la consulta. Si el dato está en una app o en un sistema externo, la Function no lo puede usar. Documentación: [metafields](https://shopify.dev/docs/apps/build/custom-data/metafields). --- ## Metaobjetos (metaobjects) URL: https://nicolasmateos.com/glosario/metaobjetos/ Also called: metaobjects, metaobjeto, contenido estructurado Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Los metaobjetos son tipos de contenido definidos por ti dentro de Shopify, con sus propios campos: una guía de tallas, un material, un punto de venta, un autor. Existen por sí mismos, se referencian desde productos o páginas con un metacampo, y el tema los renderiza como cualquier otro objeto. La diferencia con un [metacampo](/glosario/metacampos/) es de pertenencia. Un metacampo describe a un objeto que ya existe. Un metaobjeto **es** un objeto: vive solo, se edita una vez y lo usan muchos productos. ## Cuándo vale la pena La prueba es sencilla: ¿este dato se repite en varios productos y cuando cambia hay que cambiarlo en todos? Si la respuesta es sí, es un metaobjeto. Los casos que más me encuentro: - **Guía de tallas** compartida por toda una familia de producto. - **Materiales o composiciones**, con su nombre, su descripción y su icono. - **Sedes o puntos de venta**, con dirección y horario, para una página de tiendas. - **Certificaciones**, que llevan logotipo y texto legal. El beneficio real no es técnico: es que el cliente lo edita una vez y se actualiza en 200 fichas, sin tocar el tema. ## Lo que hay que planificar Dos cosas. La primera, que un metaobjeto puede tener su propia URL si se le asigna, y entonces pasa a ser contenido indexable; conviene decidirlo a propósito y no por descuido. La segunda, que el tema tiene que renderizarlo: un metaobjeto sin una sección que lo muestre es un dato que nadie ve. Y el aviso de siempre: los metaobjetos no son una base de datos. Si lo que se quiere es un catálogo de 50.000 filas con búsqueda, no es esto. Documentación: [metaobjects](https://shopify.dev/docs/apps/build/custom-data/metaobjects). --- ## Pedido borrador (draft order) URL: https://nicolasmateos.com/glosario/pedido-borrador/ Also called: draft order, presupuesto, pedido manual Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Un pedido borrador (draft order) es un pedido creado desde el admin o la API antes de que exista un pago, con sus líneas, su cliente y su precio ya fijados. En B2B es la forma habitual de pasar un presupuesto a pedido y de meter un pedido tomado por teléfono o por email. En mayorista, el pedido no siempre empieza en la web. Empieza en una llamada, en un Excel que manda el comercial o en un email con quince referencias. El pedido borrador es donde aterriza todo eso sin romper el modelo de la tienda. ## Para qué se usa de verdad Tres cosas, por frecuencia: 1. **Presupuesto.** Se monta el pedido con precios y portes, se manda al comprador y, cuando lo acepta, se convierte en pedido. No hay que reescribir nada. 2. **Pedido tomado fuera de la web.** El comercial lo mete por el admin con el cliente y la sede correctos, y el precio sale del catálogo que le toca. 3. **Excepciones.** Un precio especial puntual o un porte negociado que no justifica tocar el catálogo. ## Lo que hay que saber antes de automatizarlo Si se crean por [API](/glosario/api-graphql-de-admin/) desde un ERP o un configurador, conviene tener claro que el borrador no reserva stock y que los precios que se escriben a mano no se recalculan solos. Un borrador creado en enero con un precio de enero sigue teniendo ese precio en marzo. El otro punto: el envío del borrador al comprador manda un enlace de pago. Si la empresa tiene [condiciones de pago](/glosario/condiciones-de-pago/) a plazo, el flujo correcto no es ese enlace, es convertirlo a pedido con su vencimiento. Detalle en la [documentación de pedidos borrador](https://help.shopify.com/en/manual/fulfillment/managing-orders/create-orders). --- ## Pedido rápido (quick order) URL: https://nicolasmateos.com/glosario/pedido-rapido/ Also called: quick order, bloc de pedido, order pad, pedido por referencia Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: El pedido rápido es la tabla donde un comprador mayorista introduce cantidades de muchas referencias a la vez y las envía al carrito en una sola operación. No es una función de Shopify sino un patrón de front-end, y es lo que más diferencia a un portal B2B usable de un catálogo bonito. Un comprador B2C compara y elige. Un comprador B2B ya sabe lo que quiere y lo que necesita es escribirlo rápido. Esa diferencia es todo el diseño del portal. ## El error que hace fallar la mitad de las implementaciones Una tabla con 40 referencias y una cantidad por fila invita a hacer una petición por línea. Cuarenta llamadas seguidas al carrito hacen dos cosas malas: el carrito parpadea cuarenta veces y, peor, **la última respuesta puede llegar antes que la primera**, así que el total que ve el comprador no es el que tiene. La [Cart API](/glosario/api-ajax-de-carrito/) acepta un objeto con varias líneas de golpe, y devuelve ya renderizado el HTML de las secciones que hay que repintar. Una petición, un estado, un repintado. ## Cantidades absolutas, no incrementos El segundo detalle que ahorra incidencias: enviar la cantidad total de cada línea, no "suma 3". Con cantidades absolutas, un primer pedido, una ampliación y una corrección son exactamente la misma petición, y una línea rechazada deja el carrito como estaba. ## Lo que no se puede olvidar - **Búsqueda por referencia**, que es como busca un comprador profesional, no por nombre de producto. - **Stock por fila**, porque pedir lo que no hay es la queja número uno. - **Las [reglas de cantidad](/glosario/reglas-de-cantidad/) aplicadas al propio campo**, con `min` y `step`. - **Sincronía con el resto del tema**: la misma variante tiene que mostrar la misma cantidad en la ficha, en el listado y en el buscador. El patrón completo, reconstruido sobre Dawn y sin código de ningún cliente, está en [shopify-b2b-order-portal](https://github.com/NicolasShopiDev/shopify-b2b-order-portal). --- ## Precios por volumen URL: https://nicolasmateos.com/glosario/precios-por-volumen/ Also called: volume pricing, precio por tramos, descuento por cantidad Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Los precios por volumen son escalones de precio dentro de un catálogo B2B: a partir de X unidades de una variante, el precio unitario baja. Se configuran por producto dentro del catálogo y están disponibles en todos los planes que soportan B2B, también sin Shopify Plus. Es la función de B2B que más proyectos salva y la que menos se usa. Cuando alguien pide un cuarto catálogo porque "este cliente compra mucho más", casi siempre lo que describe no es un precio distinto: es una cantidad distinta. ## Precio por tramos, no descuento Un tramo de volumen no es un descuento aplicado al final: es el precio unitario de esa variante a partir de esa cantidad. Eso tiene dos consecuencias prácticas. La primera es que el comprador ve el incentivo mientras pide, no al pagar. La segunda es que el tema tiene que mostrarlo: si el precio cambia al llegar a 12 unidades y la ficha no lo dice, el comprador pide 10 y nadie gana. ## Lo que hay que enseñar en el front-end En los portales que monto, la tabla de tramos va junto al selector de cantidad, y la fila activa se marca según lo que hay en el carrito. Dos detalles que importan: - El salto se calcula por **variante**, no por producto. Doce unidades repartidas entre cuatro tallas no son doce de una talla. - Si usas [reglas de cantidad](/glosario/reglas-de-cantidad/) con múltiplos, los tramos deberían caer en múltiplos válidos. Un tramo que empieza en 10 cuando el múltiplo es 6 es un tramo al que no se llega nunca. ## Cuándo no basta Cuando la diferencia entre dos clientes es de precio de verdad —un acuerdo cerrado, no un volumen— el tramo no lo resuelve. Ahí toca otro catálogo o, si ya tienes tres, [valorar Plus](/comparativas/shopify-plus-o-advanced/). La configuración está en la [documentación de catálogos y precios](https://help.shopify.com/en/manual/b2b/catalogs). --- ## Reglas de cantidad URL: https://nicolasmateos.com/glosario/reglas-de-cantidad/ Also called: quantity rules, mínimo de pedido, múltiplos, caja completa Updated: 2026-10-23 Facts checked: 2026-10-23 Definition: Las reglas de cantidad son el mínimo, el máximo y el incremento con los que se puede pedir una variante dentro de un catálogo B2B. Son la forma nativa de obligar a pedir en cajas completas o a partir de un mínimo, y funcionan en todos los planes que soportan B2B. Tres números por variante: mínimo, máximo e incremento. Con eso se cubre la mayor parte de lo que en una reunión se describe como "es que no pueden pedir unidades sueltas". ## Dónde se aplican y dónde no Las reglas viven en el catálogo, así que el mismo producto puede tener mínimos distintos para el mayorista y para el distribuidor. El tema las recibe y debería usarlas en el propio `input`: `min`, `max` y `step` en el campo de cantidad. Es la diferencia entre avisar al comprador antes de que escriba y avisarle cuando ya ha intentado pagar. Lo que no hacen: validar combinaciones entre líneas. "Mínimo 300 € por pedido" o "no se puede mezclar tarifa A y tarifa B en el mismo pedido" no son reglas de cantidad. Un importe mínimo igual para todos, o para todo el B2B, se pone desde abril de 2026 con la validación de límite de pedido de Checkout Blocks, en cualquier plan con B2B: está explicado en [pedido mínimo en Shopify](/blog/pedido-minimo-shopify/). Lo que cambia según la empresa o lo que lleva el carrito es una [Shopify Function](/glosario/shopify-functions/) de validación, y una Function escrita a medida necesita Plus. ## El caso de la caja completa El ejemplo que más repito: un producto que sale del almacén en cajas de 6. Con un incremento de 6 en la regla de cantidad, el campo ya no deja escribir 7 y el problema desaparece en el origen. Si por cualquier motivo la regla no se puede aplicar (un pedido importado, una línea creada desde el admin), el respaldo es una Function de validación que bloquea el checkout y dice qué cambiar. Esa Function está publicada con sus pruebas en [shopify-checkout-lab](https://github.com/NicolasShopiDev/shopify-checkout-lab). Configuración en la [documentación de catálogos](https://help.shopify.com/en/manual/b2b/catalogs). --- ## Secciones y bloques URL: https://nicolasmateos.com/glosario/secciones-y-bloques/ Also called: sections, blocks, secciones de tema, Online Store 2.0 Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Las secciones son los módulos de una plantilla de Shopify que el cliente puede añadir, ordenar y configurar desde el editor; los bloques son las piezas que van dentro de una sección. Desde Online Store 2.0 se pueden usar en cualquier plantilla, y son lo que hace que un tema se pueda mantener sin un desarrollador. Es la parte del trabajo de un tema que no se ve en la maqueta y decide si el proyecto envejece bien. Dos temas pueden verse igual el día de la entrega: en uno el cliente monta una landing en veinte minutos, en el otro pide presupuesto cada vez. ## El criterio para partir en secciones Una sección por **intención de la página**, no por fila del diseño. Si el diseño tiene tres bandas de texto con imagen que solo se diferencian en el lado de la foto, no son tres secciones: es una con un ajuste de posición. El error contrario es igual de común: una sección gigante con cuarenta ajustes. Si el cliente tiene que leer un manual para usarla, la sección está mal partida. ## Lo que convierte una sección en algo útil - **Valores por defecto sensatos.** Una sección recién añadida tiene que verse bien sin tocar nada. - **Bloques con límite.** Un carrusel que admite 30 bloques acabará con 30 bloques. - **Texto en los ajustes, no en el código.** Todo lo que el cliente podría querer cambiar algún día. - **Nombres en su idioma.** "Banda destacada" y no "hero_section_2". ## Dónde conectan con el contenido Cuando los datos que muestra una sección se repiten entre páginas, no van en los ajustes: van en [metaobjetos](/glosario/metaobjetos/) y la sección los referencia. Así el cliente edita el dato una vez y cambia en todas las páginas donde aparece. Documentación: [secciones de tema](https://shopify.dev/docs/storefronts/themes/architecture/sections). --- ## Sede de empresa (company location) URL: https://nicolasmateos.com/glosario/sede-de-empresa/ Also called: company location, ubicación de empresa, delegación Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Una sede (company location) es la dirección concreta de una empresa desde la que se compra, y es la unidad que realmente decide el pedido: su dirección de envío, sus impuestos, sus condiciones de pago y, en Shopify Plus, su propio catálogo. Una empresa con tres delegaciones puede comprar a tres precios distintos. La sede es el objeto que más se infravalora al presupuestar un portal B2B. Suena a dato de facturación y en realidad es la pieza que decide qué ve el comprador. ## Qué cambia entre planes En Shopify Plus un catálogo se puede asignar **directamente a una sede**. Sin Plus no: el catálogo se asigna a un mercado B2B y las empresas de ese mercado lo heredan, igual para todas sus sedes. Por eso "cada delegación con su tarifa" es uno de los motivos reales para pasar a Plus. El tope de la plataforma es de **25 catálogos por sede** y **50 compradores por sede**, igual en todos los planes. Ese 25 convive con el límite de 3 catálogos activos de los planes sin Plus: el primero es de la plataforma, el segundo es de tu plan, y es el segundo el que te frena. ## El selector de sede Si un comprador tiene varias sedes, el cambio de sede tiene que estar donde se compra, no enterrado en la cuenta. Cambiar de sede puede cambiar el precio de todas las líneas del carrito, así que conviene que el cambio sea visible y que el carrito avise de que se ha recalculado. En la práctica lo resuelvo con un selector en la cabecera que lee `customer.current_location` y que, al cambiar, recarga el carrito. Es el patrón que describo en [la página de código](/codigo/). Más detalle en la [documentación de sedes](https://help.shopify.com/en/manual/b2b/companies). --- ## Shopify B2B URL: https://nicolasmateos.com/glosario/shopify-b2b/ Also called: B2B nativo, venta mayorista en Shopify, Shopify wholesale Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Shopify B2B es el conjunto de funciones de venta mayorista integradas en la propia tienda: el cliente deja de ser una persona y pasa a ser una empresa con sus sedes, y los precios salen de catálogos asignados a esas empresas. No es una app ni un tema aparte, es un modelo de datos dentro de la tienda que ya tienes. Lo que distingue a B2B nativo de los apaños que se hacían antes (etiquetas de cliente, descuentos automáticos, una segunda tienda en paralelo) es que el precio mayorista **llega resuelto al tema**. El front-end no calcula nada: pide el precio de la variante y recibe el que corresponde a la empresa del comprador que tiene la sesión abierta. ## En qué planes funciona La documentación de Shopify lista B2B en **Basic, Grow, Advanced y Shopify Plus**, y lo excluye solo de Starter y Retail. La diferencia entre planes no está en si puedes vender al por mayor, sino en cuántos [catálogos](/glosario/catalogo-b2b/) activos puedes tener: tres en total en los planes sin Plus, sin límite en Plus. ## Qué tiene que hacer el tema Una sola cosa, y es la que más veces se hace mal: decidir quién ve precios. La condición es `customer.b2b?`, y la regla es que si el visitante no es B2B el precio **no debe llegar al HTML**, no basta con ocultarlo por CSS. ```liquid {% if customer.b2b? %} {{ product.selected_or_first_available_variant.price | money }} {% else %} Accede para ver precios {% endif %} ``` El resto del trabajo de un portal mayorista no depende del plan ni de B2B: es flujo de pedido. Tabla de tallas con stock, búsqueda por referencia, repetir el último pedido. Eso es front-end, y es donde se nota la diferencia para el comprador. Los detalles del modelo están en la [documentación de B2B](https://help.shopify.com/en/manual/b2b). --- ## Shopify Functions URL: https://nicolasmateos.com/glosario/shopify-functions/ Also called: Functions, funciones de Shopify, function Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Las Shopify Functions son código propio que se ejecuta dentro del back-end de Shopify, en puntos concretos del carrito y del checkout: descuentos, validaciones, transformación de líneas, métodos de envío y de pago. Se escriben en JavaScript o Rust, se compilan a WebAssembly, y una Function a medida solo se puede instalar en tiendas con Shopify Plus. Las Functions son la respuesta de Shopify a "necesito una regla de negocio que la plataforma no trae". Sustituyeron a [Shopify Scripts](/glosario/shopify-scripts/) y se diferencian en algo importante: no corren en el navegador ni en un servidor tuyo, corren dentro de Shopify, antes de que el checkout se dibuje. ## El presupuesto, que es la parte que sorprende Una Function no es una función normal. Tiene un presupuesto de ejecución —del orden de **11 millones de instrucciones**— y un **límite de 128 kB en el input**. Eso cambia cómo se escribe: - La [input query](/glosario/input-query/) es la mitad del trabajo: una Function solo ve lo que pide, y en un bloc de pedido con 200 líneas no caben campos de sobra. - No hay llamadas de red. No puedes consultar tu ERP desde dentro de una Function. - Los datos que la Function necesita y que no son nativos van en [metacampos](/glosario/metacampos/), que es lo que sí llega en el input. ## El límite de plan Es el punto que más presupuestos rompe: **solo las tiendas con Shopify Plus pueden instalar apps personalizadas que contengan Functions**. En Basic, Grow y Advanced puedes usar funciones que vengan dentro de una app pública del App Store, pero no una escrita para tu tienda. La diferencia práctica: con la app pública te adaptas a su modelo de datos, con una Function propia el modelo lo pones tú. ## Un ejemplo completo Una Function de validación que bloquea el checkout cuando una línea no es múltiplo de la caja de almacén, con su input query y sus pruebas, está publicada en [shopify-checkout-lab](https://github.com/NicolasShopiDev/shopify-checkout-lab) y se puede tocar en vivo en el Checkout Lab de [la portada](/). Documentación oficial: [Shopify Functions](https://shopify.dev/docs/api/functions). --- ## Shopify Markets URL: https://nicolasmateos.com/glosario/shopify-markets/ Also called: Markets, mercados, multimercado, internacional Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Shopify Markets es la función con la que una tienda vende en varios países desde un solo panel: cada mercado tiene sus países, su moneda, sus idiomas, sus impuestos y sus ajustes de precio. En B2B tiene un papel extra, porque sin Shopify Plus los catálogos se asignan a través de mercados B2B. Para una tienda B2C, Markets es lo que evita montar cuatro tiendas para vender en cuatro países. Para una tienda B2B es más que eso: es la pieza de la que depende tu estructura de precios si no tienes Plus. ## El cruce con B2B que hay que dibujar antes Sin Shopify Plus un [catálogo](/glosario/catalogo-b2b/) no se asigna a una empresa: se asigna a un mercado B2B, y las empresas de ese mercado lo heredan. Como solo puedes tener tres catálogos activos, tu segmentación de precios y tu segmentación geográfica tienen que caber en el mismo esquema. Ejemplo de lo que pasa en una reunión real: si los niveles son "mayorista España", "mayorista Portugal" y "distribuidor", ya se han gastado los tres y no queda hueco para cuentas clave. Dibujarlo en una pizarra antes de elegir plan ahorra la conversación. ## Lo que afecta al front-end - **El selector de país e idioma** tiene que existir y no reiniciar el carrito. - **Los precios redondeados** por mercado cambian lo que muestra la ficha; si el tema cachea precios en JavaScript, hay que invalidarlos al cambiar de mercado. - **El SEO internacional** se decide aquí: cada mercado con su dominio o subcarpeta y su `hreflang`. Una tienda con cuatro mercados y un solo `hreflang` compite consigo misma. Documentación: [Shopify Markets](https://help.shopify.com/en/manual/markets). --- ## Shopify Plus URL: https://nicolasmateos.com/glosario/shopify-plus/ Also called: Plus, plan Plus, Shopify enterprise Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Shopify Plus es el plan superior de Shopify. Lo que desbloquea y de verdad cambia un proyecto son cuatro cosas: catálogos B2B sin límite y asignables a una empresa o sede concreta, poder instalar apps personalizadas con Shopify Functions propias, personalizar el checkout más allá de una app pública, y tiendas de desarrollo. Plus se vende como "para marcas grandes" y eso no ayuda a decidir. La pregunta útil no es el tamaño de la marca, es si el proyecto choca con un muro concreto de los planes de abajo. ## Los cinco motivos reales Por orden de frecuencia en los proyectos que me llegan: 1. **Más de tres tarifas en uso real.** El límite de [catálogos activos](/glosario/catalogo-b2b/) sin Plus es de tres en toda la tienda. 2. **Precio negociado por cuenta**, en lugar de por nivel. Sin Plus los catálogos se asignan por mercado. 3. **Catálogos distintos por delegación** de la misma empresa. Sin Plus no se puede asignar un catálogo a una [sede](/glosario/sede-de-empresa/). 4. **[Functions](/glosario/shopify-functions/) a medida.** Solo las tiendas con Plus pueden instalar apps personalizadas que contengan Shopify Functions. Sin Plus puedes usar funciones que vengan dentro de una app pública, pero no una escrita para tu tienda. 5. **Checkout** más allá de lo que permite una app pública. Si marcas uno, la conversación deja de ser técnica y pasa a ser de números. Si no marcas ninguno, el presupuesto del salto de plan rinde más gastado en flujo de pedido. ## Lo que no es motivo "Queremos personalizar el checkout" no basta como motivo si lo que se quiere es cambiar colores, logotipo o añadir un campo: eso se hace con extensiones y apps públicas en planes sin Plus. Y "vamos a crecer mucho" tampoco: Plus se puede contratar el día que haga falta, y el muro se nota antes en el número de tarifas que en el de pedidos. Comparado en detalle en [Shopify Plus o Advanced](/comparativas/shopify-plus-o-advanced/). --- ## Shopify Scripts URL: https://nicolasmateos.com/glosario/shopify-scripts/ Also called: Scripts, Ruby scripts, Script Editor Updated: 2026-10-21 Facts checked: 2026-10-21 Definition: Shopify Scripts era el sistema anterior a las Functions para aplicar reglas propias de descuento, envío y pago en tiendas Shopify Plus, escrito en Ruby desde el Script Editor. Dejó de ejecutarse en junio de 2026, y lo que lo sustituye son las Shopify Functions. Si una tienda todavía tiene Scripts en su documentación interna, en su wiki o en el contrato de mantenimiento, lo que tiene es una regla de negocio que ya no se está aplicando. ## Qué cambia al migrar No es una traducción de Ruby a JavaScript. El modelo es distinto en tres puntos que obligan a rediseñar, no a reescribir: - **Scripts corría en el momento del checkout y veía el carrito entero.** Una [Function](/glosario/shopify-functions/) declara en su [input query](/glosario/input-query/) qué campos necesita, y solo recibe esos. - **Un Script no tenía presupuesto de instrucciones visible.** Una Function sí, y eso descarta recorrer el catálogo entero dentro del código. - **Las Functions se despliegan como una app**, con versiones y configuración, no como un texto guardado en el admin. Eso es mejor para mantener y más trabajo la primera vez. ## Lo que se encuentra en la práctica Los Scripts que más se usaban eran tres: descuento por etiqueta de cliente, ocultar métodos de envío según el carrito y reordenar métodos de pago. Los tres tienen hoy su Function equivalente, y en B2B dos de ellos se resuelven incluso sin código: el descuento por nivel es un [catálogo](/glosario/catalogo-b2b/) y el mínimo por caja son [reglas de cantidad](/glosario/reglas-de-cantidad/). Antes de presupuestar una migración conviene mirar cuáles de los Scripts viejos han dejado de hacer falta. En los proyectos que he visto, la mitad. Documentación de lo que las sustituye: [Shopify Functions](https://shopify.dev/docs/api/functions). --- ## Storefront API URL: https://nicolasmateos.com/glosario/storefront-api/ Also called: API de escaparate, Storefront GraphQL API Updated: 2026-10-22 Definition: La Storefront API es la interfaz GraphQL pensada para el lado del comprador: lee productos, colecciones y contenido, y crea y modifica carritos. Está pensada para usarse desde el navegador o desde una app, con un token público, y es la base sobre la que se construye una tienda headless. La confusión habitual es pensar que es "la otra API" y que da igual cuál uses. No da igual: la [API de Admin](/glosario/api-graphql-de-admin/) es privada y gestiona la tienda, la Storefront es pública y sirve para comprar. ## Público quiere decir público El token de la Storefront API viaja al navegador, así que cualquiera puede leerlo y usarlo. Eso es normal y está pensado así, pero tiene una consecuencia que conviene entender: **lo que expongas por ahí es visible para todo el mundo**. En una tienda B2C no suele importar, porque el catálogo ya es público. En un portal mayorista sí importa, y mucho: si montas una pieza con la Storefront API que devuelve precios de catálogo B2B, estás publicando tu tarifa. Esa es la razón por la que en los portales que monto el precio mayorista se decide en [Liquid](/glosario/liquid/), en el servidor, y no se pide desde el navegador. ## No hace falta ser headless para usarla Se asocia a [headless](/glosario/comercio-headless/) y se puede usar perfectamente dentro de un tema normal, para una pieza concreta: un buscador rápido, un selector de producto complejo, un configurador. Es una decisión por componente, no por tienda. Documentación: [Storefront API](https://shopify.dev/docs/api/storefront). --- ## Theme app extension URL: https://nicolasmateos.com/glosario/theme-app-extension/ Also called: app block, bloque de app, app embed, extensión de app en el tema Updated: 2026-10-22 Definition: Una theme app extension es la forma en la que una app añade funcionalidad a un tema sin modificar sus archivos: aporta bloques que el comerciante coloca desde el editor, o un embed que se activa para toda la tienda. Al desinstalar la app, sus bloques se van con ella. Esto resuelve el problema más caro del mantenimiento de una tienda Shopify: las apps que dejan restos. ## El modelo viejo, y por qué dolía Antes, una app se instalaba metiendo su código en tu tema: una etiqueta de script, un fragmento pegado en `theme.liquid`, a veces una plantilla entera. Desinstalar la app quitaba la app, pero **el código seguía ahí**, cargando su script en cada página y sin que nadie recordara de dónde había salido. Esos restos son, con diferencia, lo primero que encuentro al auditar una tienda lenta: dos o tres scripts de apps que ya no están instaladas. Y cuando una app así se desinstala mal, el tema se queda con fragmentos rotos que revientan al actualizar. ## El modelo actual Con una theme app extension, el código de la app vive en la app, no en tu tema. El comerciante coloca el bloque donde quiere desde el editor, igual que una [sección](/glosario/secciones-y-bloques/), y la app se actualiza sin tocar tu tema. Consecuencias prácticas que conviene usar a tu favor: - **Al desinstalar no queda nada.** Se acabó el arqueólogo buscando scripts huérfanos. - **Tu tema sigue siendo actualizable**, porque la app no lo ha editado. - **Si una app todavía te pide pegar código en `theme.liquid`**, es una señal sobre cómo está mantenida. No es descalificante, pero sí un dato antes de instalarla. Documentación: [theme app extensions](https://shopify.dev/docs/apps/build/online-store/theme-app-extensions). --- ## WebAssembly (Wasm) URL: https://nicolasmateos.com/glosario/webassembly/ Also called: Wasm, WebAssembly, wasm32 Updated: 2026-10-22 Definition: WebAssembly es el formato al que se compilan las Shopify Functions antes de subirlas. Shopify no ejecuta tu JavaScript o tu Rust tal cual: ejecuta el módulo Wasm resultante, en un entorno aislado, sin acceso a la red y con un presupuesto de instrucciones. No es un detalle de implementación que puedas ignorar: explica las tres reglas de las [Functions](/glosario/shopify-functions/) que más desconciertan cuando empiezas. ## De dónde salen las limitaciones **No hay llamadas de red.** Un módulo Wasm solo ve lo que le pasan por la entrada. Por eso una Function no puede consultar tu ERP ni una API externa, y por eso cualquier dato propio tiene que llegar en [metacampos](/glosario/metacampos/) a través de la [input query](/glosario/input-query/). **Hay un presupuesto de instrucciones.** Shopify ejecuta tu módulo dentro de su checkout, para todos los compradores de todas las tiendas, así que lo limita. Es la razón de que recorrer el catálogo entero dentro de una Function no sea una opción. **Es rápido y aislado.** Un módulo Wasm arranca en microsegundos y no puede tocar nada fuera de su caja. Eso es lo que permite a Shopify ejecutar código de terceros en el camino crítico de un pago. ## Qué significa para elegir lenguaje Shopify soporta oficialmente JavaScript y Rust, pero en el fondo **vale cualquier lenguaje que compile a Wasm**. En la práctica elijo JavaScript salvo que el presupuesto apriete: se lee, se prueba con herramientas normales y lo puede mantener cualquiera del equipo. Rust entra cuando la función recorre carritos muy grandes y hay que exprimir instrucciones. La decisión no suele ser técnica, es de mantenimiento: ¿quién va a tocar esto dentro de un año? Documentación: [lenguajes para Functions](https://shopify.dev/docs/apps/build/functions/programming-languages). --- ## Webhooks URL: https://nicolasmateos.com/glosario/webhooks/ Also called: webhook, suscripción de webhook, eventos de Shopify Updated: 2026-10-22 Definition: Un webhook es una petición HTTP que Shopify envía a una URL tuya cuando ocurre algo en la tienda: un pedido nuevo, un producto actualizado, un cliente creado. Es la forma correcta de enterarse de los cambios, en lugar de preguntar cada pocos minutos por la API. La diferencia con una sincronización que pregunta cada cinco minutos es doble: te enteras al instante y no gastas presupuesto de API preguntando por cosas que no han cambiado. ## Lo que hay que hacer sí o sí **Verificar la firma.** Cada envío lleva una cabecera HMAC calculada con el secreto de tu app. Un endpoint que no la comprueba acepta pedidos inventados por cualquiera que conozca la URL. Es el fallo de seguridad que más veces he visto en integraciones hechas con prisa. **Contestar rápido y trabajar después.** Shopify espera una respuesta en pocos segundos. Si tu endpoint se pone a escribir en el ERP antes de contestar, acabas fallando por tiempo de espera aunque el trabajo se haya hecho. Lo correcto es guardar el aviso, devolver 200 y procesarlo en una cola. **Asumir duplicados.** El mismo evento puede llegarte dos veces. Si cada aviso crea un pedido en tu sistema, acabarás con pedidos repetidos. Guarda el identificador del evento y descarta lo que ya has procesado. ## Lo que pasa cuando tu servidor está caído Shopify reintenta durante un tiempo y, si sigue fallando, acaba desactivando la suscripción. Ese es el escenario que hay que diseñar: no "¿y si falla un aviso?", sino "¿cómo recupero lo que me perdí mientras estuve caído?". La respuesta suele ser un repaso por la [API de Admin](/glosario/api-graphql-de-admin/) que cubra la ventana de caída. Las condiciones exactas de reintento están en la [documentación de webhooks](https://shopify.dev/docs/apps/build/webhooks).