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

# Player Custom Properties Quickstart

> Create, modify, and delete PlayFab Player Custom Properties in Game Manager and via the UpdatePlayerCustomProperties API on title_player_account entities.

> [!NOTE]
>
> The Player Custom Properties feature is in public preview. While the core functionality is in place, we’re refining the experience based on feedback and usage patterns.

To get started using Player Custom Properties, follow the guides here.

## Creating, modifying, deleting Player Custom Properties in Game Manager

Sign in to [Game Manager](https://developer.playfab.com).

* Go to the **Players** page and select a player.
* Select the **Player Data** tab.
* Select the **Custom** subtab.

![Navigate to Player Custom Properties](https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/navigate-to-custom-properties.png?fit=max\&auto=format\&n=IwSYTY5BEqd_x-HK\&q=85\&s=3c435e7318840d0aa58d8bdc062371fb)

### Create a new custom property:

* Select **Add**.
* Fill the **Key** and **Value** fields.
* Select the custom property **Type** from the dropdown.
* Notice the **New** label at the bottom increase by the number of custom properties you add.
* Select **Save player data**

![Create new Player Custom Properties](https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/create-new-custom-property.png?fit=max\&auto=format\&n=IwSYTY5BEqd_x-HK\&q=85\&s=78abd82d2114ef5eb5c536832f42180f)

### Remove a custom property:

* Select the **Trash can** on the left side of the custom property.
* Notice the **Removed** label at the bottom increase by the number of custom properties you remove.
* Select **Save player data**.

![Remove Player Custom Properties](https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/remove-custom-property.png?fit=max\&auto=format\&n=IwSYTY5BEqd_x-HK\&q=85\&s=883b09a703986fb3026f9739fdc22f99)

![Remove Player Custom Properties result](https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/remove-custom-property-result.png?fit=max\&auto=format\&n=IwSYTY5BEqd_x-HK\&q=85\&s=7bd397fd042746ad73728c12c8427ff8)

To modify a custom property:

* Select **Key** and **Value** fields and change the values in them.
* Notice the **Changed** label at the bottom increase by the number of custom properties you modify.
* Select **Save player data**.

![Modify Player Custom Properties](https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/modify-custom-property.png?fit=max\&auto=format\&n=IwSYTY5BEqd_x-HK\&q=85\&s=c5e61d47fe847f6c5a92631e30b0bef8)

![Modify Player Custom Properties result](https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/modify-custom-property-result.png?fit=max\&auto=format\&n=IwSYTY5BEqd_x-HK\&q=85\&s=7f7b75304a2a06ebe408f695b6c1f807)

## Creating and modifying custom properties on a player via PlayStream Rules

> [!NOTE]
>
> V1 and V2 PlayStream events can be used to set or update custom properties.

* Sign in to [Game Manager](https://developer.playfab.com).
* Go to the **Automation** page and select the **Rules** tab.
* Select the **New rule** button on the top right of the page.
* Populate the **Name** and **Event** type text boxes. V1 events are prefixed with **com.playfab.** or **title.** whereas v2 events are prefixed with **playfab.** or **custom.**
* If desired, set any **Conditions** for triggering this rule based on the event's contents.
* To create a custom property, under **Actions** select **Adding custom property** and populate the fields.
* To modify a custom property, under **Actions** select **Update player custom properties**. The action accepts an expandable list of properties as shown below.
* Select **Save action**.

![Create and modify Player Custom Properties with PlayStream rules](https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/custom-properties-with-playstream-rules.png?fit=max\&auto=format\&n=IwSYTY5BEqd_x-HK\&q=85\&s=2e8e25751465ae49c593b1b512f9f20b)

> [!NOTE]
>
> If the event chosen for the rule is a standard event, you'll have a list of available properties to choose from. If the event is a custom event, then the input box will be an open text field.


## Related topics

- [Player Custom Properties](https://docs.xbox.com/services/playfab/live-service-management/game-configuration/segmentation/player-custom-properties.md)
- [Update Player Custom Properties](https://docs.xbox.com/services/playfab/api-references/rest/client/player-data-management/update-player-custom-properties.md)
- [Get Player Custom Property](https://docs.xbox.com/services/playfab/api-references/rest/server/player-data-management/get-player-custom-property.md)
