Training
Learning path
Use advance techniques in canvas apps to perform custom updates and optimization - Training
Use advance techniques in canvas apps to perform custom updates and optimization
This browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
Important
Economy v2 is now Generally Available. For support and feedback, go to the PlayFab Forum.
The purpose of this guide is to detail the limits that are enforced when creating, updating, and reading from your catalog of items and adding, updating, and removing them from player inventories. It now includes the most updated limits as per Economy (V2).
Note
All APIs are counted separately from one another.
API | Limit (Player) | Limit (Title) |
---|---|---|
GetItem | 1.67 rps (100 in 60 seconds) | 1000 rps (10000 in 10 seconds) |
GetItems | 1.67 rps (100 in 60 seconds) | 1000 rps (10000 in 10 seconds) |
SearchItems | 1.67 rps (100 in 60 seconds) | 1000 rps (10000 in 10 seconds) |
GetItemReviews | 1.67 rps (100 in 60 seconds) | 1000 rps (10000 in 10 seconds) |
GetItemReviewsSummary | 1.67 rps (100 in 60 seconds) | 1000 rps (10000 in 10 seconds) |
GetEntityItemReview | 1.67 rps (100 in 60 seconds) | 1000 rps (10000 in 10 seconds) |
GetItemModerationState | - | 1000 rps (10000 in 10 seconds) |
API | Limit (Player) | Limit (Title) |
---|---|---|
CreateDraftItem | 0.33 rps (10 in 30 seconds) | 100 rps (1000 in 10 seconds) |
CreateUploadUrls | 0.33 rps (10 in 30 seconds) | 100 rps (1000 in 10 seconds) |
DeleteEntityItemReviews | - | 100 rps (1000 in 10 seconds) |
DeleteItem | 0.33 rps (10 in 30 seconds) | 100 rps (1000 in 10 seconds) |
GetDraftItem | 0.33 rps (10 in 30 seconds) | 100 rps (1000 in 10 seconds) |
GetDraftItems | 0.33 rps (10 in 30 seconds) | 100 rps (1000 in 10 seconds) |
GetEntityDraftItems | 0.33 rps (10 in 30 seconds) | 100 rps (1000 in 10 seconds) |
GetItemPublishStatus | 0.33 rps (10 in 30 seconds) | 100 rps (1000 in 10 seconds) |
PublishDraftItem | 0.33 rps (10 in 30 seconds) | 100 rps (1000 in 10 seconds) |
ReportItem | 0.33 rps (10 in 30 seconds) | 100 rps (1000 in 10 seconds) |
ReportItemReview | 0.33 rps (10 in 30 seconds) | 100 rps (1000 in 10 seconds) |
ReviewItem | 0.33 rps (10 in 30 seconds) | 100 rps (1000 in 10 seconds) |
SetItemModerationState | - | 100 rps (1000 in 10 seconds) |
SubmitItemReviewVote | 0.33 rps (10 in 30 seconds) | 100 rps (1000 in 10 seconds) |
TakedownItemReviews | - | 100 rps (1000 in 10 seconds) |
UpdateDraftItem | 0.33 rps (10 in 30 seconds) | 100 rps (1000 in 10 seconds) |
Note
API | Limit (Player) | Limit (Title) |
---|---|---|
GetInventoryItems | 1.67 rps (100 in 60 seconds) | - |
GetInventoryCollectionIds | 1.67 rps (100 in 60 seconds) | - |
API | Limit (Player) | Limit (Title) |
---|---|---|
GetTransactionHistory | 0.1 rps (30 in 300 seconds) | - |
API | Limit (Player) | Limit (Title) |
---|---|---|
AddInventoryItems | 0.66 rps (60 in 90 seconds) | - |
SubtractInventoryItems | 0.66 rps (60 in 90 seconds) | - |
UpdateInventoryItems | 0.66 rps (60 in 90 seconds) | - |
PurchaseInventoryItems | 0.66 rps (60 in 90 seconds) | - |
TransferInventoryItems | 0.66 rps (60 in 90 seconds) | - |
DeleteInventoryItems | 0.66 rps (60 in 90 seconds) | - |
ExecuteInventoryOperations | 0.66 rps (60 in 90 seconds) | - |
DeleteInventoryCollection | 0.16 rps (15 in 90 seconds) | - |
API | Limit (Player) | Limit (Title) |
---|---|---|
RedeemAppleAppStoreInventoryItems | 0.66 rps (60 in 90 seconds) | - |
RedeemGooglePlayInventoryItems | 0.66 rps (60 in 90 seconds) | - |
RedeemMicrosoftStoreInventorItems | 0.66 rps (60 in 90 seconds) | - |
RedeemNintendoEShopInventoryItems | 0.66 rps (60 in 90 seconds) | - |
RedeemPlayStationStoreInventoryItems | 0.66 rps (60 in 90 seconds) | - |
RedeemSteamInventoryItems | 0.66 rps (60 in 90 seconds) | - |
The maximum file size allowed is 500MB.
Up to 100 images and 100 files can be added to an item.
Content blobs/URLs will be garbage collected after 24 hours if not attached to a draft or published item.
The following are the maximum number of items returned for the various APIs. You can use continuation tokens to paginate through results that return more than the limit.
SearchItems
- 50 Items per pageGetItems
- 50 Items per pageGetItemReviews
- 50 Items per pageGetItemContainers
- 50 Items per pageGetEntityDraftItems
- 50 Items per pageSearchItems
- 10 Items per pageGetItems
- 10 Items per pageGetItemReviews
- 10 Items per pageGetItemContainers
- 10 Items per pageGetDraftItems
- 10 Items per pageGetEntityDraftItems
- 10 Items per pageThe following are the maximum count of items returned for the various APIs. You can use continuation tokens to paginate through results that return greater than the limit.
API | Limit with response compression | Limit without response compression |
---|---|---|
GetInventoryItems | 250 Items | 50 Items |
GetInventoryCollectionIds | 250 Items | 50 Items |
GetTransactionHistory | 250 Items | 50 Items |
GetInventoryItems
- 10 Items per pageGetInventoryCollectionIds
- 10 Items per pageGetTransactionHistory
- 10 Items per pageThere are checks enforced to prevent the use of overly complicated Filter
queries used in SearchItems
calls. More information can be found here.
Up to 20GB of catalog data are allowed per Catalog creator entity. This limit is most likely to be encountered for Catalog Items created by the Title entity.
Tiles have a 512 character limit per country code.
Descriptions have a 10000 character limit per country code.
Keywords have a 50 character limit per keyword and up to 32 keywords can be added per country code.
The Display Properties field has a 10000 byte limit.
Tags have a 32 character limit per tag. Titles can have a maximum of 1024 Tags and up to 32 Tags can be added to an item
Content Types have a 32 character limit per content type. Titles can have a maximum of 128 Content Types.
The price options list has a length limit of 15 price options.
The amounts list has a length limit of 15 amounts.
The unit duration has a limit of 100 years (3,155,695,200 seconds).
Each alternate ID has a value length limit of 100 characters.
The list length of alternate IDs has a limit of 15 alternate IDs.
The display version field has a value length limit of 50 characters.
The client version has a 3 segment limit, with each segment allowing a maximum value of 65535.
For example: "1.65535.234".
The ItemReferences field has a limit of 250 items.
The list for admin entities has a 64 entity limit.
The list for admin entities has a 128 entity limit.
The max number of deep links is of 10 links.
There's a limit of 5 values per each display property type.
The list of content types has a limit of 128 types, each with a max length of 40 characters.
The list of platforms has a limit of 128 platforms, each with a max length of 40 characters.
The list of tags has a limit of 1024 tags, each with a max length of 32 characters.
The max number of inventory operations to be executed is of 50 operations.
The max number of items to be modified is 300 items.
(for example, you can add one full bundle and up to 50 other items)
The max collection size is 10000 items.
The length limit for the collection list is 1000 collections per entity.
The character limit for a collection's name is 75 characters.
The max date range for the transaction history is 4 years.
The default date range is of six months.
The display properties field has a 1000 byte limit.
Training
Learning path
Use advance techniques in canvas apps to perform custom updates and optimization - Training
Use advance techniques in canvas apps to perform custom updates and optimization