Publish a Product
Publishing moves a product from draft or internal management into the marketplace lifecycle.
Before You Publish
Review the product in the dashboard and confirm:
- product metadata is complete,
- required assets are uploaded,
- at least one release exists,
- pricing is set,
- visibility and compatibility are ready.
In the Dashboard
- Open Marketplace.
- Select the marketplace instance.
- Open Developer.
- Open Manage.
- Open the product.
- Review Details, Images, Releases, and Pricing.
- Confirm at least one release is available now.
- Publish the product.
If publishing fails, the dashboard shows the missing requirement. Fix the product setup, then publish again.
What Happens Behind the Scenes
The publish action validates the product before changing its status.
| Check | Required state |
|---|---|
| Ownership | The item must belong to the current developer organisation. |
| Metadata | Latest metadata must exist and include a display name. |
| Price | A current base price must exist. |
| Release | At least one release must be available now. |
| Binary | The active release must have a completed binary asset. |
If a release is scheduled for the future, the product cannot be published until at least one release is currently available.
Visibility
Publishing and visibility are separate controls. Publishing makes the product eligible for the marketplace lifecycle. Visibility controls whether the item is enabled for downstream surfaces. Hide a product when you need to remove it from active surfaces without deleting its metadata, price history, release history, or purchase records.
After Publishing
After a product is published:
- Marketplace admins can create an offering from the product and apply platform markup.
- Providers can discover offered products and create listings.
- Storefronts can sell listed products through checkout.
- Purchased products can be installed onto compatible devices.
Publish only after the current release, compatibility metadata, product description, license URL, EULA URL, icon, images, and base price are ready for provider review.
API Equivalent
POST /marketplace/developers/marketplace-items/{id}/publish
Authorization: Bearer {developer_access_token}
Publishing is idempotent. If the item is already published, the endpoint succeeds without creating another version.
POST /marketplace/developers/marketplace-items/{id}/visibility
Authorization: Bearer {developer_access_token}
Content-Type: application/json
{
"visible": true
}