First look at Sitecore Marketplace SDK
Author
Roberto Armas
Date Published

Why an SDK for the Marketplace?
Sitecore Marketplace SDK is the new toolset Sitecore has provided for developers. If you’re looking to extend Sitecore capabilities, the Marketplace SDK makes it easy to create, validate, and publish your listings directly from your workflow.
With the SDK you can currently create two types of applications:
- Custom App – for internal or partner-specific use cases. These apps are private by design and can be distributed to selected organizations.
- Public App (coming soon) – for broader distribution across the Sitecore Marketplace, discoverable by all customers.
This post is a first look at what the SDK offers—why it matters, what’s included today, and how you can start using it right away.

In your Sitecore instance, open Developer Studio → Create app. After naming your app, you’ll choose extension points—places inside Sitecore where your UI will render. For each one you toggle on, provide the path (route) in your app to display there.
Extension point | Where it shows up | When to use | Example path |
---|---|---|---|
Standalone | Full screen in Cloud Portal | Admin/ops tools, reports, or anything that isn’t tied to a specific site or page. It's good for creating a Preference page. | / |
XM Cloud – Full screen | Full screen inside XM Cloud | Authoring experiences, assistants, or workflows for editors | / |
Dashboard widgets | XM Cloud dashboard tile | KPIs, inboxes, “what changed” feeds, quick actions | /widget |
Page context panel (Page Builder) | Left-hand panel while editing a page | Context-aware helpers (e.g., chat, SEO checks, content suggestions) | /chat |
Custom field (Page Builder) | Right-hand panel field (or in left page context) | Custom inputs/controls that read/write page or component data | /custom-field |

Configure → Install → Connect
Once you’ve selected your extension points in Developer Studio, the app configuration is done. From there you can install the app into your XM Cloud instance so authors can see it in the places you enabled (standalone, dashboard widget, Page Builder panels, etc.).
Connect your code with the Marketplace SDK
Sitecore has a well-documented quick start guide: Initialize the SDK. The short version: instantiate the SDK client, then you can call Sitecore resources like the Authoring API, Delivery API, and Preview API from your app or services.
Example: call the Preview API with GraphQL
Once the client is instantiated, you can execute GraphQL against Preview:
1 client2 .mutate("xmc.preview.graphql", {3 params: {4 query: {5 sitecoreContextId,6 },7 body: {8 query: `9 query {10 site{11 allSiteInfo {12 results {13 name14 }15 }16 }17 }18 `,19 },20 },21 })
What’s happening?
- client.mutate("xmc.preview.graphql", …) targets the Preview GraphQL operation.
- params.query carries request querystring values (e.g., sitecoreContextId).
- body.query is your GraphQL string.
Conclusion
The Sitecore Marketplace SDK streamlines the entire path from idea to live app: pick your surfaces in Developer Studio, connect to Sitecore via a single client. Start with a Custom App, wire up your routes (e.g., /, /widget, /chat, /custom-field), and use the Authoring/Delivery/Preview APIs to deliver real value to editors and marketers. As Public Apps arrive, the same foundation will let you scale distribution with minimal rework.