> For the complete documentation index, see [llms.txt](https://utility-ape-docs.gitbook.io/ua-engagement-bot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://utility-ape-docs.gitbook.io/ua-engagement-bot/engagement-tools-setup/adding-store-items.md).

# Adding Store Items

Your store is the enticement for your community - This is why they are actively doing quests and engaging in the server to earn those coins/tokens.

Adding store items - you will need to go to your <mark style="color:green;">#bot-commands</mark> channel and type `.ah` to bring up the admin panel. Then you will see:\
\
**Admin Store Commands**\
`.add-item` - Add a new item to the server store\
`.delete-item` - Delete an existing store item\
`.edit-item` - Edit an existing store item (description, stock, price, role)\
`.store-ui` - Set up a full Store front-end with button navigation\
`.store-sales` - Set a storefront sales tracking channel

To add your first item you will type `.add-item` or `.ai` and you'll be presented with the explanation on how to add the item.

<div align="left"><figure><img src="https://45384882-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWzP6DlWzbPBZHhSwoPx3%2Fuploads%2F0M986uQqk0hxPab9QHHM%2Fai.PNG?alt=media&amp;token=65093a75-a290-4c64-b57a-45eb468ea421" alt=""><figcaption></figcaption></figure></div>

When a store item is purchased the user will receive a <mark style="color:orange;">ROLE</mark> that was assigned to that item. This means you will need to create a <mark style="color:orange;">ROLE</mark> for each item you have in your store. A user that purchases an item will then receive that <mark style="color:orange;">ROLE</mark> and their balance will be deducted for the price they spent on the item.

That user will then need to create a <mark style="color:green;">ticket</mark> or contact your staff to claim the item they purchased. This is so you can manually check their engagement to make sure they've legitimately farmed these coins vs using a bot to auto send the same message 500 times.\
\
If you approve their purchase then you can manually <mark style="color:green;">send</mark> them the item they've purchased and then <mark style="color:red;">remove</mark> their newly assigned role.

1. To add an item to the store you will type `.ai "ITEM NAME" @ROLE_NAME <price>`\
   In the example below I added 1 Solana to the store and I created a role called 1 Solana and I priced it at 120,000 Coins.\
   \
   I then edited the item with `.ei` and I added a **stock** to 5. So once 5 of these are purchased it will state 'Out of Stock' on the store page.

<div align="left"><figure><img src="https://45384882-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWzP6DlWzbPBZHhSwoPx3%2Fuploads%2FsYJl7kCSL7m5GgvziF1w%2Fadd%20and%20edit%20store%20item.PNG?alt=media&amp;token=4188fa2f-ddac-47b5-94a7-0b06d80aa440" alt=""><figcaption><p>Editing an item is optional, for many items you will want unlimited stock, so you won't need to edit them.</p></figcaption></figure></div>

If you have a lower budget you can add free items in the store like unique server roles or really cheap NFTs or NFTs from your own project.\
\
In the example below I added a new store item called 'Rainbow Role' that costs 10,000 coins and when purchased a user will instantly be given the 🌈<mark style="color:purple;">Rainbow Role</mark>🌈, while it has no immediate value, maybe I give these members access to a special channel in the server later on.<br>

<div align="left"><figure><img src="https://45384882-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWzP6DlWzbPBZHhSwoPx3%2Fuploads%2FGssKdO6VzW0HjZAbODLh%2Frainbow%20role.PNG?alt=media&amp;token=dc401cb0-ef3d-420a-98b5-07b2aa6168dd" alt=""><figcaption></figcaption></figure></div>

You can edit the item and add a description - if you're unsure of what the value an item will have, add a <mark style="color:blue;">m</mark><mark style="color:green;">y</mark><mark style="color:blue;"><mark style="color:purple;">st<mark style="color:purple;"></mark><mark style="color:blue;"><mark style="color:orange;">er<mark style="color:orange;"></mark><mark style="color:blue;"><mark style="color:red;">io<mark style="color:red;"></mark><mark style="color:blue;"><mark style="color:yellow;">us<mark style="color:yellow;"></mark> description.

<figure><img src="https://45384882-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWzP6DlWzbPBZHhSwoPx3%2Fuploads%2F1xZNN2CmfqgcF2o39QkG%2Fedit%20rainbow%20role.PNG?alt=media&amp;token=f717459e-875d-41c4-8bd7-3a5c6ff3718f" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
*Note: We recommend you populate your store with at least 6 items to start. Add a couple NFTs, whitelist spots, unique roles, crypto, etc...*
{% endhint %}
