Author and publish a PlayFab Economy v2 catalog item through the Draft state before it becomes visible in the public catalog
domain: learn.microsoft.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Call CreateDraftItem to author a new catalog item; while in Draft state, the item is visible only to its creator, catalog admins, and title entities — not to players.
Use UpdateDraftItem to iterate on metadata, tags, content, and pricing while the item stays unpublished.
Set a valid start (and optional end) date pair and transition the item to Published so it becomes visible to players via SearchItems and GetItem.
Assign players to the Catalog reviewers role if you want community ratings/reviews collected via the ReviewItem API once the item is public.
Use Economy v2's catalog config settings to control review/moderation policy for who can author or approve items for your title.
Known gotchas
Draft items are invisible to normal players and to SearchItems even with a direct GetItem call unless the caller is the creator, a catalog admin, or a title entity — don't mistake this for a bug during testing.
ReviewItem only works on items that are already Published and visible in the public catalog; you can't collect reviews on drafts.
Skipping the Draft step and publishing directly can bypass your studio's intended moderation workflow — enforce Draft-first creation via your title's catalog config/permissions rather than convention alone.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?