> For the complete documentation index, see [llms.txt](https://arivia.rlib.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://arivia.rlib.io/v2.x/faq/add-custom-descriptions.md).

# Add Custom Descriptions

## ▸Enable Custom Descriptions

* Open **`lua\arivia\sh\cfg\sh_cfg_entities.lua`**
* Change **`cfg.ent.bAllowCustomDesc`** to **`true`**

####

## ▸Create Custom Descriptions

* Open **`lua\arivia\sh\cfg\sh_cfg_entities.lua`**
* Connect to your gmod server
* Open the **Q** menu (spawn menu / gmod menu)
* Locate the entity you wish to add a custom description to
* Right click on the entity / weapon and select "**Copy to Clipboard**".

![](/files/-MUByIg4z157yjcka_z8)

* Create a new line within the file **`lua\arivia\sh\cfg\sh_cfg_entities.lua`**

```lua
cfg.ent.desc[ 'entity_name' ] = 'Your description'
```

* Save the file and go back to gmod.
* If the edited item is selected already; select something else and then re-select your edited item so that the data refreshes.

####

## ▸Important Notes

**`[1]`** Ensure that any entity / weapon you add to the descriptions config file is inserted with the following structure:

* Remove any S P A C E S and replace them with underscores ( **`_`** )
* No capital letters

By default; garry's mod should do this automatically when you select "**Copy to Clipboard**", but there have been rare cases where certain custom entities include spaces.

**`[2]`** If for some reason your custom descriptions do not take effect; try reconnecting to the server OR enable ***regeneration mode*** by opening **`lua\arivia\sh\cfg\sh_cfg_dev.lua`** and setting:

{% tabs %}
{% tab title="lua\arivia\sh\cfg\sh\_cfg\_dev.lua" %}

```lua
cfg.dev.regeneration        = true
```

{% endtab %}
{% endtabs %}

Turn this OFF once you are done editing your descriptions.