RMC Digital Logo
Sitecore,  XM Cloud

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.

Marketplace Developer Studio

In your Sitecore instance, open Developer StudioCreate 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

Configuration Example


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 client
2 .mutate("xmc.preview.graphql", {
3 params: {
4 query: {
5 sitecoreContextId,
6 },
7 body: {
8 query: `
9 query {
10 site{
11 allSiteInfo {
12 results {
13 name
14 }
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.