Skip to main content
A settings page listing three apps as cards, each with switches to enable it for me or for my org.

mountEmbeddedAppMarketplace() lists your approved apps as cards, with a switch for each scope the user may turn apps on for.

Mount the marketplace

Put it on a settings or integrations page, with the marketplace token:
It lists every approved app as a card with its icon, name, tagline, description, support and privacy policy links, and switches:
  • Enable for me, when your marketplace allows For themselves.
  • Enable for my org, when your marketplace allows For their org and the token has embed:enable_org and an embed.org.
An app the user’s org turned on shows as on, with “Enabled by your org”, and the user can’t turn it off for themselves. Only an org admin can turn it off for the org. An app still on in a scope your marketplace stopped allowing keeps its switch, so it can be turned off.

Options

Handle methods

Style it to match your product

Unlike the apps, the marketplace renders directly in your page, in a shadow root on an element it adds to your container. It inherits your page’s font and text colour. Tune the rest with these CSS custom properties, set on the container or any ancestor: For anything else, style its parts with ::part(): apps, empty, card, icon, name, tagline, description, links, link, toggles, toggle, toggle-label and note.

Or build your own

To show the marketplace in your own design system, or to turn apps on from your server, for example when you onboard an office, call the marketplace API directly. It’s what the component is built on.

Next

Review the apps publishers list in your marketplace.