Product delivery
Store permissions and tags
Restrict who sees and edits a product, and label products for browsing.
Store permissions
By default a product has no store permissions. Then anyone with product:read can see it and anyone with product:install can install it, but only its creator (or a realm administrator) can publish versions, change channels, export or delete it. This stops someone else from pushing a version into installs that upgrade automatically.
Open More > Permissions on a product card to share it with named people:
| Role | Lets them |
|---|---|
| Viewer | See and install the product. |
| Editor | Also publish versions and change it. |
| Owner | Also manage permissions, export and delete it. |
Once a product has grants, people without one no longer see it in the list and cannot open, install or change it, and editors and owners can publish alongside the creator. Realm administrators keep access.
Only the creator of a product, or a realm administrator, can restrict it the first time. The list must keep at least one owner, and you cannot remove your own owner role. Remove restriction returns the product to platform roles only.
Store tags
Tags help people find products. They are grouped in categories; names are unique within the store (categories) and within a category (tags).
- Manage tags in the Products toolbar creates, renames and deletes categories and tags.
- Tags are assigned per version, in the New version dialog. A card shows the tags of its latest version.
- The tag filter in the toolbar shows only products with that tag.
Deleting a tag or a category is permanent: it is removed from every version that carried it.
API
| Method | Path | Requires |
|---|---|---|
| GET, PUT | /api/v2/products/{id}/permissions | product:read / product:write |
| GET | /api/v2/products/tags | product:read |
| POST | /api/v2/products/tags/categories | product:write |
| POST | /api/v2/products/tags/categories/{id}/tags | product:write |
| PATCH, DELETE | /api/v2/products/tags/{id} | product:write |