> ## 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.

# 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.
</Note>

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.

<img src="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" alt="Navigate to Player Custom Properties" width="1248" height="1100" data-path="images/playfab/data-analytics/acting-data/navigate-to-custom-properties.png" />

### 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**

<img src="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" alt="Create new Player Custom Properties" width="950" height="375" data-path="images/playfab/data-analytics/acting-data/create-new-custom-property.png" />

### 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**.

<img src="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" alt="Remove Player Custom Properties" width="950" height="375" data-path="images/playfab/data-analytics/acting-data/remove-custom-property.png" />

<img src="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" alt="Remove Player Custom Properties result" width="950" height="375" data-path="images/playfab/data-analytics/acting-data/remove-custom-property-result.png" />

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**.

<img src="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" alt="Modify Player Custom Properties" width="950" height="375" data-path="images/playfab/data-analytics/acting-data/modify-custom-property.png" />

<img src="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" alt="Modify Player Custom Properties result" width="950" height="375" data-path="images/playfab/data-analytics/acting-data/modify-custom-property-result.png" />

## 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.
</Note>

* 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**.

<img src="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" alt="Create and modify Player Custom Properties with PlayStream rules" width="726" height="381" data-path="images/playfab/data-analytics/acting-data/custom-properties-with-playstream-rules.png" />

<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.
</Note>


## Related topics

- [Player Custom Properties](/services/playfab/live-service-management/game-configuration/segmentation/player-custom-properties.md)
- [player_custom_properties_changed](/services/playfab/api-references/events/PlayerIdentity/player-custom-properties-changed.md)
- [Advanced Segmentation with Player Custom Properties](/services/playfab/live-service-management/game-configuration/segmentation/advanced-segmentation.md)
- [PlayerCustomPropertiesChangedDetails data type](/services/playfab/api-references/events/data-types/playercustompropertieschangeddetails.md)
- [Photon Quickstart](/services/playfab/live-service-management/service-gateway/add-ons/photon/quickstart.md)