# Custom Variables

## What Are Custom Variables?

Custom Variables allow you to collect additional input from customers at checkout. This can include:

* Dropdown selections (e.g. server region, item color)
* Text input (e.g. username, tag)
* Numeric input (e.g. levels, amounts)

These values can be used dynamically in your product commands and templates, giving you much more flexibility without needing separate products.

***

## Creating a Custom Variable

To get started:

1. Navigate to the **Custom Variables** tab in your dashboard.
2. Click the **New custom variable** button.

You’ll be prompted to enter the following:

* **Name**: Displayed to customers.
* **Identifier**: Used in commands as `{identifier}`.
* **Description** *(optional)*: Appears under the input on the product page.
* **Type**: Choose between:
  * **Dropdown** – Add multiple options, each with optional extra cost.
  * **Text** – Freeform input. Supports regex validation.
  * **Number** – Numeric input. Also supports regex validation.

***

#### Example Usage in Command

Let’s say you’ve added the following custom variables:

* `{kit}` (Dropdown – e.g. bronze, silver, gold)
* `{name}` (Text – e.g. “Lord”)
* `{slots}` (Number – e.g. 6)

You can reference these in your command like so:

```bash
oxide.usergroup add {customer.steam.id} {kit}
say "{customer.name} just purchased the {kit} package!"
o.grant user {customer.steam.id} backpacks.size.{slots}
```

If the customer selects:

* **Kit**: `gold`
* **Name**: `Lord`
* **Slots**: `6`

Your executed commands will be:

```bash
oxide.usergroup add 7656119XXXXXXXXXXX gold
say "Lord just purchased the gold package!"
o.grant user 7656119XXXXXXXXXXX backpacks.size.6
```

This setup is ideal for selling VIP ranks, timed perks, or custom packages in Rust stores.

***

### Pricing Options (Dropdown Only)

For **dropdown** variables, you can define:

* **Name/Value**: Shown to the customer and used in commands.
* **Pricing Type**: Fixed or Percentage.
* **Additional Cost**: Charge extra for certain options if needed.

***

## Notes

* These variables are optional. If not filled, they will not be injected.
* Regex validation helps ensure valid input for **Text** and **Number** types.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guides.paynow.gg/store/custom-variables.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.