Skip to main content
The Listing is what buyers see: who you are, what you sell, and where they can find you. Open it from the seller rail, ask Semi, or call open_page with page: "listing". It has four steps, completed in order.

​
1. Identity

Name, logo and colors come from your brand domain and its brand.json, not from fields you type on the listing. Set the brand domain here or with set_storefront_operator_domain; correct the identity at its source rather than overriding it. Verification rules are in Which domain is which.

​
2. What you do

The description, buyer-visible channels and accepted countries, plus your business profile (summary, regions, verticals, publisher domains, evidence URLs). These feed every destination below.
  • save_seller updates the description, channels, countries, links and what your listing publishes about your advertising policies (advertisingPolicyDisclosure).
  • update_business_profile applies a confirmed business-profile change.

​
3. Listed on the marketplace

A switch included with every account. When it’s on, buyers browsing the marketplace can find your storefront. Turning it off hides it from the marketplace (“Buyers you work with can still reach your agent.”) and stops any public listing at once; it asks you to confirm. The same switch is publish_discovery with visibility: "marketplace" or "private".

​
4. Public distribution

Serves your listing on your own domain, and unlocks the app destinations. It needs the Distribution package on your plan and a listing already live on the marketplace.
  1. Save your public listing domain; add the one CNAME record it gives you at your registrar.
  2. Verify it. Verifying doesn’t publish.
  3. Choose Make it public (publish_discovery with visibility: "public").
The steps and the scheduled re-check are in Which domain is which. For an active Demo Storefront, Public distribution is optional.

​
Distribution

Below the steps, Distribution shows the listing’s Agent URL, Card URL and MCP URL, and the destinations as tabs: + Add destination lists Microsoft Teams, Discord and WhatsApp as early access.

​
OpenAI domain token

To prove domain ownership to OpenAI, paste the token OpenAI gives you. Semicola publishes it at the address OpenAI checks on your verified public listing domain (update_discovery_openai_challenge), and probe_discovery_openai_challenge re-checks that the address returns exactly that token. OpenAI’s review itself happens in OpenAI’s portal.

​
Not available yet

  • Reviewer access and the OpenAI submission package for a ChatGPT app.
  • Slack, Microsoft Teams, Discord and WhatsApp destinations.