Skip to main content

What is the Embedded Marketplace?

The embedded marketplace is a pre-built integration catalog that you embed directly into your application, enabling customers to browse, configure, and deploy integrations themselves without requiring support from your team.

Integration marketplace embedded in your app(maxWidth: 800px)

How it works​

The embedded marketplace provides a complete self-service experience for your customers:

  1. Browse integrations: Customers view available integrations in a catalog that matches your app's branding
  2. Deploy instances: Customers select an integration and are guided through a custom configuration wizard
  3. Manage integrations: Customers can view, reconfigure, pause, or remove their deployed integration instances

This contrasts with the traditional approach where your team members deploy integrations on behalf of customers through the Prismatic web app.

Benefits of self-service​

Enabling customers to deploy integrations themselves offers several advantages:

  • Reduced support burden: Your team doesn't need to manually configure and deploy each integration for every customer
  • Faster customer activation: Customers can enable integrations immediately without waiting for your team
  • Better customer experience: Customers have control over their integrations and can make changes when needed
  • Scales with your customer base: Self-service deployment scales effortlessly as you add more customers and integrations

Marketplace features​

The embedded marketplace includes powerful capabilities:

  • Filtering and search: Customers can filter integrations by category or label, and search by name
  • Multiple instances: Customers can deploy multiple instances of the same integration (for example, separate instances for different Shopify stores)
  • Custom branding: The marketplace matches your application's look and feel through theming
  • Configuration wizard: Each integration includes a custom configuration wizard you design to collect necessary settings
  • Inline or popover display: Choose whether to embed the marketplace as an iframe or display it in a popover modal

You can also create a custom marketplace UI using Prismatic's GraphQL API if you need more control over the user experience.

Embedding the marketplace​

Embedding the marketplace in your application requires minimal code using Prismatic's embedded SDK. The SDK provides JavaScript functions to authenticate customer users and display the marketplace interface.

Here's a simple example:

import prismatic from "@prismatic-io/embedded";

// Authenticate the customer user
await prismatic.authenticate({ token: customerToken });

// Display the marketplace
prismatic.showMarketplace({
  selector: "#marketplace-container",
  usePopover: false,
});

The marketplace can be embedded as an iframe within your application or displayed as a popover overlay.

Next steps​

Ready to add an embedded marketplace to your application?