> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Economy Pricing Meters

> Understand PlayFab Economy Catalog billable meters, what actions they measure, and how catalog usage translates into charges on your PlayFab bill.

# Catalog Pricing Meters

PlayFab Economy V2 Catalog APIs have two categories of consumption-based meters - Requests and Storage. This page outlines and defines those meters, including how it's measured and calculated. For more information on PlayFab's pricing model, see the [PlayFab pricing overview](/services/playfab/pricing/pricing-overview).

<Note>
  General usage of PlayFab Economy V2 may contribute toward other PlayFab meters, like PlayStream Events.
</Note>

## Requests

The request meters are determined by the response size of any UGC API calls or CDN requests. For each of the three PlayFab plans, there are five different rates, depending on the size:

<img src="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/services/playfab/pricing/pricingV2-media/ugc-pricing-requests.png?fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=e8e7d1f9cf171d3af9da7177dc1df98e" alt="UGC Requests Pricing" width="955" height="576" data-path="images/services/playfab/pricing/pricingV2-media/ugc-pricing-requests.png" />

<Note>
  Please contact us if you are planning on storing content larger than 100 MBs.
</Note>

## Storage

The storage meter is determined by the total size of all content (both files and images). 5 GB is included in all pricing plans. For more storage, there are three different rates for this meter depending on the plan.

<img src="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/services/playfab/pricing/pricingV2-media/ugc-pricing-storage.png?fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=c3bc65ca518e4e1c5387dd068da37caa" alt="UGC Storage Pricing" width="912" height="205" data-path="images/services/playfab/pricing/pricingV2-media/ugc-pricing-storage.png" />

The meter includes content associated with items that haven't been published, and items that aren't visible via the public catalog. For more information on how items can be hidden from the public catalog, see [Catalog Item Status](/services/playfab/economy-monetization/economy-v2/catalog/item-status).

## Included Meters

There's a set of included meters for all PlayFab customers, regardless of the selected plan:

| Meter               | Included Amount |
| ------------------- | :-------------: |
| Up to 1 MB Requests |  150k requests  |
| Storage             |       5 GB      |

<Note>
  Studios in Development Mode are required to enter payment information before enabling UGC, and overages will be charged based on the rates described.
</Note>

## Example Bill

Let's walk through an example customer's Catalog usage and look at their monthly bill. This example title is on the *Pay-as-you-go* plan. Let's start with a single user. This user goes to the content discovery page and searches for 'dinosaurs'. 10 results are displayed to the user, each with a title and thumbnail image. The user selects a piece of content, which displays the full metadata, including the description, ratings, and four more images. The user decides the content looks interesting enough, so they select the download button.

Now let's see what meter consumption this scenario just drove:

* This user goes to the content discovery page and searches for 'dinosaurs'. 10 results are displayed to the user, each with a title and thumbnail image.
  * The `SearchItems` call returned 10 items with the base metadata, resulting in a single "**Up to 1 MB Request**".
  * Each of the 10 thumbnails is requested from the CDN. Let's pretend five are just under 1 MB, and five are just over 1 MB. This scenario results in five "**Up to 1 MB Requests**" and four "**Up to 5 MBs Requests**".
* The user selects a piece of content, which displays the full metadata, including the description, ratings, and four more images.
  * The `GetItem` call returned a single item with the full metadata, resulting in a single **Up to 1 MB Request**
  * The `GetRatings` call returned a single item's ratings, resulting in a single **Up to 1 MB Request**
  * Each of the four images is requested from the CDN. As higher quality images, two images are *under* 5 MBs and two images are *over* 5 MBs. This scenario results in two "**Up to 5 MBs Requests**" and two "**Up to 25 MBs Requests**".
* The user decides the content looks interesting enough, so they select the download button.
  * Content is requested from the CDN. As a large piece of content it's 20 MBs. This scenario results in a single **Up to 25 MBs Requests**.

| Meter         | Request Count |
| ------------- | ------------- |
| Up to 1 MB    | 8             |
| Up to 5 MBs   | 7             |
| Up to 25 MBs  | 3             |
| Up to 50 MBs  | 0             |
| Up to 100 MBs | 0             |

Next, this title has 10,000 users that perform this scenario once a day in a 30-day month (300,000 times) - roughly the same as a single user performing on average once every 9 seconds. This scenario would result in the following meter consumption:

| Meter         | Request Count |
| ------------- | ------------- |
| Up to 1 MB    | 2.4 million   |
| Up to 5 MBs   | 2.1 million   |
| Up to 25 MBs  | 0.9 million   |
| Up to 50 MBs  | 0             |
| Up to 100 MBs | 0             |

If a title is the only title using UGC in the studio, and the title has 4 GB of UGC stored (which is fully covered by the 5 GB included, so no charges are incurred on the **Storage** meter) at the end of the month, here's what the final UGC bill would look like:

<img src="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/services/playfab/pricing/pricingV2-media/ugc-sample-monthly-bill.png?fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=fddbf962aa0ba9404fd9ed9e7474a10b" alt="Sample Bill" width="1200" height="401" data-path="images/services/playfab/pricing/pricingV2-media/ugc-sample-monthly-bill.png" />

## Resources

* For the most up-to-date view of prices per meter, see [PlayFab pricing](https://playfab.com/pricing/)
* See [Consumption Best Practices](/services/playfab/pricing/consumption-best-practices) to learn how to maintain the lowest rate of meter usage and cost for your game

## Relevant APIs

The following APIs cause the Economy Catalog meter to increment:

* [CreateDraftItem](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/create-draft-item)
* [CreateUploadUrls](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/create-upload-urls)
* [DeleteEntityItemReviews](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/delete-entity-item-reviews)
* [DeleteItem](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/delete-item)
* [GetCatalogConfig](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/get-catalog-config)
* [GetDraftItem](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/get-draft-item)
* [GetEntityDraftItems](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/get-entity-draft-items)
* [GetEntityItemReview](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/get-entity-item-review)
* [GetItem](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/get-item)
* [GetItemModerationState](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/get-item-moderation-state)
* [GetItemPublishStatus](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/get-item-publish-status)
* [GetItemReviews](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/get-item-reviews)
* [GetItemReviewSummary](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/get-item-review-summary)
* [GetItems](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/get-items)
* [PublishDraftItem](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/publish-draft-item)
* [ReportItem](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/report-item)
* [ReportItemReview](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/report-item-review)
* [ReviewItem](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/review-item)
* [SearchItems](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/search-items)
* [SetItemModerationState](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/set-item-moderation-state)
* [SubmitItemReviewVote](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/submit-item-review-vote)
* [TakedownItemReviews](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/takedown-item-reviews)
* [UpdateCatalogConfig](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/update-catalog-config)
* [UpdateDraftItem](https://learn.microsoft.com/en-us/rest/api/services/playfab/economy/catalog/update-draft-item)

<Note>
  Any calls to the CDN will also cause Economy Catalog meters to increment
</Note>


## Related topics

- [Inventory Writes Meter API Description](/services/playfab/pricing/meters/economy-writes.md)
- [Inventory Reads Meter API Description](/services/playfab/pricing/meters/economy-reads.md)
- [Statistics Meters](/services/playfab/pricing/meters/statistics-meters.md)
- [Leaderboards Meters](/services/playfab/pricing/meters/leaderboard-meters.md)
- [PlayFab Economy v2 documentation](/services/playfab/economy-monetization/index.md)