Skip to main content
Publishing tab on a listing

Catalog > Listings > [Listing] > Publishing

Publishing settings define where your listing is available: the service locations it can be fulfilled from, and the sales channels it is sold through.

​
Store locations

Manage in which locations this listing is purchasable. Each selected location determines where customers can view and place orders for the listing. If a listing should only appear in specific stores or warehouses, select those locations here. Leave all locations unselected to keep the listing hidden from customer-facing catalogs.
Removing a location from visibility does not cancel existing orders at that location.

​
Sales channels

Two toggles control where the listing can be sold:
  • Admin (salesChannelAdmin) — the listing is available when creating orders from the admin.
  • Online store (salesChannelOnline) — the listing is sold through your online storefront.
Disable both to keep the listing in the catalog but unsellable. The tab shows a warning when no channel is enabled.

​
Via the API

Listings are the catalog resource. Authenticate with the X-API-KEY header (see API Keys) and call:
  • GET /v1/admin/catalog — list listings (with filters, orderBy, and pagination)
  • PUT /v1/admin/catalog/{id} — update a listing, including the sales-channel flags salesChannelAdmin and salesChannelOnline
See the API reference for the full request and response schemas — it is generated from the live API, so it always reflects the current fields.

​
Visibility and Permissions

This tab is gated by catalog:listing_publishing, in the four operations — , , and . All four system roles — Owner, Admin, Manager and Member — hold every operation on this. Both cards on the tab fall under that one permission. There is no separate gate for location visibility, and no per-location scoping: a role either edits publishing for every location the listing can reach, or edits none of it. For what each operation means and the full role matrix, see Users & Roles.

​
Summary

Publishing settings define the where of your listing’s availability:
  • Store locations — which service locations show and fulfil the listing.
  • Sales channels — whether it is sold in the admin, the online store, both, or neither.

Catalog Permissions

Role requirements for catalog features.

Sales Channels

Configure your sales channel settings.

Where a listing sells

Status, store locations and sales channels together — and why a listing is missing from one store.