> For the complete documentation index, see [llms.txt](https://docs.makerealms.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.makerealms.com/explore-features/import-files/balance-file-format.md).

# Balance File Format

## Example Format

Balance file format uses a comma separated value where you specify a discord username and a balance

```
discord_user_1,100
discord_user_2,0
discord_user_3,10
```

In this example we set balances on 3 users:

1. A user with the username `discord_user_1` set to a balance of 100 coins.
2. A user with the username `discord_user_2` set to a balance of 0 coins.
3. A user with the username `discord_user_3` set to a balance of 10 coins.

## Balance CSV Specification

User names can be specified as unique Discord names with or without a discriminator, or a Discord id as a number. When importing the file into balances, any names or ids not found will not be imported, and will generate a warning.  Any names not specified in the file will not have their balances changed (if they already have balances in the realm). 

Balances must be specified as number without a comma ",". Including commas in your numbers like "1,000" will cause issues with final balances.

| Column Name     | Function                                    | Column Type            | Required | Default |
| --------------- | ------------------------------------------- | ---------------------- | -------- | ------- |
| Discord Account | The account whos balance you want to update | Discord username or ID | True     | N/A     |
| New Balance     | The balance you want to set to              | Decimal number         | True     | N/A     |