> For the complete documentation index, see [llms.txt](https://vebjorn-elvekrok.gitbook.io/villager-market/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://vebjorn-elvekrok.gitbook.io/villager-market/edit-shop/shop-front.md).

# Manage your shop

## Open the shopfront

To edit your shopfront right click on your VillagerShop and click on the "edit shopfront" item (**written book**):

![](/files/yGU0NTX2Dn1hqxrBkXCL)

## Preview

You can also preview your shop front. To preview your shop, open your Villager Shop and click on the preview shop item (**normal book**):

![](/files/-MK0gdUsQjmVDIHH1WUX)

The preview menu is the exact same menu your customers will see when they open your Villager Shop, but you won't be able to sell or buy items from yourself.

{% hint style="info" %}
Click on the book to show item details (item specific lore etc.)
{% endhint %}

## Adding items

To add an item to your Shop Front, simply place the item you want to add from your inventory into the shopfront menu. The menu will close and you will be prompted to type the amount (1-64) you want to sell/buy in the chat.

After hitting enter, you'll have to type the price you want to sell/buy the item for in the chat. This can be any decimal number above 0.

{% hint style="info" %}
You can always type `cancel`to abort the setup process
{% endhint %}

## Removing items

To remove an item from your shopfront, open the item editor and click "remove item" (**barrier**) at the bottom

## Editing items

To open the item editor, simply click on the item in your shopfront you want to edit.

![](/files/qafpqgUTr4qGAMf1teHI)

### Cycle modes

As default, the items you add to your shopfront will be in sell mode. This means customers will be able to buy items from your storage. If you want the customers to be able to sell items to you, you can cycle between selling/buying by clicking "cycle mode" (**sign**) in the item editor.

{% hint style="info" %}
All items your customers sell to you end up in your storage if you're using a PlayerShop
{% endhint %}

### Change amount and price

If you want to change amount or price for an item, this can be edited by clicking the "amount" (**chest**) or "price" (**gold ingot**) items in the editor.

### Trade items

If you don't want to sell or buy items for money, you can choose to trade items instead. You can do this by clicking the gold bar in the item editor *with* the item you want to trade for. The gold bar will then be replaced with the item you chose (including the amount). You can reset this by simply clicking the item in the item editor.

### Set buy limit

{% hint style="info" %}
This is for [Player Shops](/villager-market/shop-types/player-shop.md) only! .

You can however set a "[per-player/server-wide limit](/villager-market/shop-types/admin-shop.md#per-player-limit)" for Admin Shops
{% endhint %}

You can also specify the maximum amount of an item you want to buy as the shop owner. To do this, be sure to set the item mode to `BUY` and then click the "buy limit" item (**feather**). You will be prompted to type an amount in the chat.

{% hint style="info" %}
**Example:** You want to buy dirt from other players. You add dirt to your shop front and set the mode to `BUY`. But you don't want to by an unreasonable amount of dirt, so you set the buy limit to 20. From now on, every time a player attempts to sell dirt to you, the shop will check if the dirt in your storage will exceed 20. And only if it not, the player is able to sell you dirt.
{% endhint %}

To learn more about how this affects the amount left you can buy, see [amount left to buy](/villager-market/shop-types/player-shop.md#amount-left-to-buy)!

### Set discounts

With VillagerMarket you can also set discounts. To set a discount, simply click on the discount item in the item editor. You will then be prompted to type in a valid discount amount (%) and a duration for the discount.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://vebjorn-elvekrok.gitbook.io/villager-market/edit-shop/shop-front.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.