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

# Metadata Actions

> Manage custom player meta-data values.

Metadata actions allow you to store and remove key-value pairs on players. This is useful for tracking custom statistics, preferences, or temporary states that LuckPerms can store persistently.

## Available Actions

| Action ID           | Description                          |
| :------------------ | :----------------------------------- |
| `set_meta_action`   | Sets a meta key to a specific value. |
| `unset_meta_action` | Removes a meta key from the player.  |

## Configuration

<ResponseField name="key" type="Var<String>" required>
  The name of the meta key.
</ResponseField>

<ResponseField name="value" type="Var<String>">
  The value to set (only for `set_meta_action`).
</ResponseField>

## Example Usage

<CodeGroup>
  ```yaml Set Preference theme={null}
  # Set a custom meta tag for the player
  set_meta_action:
    key: "voted_today"
    value: "true"
  ```

  ```yaml Clear Tag theme={null}
  # Removes the metadata
  unset_meta_action:
    key: "voted_today"
  ```
</CodeGroup>