# Shop Layouts

Layout system allows you to create fully customizable **GUI configurations** for your shops.

- **Use the same layout** configuration for multiple shops and display shop info using the internal [Shop Placeholders](/internal-placeholders/).
- **Create unique layout** configurations for your shops with different GUI type, size and decorations.
- **Set per page layout** configurations for your shops, where certain shop pages has a completely different layout.

Layout configuration files located in the `/virtual_shop/layouts/` directory.

!!!warning Note
If layout of a specific shop page is invalid, the **default shop layout** will be used.

If the **default shop layout** is invalid, the `Default_Layout` from the `settings.yml` will be used.

If the `Default_Layout` is also invalid, the shop will be unusable until fixed.
!!!

!!!
If you don't see the next/previous page buttons in your shop, make sure you have them added in the layout config.
!!!

## Setup

To create a new layout, duplicate an existing one, rename and edit it by your preferences. There is a configuration guide inside the layout file.

### Assign Layout

1. Open the editor: `/vshop editor`
2. Click the desired shop.
3. Click the **Layouts** button.

Use the **Default Layout** button to set primary shop layout configuration.

Use the **Page Layout** buttons to assign layout to specific shop page(s) only.

### Placeholders

You can use the following placeholders inside layout configurations:

- `%page%` - Displays current shop page.
- `%pages%` - Displays number of shop pages.
- `%balance%` - Displays player's balance of the [default currency](/features/multi-currency/#configuration).
- `%sell_multiplier%` - Displays player's [Sell Multiplier](/virtual/sell-multipliers/).
- Internal [Shop Placeholders](/internal-placeholders/).