# Basic layout

### Basic configuration

![](https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4i6VN0FeNAgRFLwVM2Cr%2Fuploads%2F3SEerpBQrXE3J8L3gCxR%2Fdocs-en-config-theme-basic.png?alt=media\&token=6ca8abcb-eb29-4e7c-93be-1cdbc916ad5c)

#### Basic layout (1):&#x20;

&#x20;`Boxed` | `Full Width Boxed` | `Full Width Header` | `Full Width Header & Footer` | `Full Width`

The width of the layout is determined by the basic layout. **Full Width** stretches the web page with all content to the browsers viewport, while **Boxed** fixes the layout including backgrounds to the maximum layout width. **Full Width Boxed** on the other hand lets all backgrounds run to the browser viewport, but the content is oriented to the maximum layout width. **Full Width Header** sets only the header and its contents to the browser viewport. The remaining areas of the store behave as in Full Width Boxed.

#### Layout width (2)

Width of the shop container in pixels. In the basic layouts `Boxed`, `Full Width Boxed` und `Full Width Header` this value is used as the maximum width.

#### Header (mobile) (3):&#x20;

`Single-line header` |  `Multi-line header`

The header can be displayed in a single line on mobile devices. However, depending on the size and orientation of the logo, a multi-line display is more suitable.

Example:&#x20;

<figure><img src="https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4i6VN0FeNAgRFLwVM2Cr%2Fuploads%2FrOxIX8eRQ5q5h5j4Xbfh%2Fdocs-de-storefront-mobile-header-devices.jpg?alt=media&#x26;token=1a241873-f33c-4d1a-b040-90a530c2a349" alt=""><figcaption></figcaption></figure>

#### Header (3):&#x20;

`Single line header` | `Two-line Header` | `Multi-line Header`

Decide between three basic header appearances. Not every header setting suits you and your product categories.&#x20;

* The **single-line header** is particularly suitable for minimalist online stores, which have only a few top categories. The header looks minimal and clear.
* If you have a large number of main categories (approx. 6-8 pieces), the **two-line header** is probably rather the value of your choice. The categories have enough space here and offer your customer the necessary overview. In the two-line header, the top bar is removed as a separate line and integrated into the logo line.
* The **multi-line header** is also suitable whenever a large number of main categories are to be displayed. Unlike the two-line header, the top bar retains its normal display.

{% hint style="info" %}
Top bar display settings are restricted when a two-line header is selected, because the **Top bar** is integrated into the logo line and does not act as a standalone top bar.
{% endhint %}

#### Search (4)

Choose between the appearance as **Overlay search**, **Expandable search** or **Standard search**.

Examples:

![Overlay search](https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCG4xkoMVXEQllVF5R9%2F-MHWqW5cQ7ZzIj_FIK6i%2F-MHWqrXL2LgxP4YIGTpS%2Fdocs-front-header-suche-overlay.jpg?alt=media\&token=59d11f0f-6481-4d0d-9373-19d3d05ffc56)

![Expandable search](https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCG4xkoMVXEQllVF5R9%2F-MHWqW5cQ7ZzIj_FIK6i%2F-MHWqup6K4FwtZwjcLlU%2Fdocs-front-header-suche-collapse.jpg?alt=media\&token=a6865af8-fca3-46d1-a2a3-2c3447bc2889)

![Default search](https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCG4xkoMVXEQllVF5R9%2F-MHWqW5cQ7ZzIj_FIK6i%2F-MHWqxYcjAecozc_oUWt%2Fdocs-front-header-suche-standard.jpg?alt=media\&token=aaffe537-1181-42cb-8681-ac216f7f7870)

#### Top bar (5)

`Default` | `Expandable` | `Collapsible` | `Offcanvas` | `Hidden`

{% hint style="info" %}
Top bar display settings are restricted when a two-line header is selected, because the **Top bar** is integrated into the logo line and does not act as a standalone top bar.
{% endhint %}

{% tabs %}
{% tab title="Default" %}
The default view of the Top bar. Permanently visible.

![](https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCG4xkoMVXEQllVF5R9%2F-MbeiO3FkrgTFIY4g5Et%2F-Mben-aLniFkDsVJqneg%2Fstorefront-top-bar-default.png?alt=media\&token=98d6b46f-0242-4854-a684-2e85dea4ecbb)
{% endtab %}

{% tab title="Expandable" %}
Top bar collapsed when the page is initially loaded. Can be folded out via menu button.

![](https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCG4xkoMVXEQllVF5R9%2F-MbeiO3FkrgTFIY4g5Et%2F-MbemvzD-PsfVdcoJ4TE%2Fstorefront-top-bar-expandable.png?alt=media\&token=fbfbce7d-482e-488b-bde5-a4042d8b2abc)
{% endtab %}

{% tab title="Collapsible" %}
Top bar folds out when the page is initially loaded. Can be collapsed via menu button.

![](https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCG4xkoMVXEQllVF5R9%2F-MbeiO3FkrgTFIY4g5Et%2F-MbenBF_CmTO6irVCa6v%2Fstorefront-top-bar-collapsible.png?alt=media\&token=4ece4b16-699f-4ef3-9b25-76cd01b4378d)
{% endtab %}

{% tab title="Offcanvas" %}
The top bar of the store can also be displayed as a so-called offcanvas element for a minimalist look. The contents of the top bar are then accessible via the familiar menu icon.

![](https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCG4xkoMVXEQllVF5R9%2F-MHWrp0c2fWtnNYFqKYj%2F-MHWrr3g2oRFnVoanEbq%2Fdocs-front-header-topbar-offcanvas.jpg?alt=media\&token=6cc5acbe-a11a-4d8a-9a45-53c1f694769e)
{% endtab %}

{% tab title="Hidden" %}
This option hides the Top Bar.

{% hint style="warning" %}
Only possible if no additional languages, currencies and marketing sliders are available - offcanvas top bar is shown as fallback.
{% endhint %}
{% endtab %}
{% endtabs %}

#### Icon Set (6)

The theme provides several additional icon sets to the [default icon set](https://component-library.shopware.com/icons/) for the storefront. Among other things, the icons for account, search, shopping cart, notepad and much more are exchanged..

Entypo Icons (solid):

<figure><img src="https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4i6VN0FeNAgRFLwVM2Cr%2Fuploads%2F2C8Ci8brL8fNYp0S9zWT%2Fdocs-de-config-theme-iconset-entypo.png?alt=media&#x26;token=76311847-5f65-4071-bff1-722c63e48c9d" alt=""><figcaption></figcaption></figure>

Feather Old Icons:

<figure><img src="https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4i6VN0FeNAgRFLwVM2Cr%2Fuploads%2FrhLnrgOdYNliNfXGj0Og%2Fdocs-de-config-theme-iconset-feather-old.png?alt=media&#x26;token=80f1b9af-5a7f-496a-8e3a-31888b7a5dcc" alt=""><figcaption></figcaption></figure>

Feather Icons:

<figure><img src="https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4i6VN0FeNAgRFLwVM2Cr%2Fuploads%2F59SjADS21q1zCgmknirM%2Fdocs-de-config-theme-iconset-feather.png?alt=media&#x26;token=f52395d8-b42b-41ec-80d7-d5f9b6db2e92" alt=""><figcaption></figcaption></figure>

Fluent (outlined):

<figure><img src="https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4i6VN0FeNAgRFLwVM2Cr%2Fuploads%2FM01xxVra7JEz9v3jyKQW%2Fdocs-de-config-theme-iconset-fluent-outline.png?alt=media&#x26;token=d0b54427-8be1-420f-a1cc-dec36782e249" alt=""><figcaption></figcaption></figure>

Fluent (solid):

<figure><img src="https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4i6VN0FeNAgRFLwVM2Cr%2Fuploads%2FtVBAIzh70LAzeGJpWW3z%2Fdocs-de-config-theme-iconset-fluent-solid.png?alt=media&#x26;token=07fdd482-4add-424d-97ed-211e55b3f01b" alt=""><figcaption></figcaption></figure>

Heroicons (outlined):

<figure><img src="https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4i6VN0FeNAgRFLwVM2Cr%2Fuploads%2F0rCpdKXWq8QJ3HuAraAd%2Fdocs-de-config-theme-iconset-heroicons-outline.png?alt=media&#x26;token=02604bc0-fb68-4e41-bf17-dd0a404780df" alt=""><figcaption></figcaption></figure>

Heroicons (solid):

<figure><img src="https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4i6VN0FeNAgRFLwVM2Cr%2Fuploads%2FMsNqodTFanKoQ7NPkH7L%2Fdocs-de-config-theme-iconset-heroicons-solid.png?alt=media&#x26;token=c7b93500-c736-403f-82ee-d4039ff4383b" alt=""><figcaption></figcaption></figure>

Iconic (outlined):

<figure><img src="https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4i6VN0FeNAgRFLwVM2Cr%2Fuploads%2FtUvIJg57lhQ5tDcCNZcz%2Fdocs-de-config-theme-iconset-iconic.png?alt=media&#x26;token=7acb9aec-65b2-4e6c-ab3c-a0f46281fbe7" alt=""><figcaption></figcaption></figure>

Iconly Broken:

<figure><img src="https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4i6VN0FeNAgRFLwVM2Cr%2Fuploads%2FSe3crmjuO8nYy7DibVhf%2Fdocs-de-config-theme-iconset-iconly-broken.png?alt=media&#x26;token=ef949a9b-ad5c-4b57-b1c6-09ef0411b0d9" alt=""><figcaption></figcaption></figure>

Iconly Bulk:

<figure><img src="https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4i6VN0FeNAgRFLwVM2Cr%2Fuploads%2FL8WHpF6aZVFmQbO3mqRW%2Fdocs-de-config-theme-iconset-iconly-bulk.png?alt=media&#x26;token=57d40484-cbd7-43d8-b1e8-7a23eb51ff0d" alt=""><figcaption></figcaption></figure>

Iconly Light:

<figure><img src="https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4i6VN0FeNAgRFLwVM2Cr%2Fuploads%2FIYkNUNERcxSXMdtYKfN6%2Fdocs-de-config-theme-iconset-iconly-light.png?alt=media&#x26;token=403a48d6-9e77-4bb9-935d-b7818ee2fcd0" alt=""><figcaption></figcaption></figure>

Ionicons (outline)

<figure><img src="https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4i6VN0FeNAgRFLwVM2Cr%2Fuploads%2FwF070C0Te7edhwWNvUIX%2Fdocs-de-config-theme-iconset-ionicons-outline.png?alt=media&#x26;token=fff1648c-afe1-4121-a4f2-1dad2763af7f" alt=""><figcaption></figcaption></figure>

Ionicons (solid):

<figure><img src="https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4i6VN0FeNAgRFLwVM2Cr%2Fuploads%2FzLdZHN8THpWXSBllol38%2Fdocs-de-config-theme-iconset-ionicons-solid.png?alt=media&#x26;token=9384385d-27d2-4eb4-b584-4bfb6e4ce8ff" alt=""><figcaption></figcaption></figure>

Material Icons:

<figure><img src="https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4i6VN0FeNAgRFLwVM2Cr%2Fuploads%2FHHlnh6jfYfK2kn2UEibk%2Fdocs-de-config-theme-iconset-material.png?alt=media&#x26;token=b3ad7847-991c-4b95-b6e1-57d173eeaa06" alt=""><figcaption></figcaption></figure>

Simple Line Icons:

<figure><img src="https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4i6VN0FeNAgRFLwVM2Cr%2Fuploads%2FNbXF3Y0QZB6eZq51QjI6%2Fdocs-de-config-theme-iconset-simple-line-icons.png?alt=media&#x26;token=e6425f7f-c6fb-4e71-a726-948243754c0a" alt=""><figcaption></figcaption></figure>

Tonicons Icons:

<figure><img src="https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4i6VN0FeNAgRFLwVM2Cr%2Fuploads%2FERAaZBHwh7eOlc4adlgR%2Fdocs-de-config-theme-iconset-tonicons.png?alt=media&#x26;token=643a0d70-7eb3-4336-8ae7-abce105588dc" alt=""><figcaption></figcaption></figure>

#### Main Navigation as offcanvas

The main navigation with the categories of the store transitions to the mobile display from a certain viewport. Using the setting **Main Navigation as Offcanvas (1)** you can determine in which viewport area the mobile menu is displayed. With the help of this option it is even possible to display the mobile menu for the desktop view as well.

<figure><img src="https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4i6VN0FeNAgRFLwVM2Cr%2Fuploads%2Fcn0NSKS0gYMQqCfmcT8i%2Fdocs-en-config-basic-settings-offcanvas-menu.png?alt=media&#x26;token=7bcb0012-9ff6-4f22-b414-b3bd9721fd41" alt=""><figcaption></figcaption></figure>

Examples:

![Offcanvas menu on desktops viewports](https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCG4xkoMVXEQllVF5R9%2F-Mbenk0MdAHlQjgewU6i%2F-MbeqB1J_c0LSKIZHPCB%2Fstorefront-main-navigation-offcanvas.png?alt=media\&token=b3e9ef9f-0ce5-42dc-999f-b09a85f6329f)

![Default menu on desktop viewports](https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCG4xkoMVXEQllVF5R9%2F-Mbenk0MdAHlQjgewU6i%2F-MbeqJrKuoh35PfEUC0x%2Fstorefront-main-navigation-default.png?alt=media\&token=37e994f0-510f-422c-84c9-1aab73f5367f)

#### Quantity field \[Default, Quantity selection | Quantity input -/+]

The field for the order quantity can be changed globally to an input field with plus and minus buttons. The setting is global and affects all other input fields, e.g. in shopping cart or checkout.

* **Default*****:*** This value sets all order quantity fields to standard. From shopware 6.5 the default quantity field is an quantity input -/+
* **Quantity selection:** The default quantity selection is used. From a maximum selection quantity > 100 the quantity input -/+ of the theme is displayed.
* **Quantity input -/+:** Instead of the quantity selection, a quantity input with plus and minus buttons is displayed.

{% hint style="success" %}
*Quantity selection:* **Why does the quantity selection become a quantity input?**

This is related to the [max order quantity](https://docs.shopware.com/en/shopware-6-en/settings/shopping-cart#maximum-selection-quantity), which you can set in the administration of the store under **Settings > Cart settings**. About the maximum selection quantity you can define how many products can be selected via the dropdown.

The browser must be render for **each** item in the listing (in the shopping cart, checkout, etc.) such a quantity selection. Setting the maximum selection quantity to a very high value will result in long loading times.

Values beyond 10,000 or even 100,000 not only lead to long loading times, but can also cause the browser to crash. In such an extreme case (maximum selection quantity = 100,000), the browser must render 1 - 100,000 option lines of the quantity selection. With e.g. 24 products per listing this is 2,400,000 lines.
{% endhint %}

Examples:

<figure><img src="https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4i6VN0FeNAgRFLwVM2Cr%2Fuploads%2FdD3xH1owXLKxUZtf8XzD%2Fdocs-storefront-example-default-quantity-input.png?alt=media&#x26;token=8aeb84ec-100e-4c88-80e1-afe30e181328" alt=""><figcaption><p>Default quantity input</p></figcaption></figure>

<figure><img src="https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4i6VN0FeNAgRFLwVM2Cr%2Fuploads%2FB4sBDH4zSZEFSP2NLp1F%2Fdocs-storefront-example-quantity-selection.png?alt=media&#x26;token=72b061ee-0418-4855-a7a2-7ddeb2056d8f" alt=""><figcaption><p>Quantity selection</p></figcaption></figure>

<figure><img src="https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4i6VN0FeNAgRFLwVM2Cr%2Fuploads%2FkBcnwAj689PrliMkvQ7Z%2Fdocs-storefront-example-quantity-input.png?alt=media&#x26;token=f3f87858-5650-4151-893c-c3ebdabe1ff0" alt=""><figcaption><p>Quantity input -/+</p></figcaption></figure>

### Global Body Paddings

Global spacing can be set in the theme to achieve framing on full-screen layouts. On mobile devices, these distances should be reduced. Generally, values between 0 - 100 pixels are suitable here.

![](https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4i6VN0FeNAgRFLwVM2Cr%2Fuploads%2FBe3Ea0HDaqMHmf33FnoQ%2Fdocs-en-config-theme-global-body-paddings.png?alt=media\&token=19bb7891-8f7e-491f-9f4f-fd5057141470)

![Example with global body paddings and full width layout](https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCG4xkoMVXEQllVF5R9%2F-MHWb3Lqe0rwb_7N0giJ%2F-MHWcLE4KfQbxlDnPDWL%2Fdocs-front-absta%CC%88nde.jpg?alt=media\&token=f9367d2c-22b6-4d13-bfbe-49a143863a33)

### Container spacings

The spacing of the container for the main content can be adjusted via the theme. On mobile devices, the values are halved.

![](https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4i6VN0FeNAgRFLwVM2Cr%2Fuploads%2FbQUoCZekRSOtjfQeslUt%2Fdocs-en-config-theme-container-spacings.png?alt=media\&token=24549a00-c09a-4ba2-95a6-915ce6fb54a1)

Example:

![Abstände oben (1) und unten (3)](https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCG4xkoMVXEQllVF5R9%2F-Miyeet6XNJ_61cJ29Sh%2F-Miyz7H7rQ6UOs96EeDX%2Fdocs-general-container-paddings-example.png?alt=media\&token=522f61a6-6dd9-4bdd-b534-9baf42858c2c)

![Abstände rechts(2) und links(4)](https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCG4xkoMVXEQllVF5R9%2F-MjnZ7lmyCzqW6H9YNYN%2F-MjnZj6bQ4LXZHqZYbrw%2Fdocs-general-container-horizontal-spacings-example.png?alt=media\&token=f7415c53-623e-44f6-a5bc-1657382aea13)

### Border radius

The border radius defines the appearance of buttons, input fields and various other elements, such as product boxes, product slider thumbnails, tabs, modals (popups) and more.

![](https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4i6VN0FeNAgRFLwVM2Cr%2Fuploads%2F7MSuy2I4gbxgX9yAlQdr%2Fdocs-en-config-theme-border-radius.png?alt=media\&token=678d3f35-44d0-454e-ba51-ffd00cff30b3)

Example:

![Das Beispiel zeigt Buttons "Rund" in Kombination mit Inputs mit einem mittleren Ecken-Radius.](https://2915610672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4i6VN0FeNAgRFLwVM2Cr%2Fuploads%2FmvfAUspPDmNIeCD3FJvA%2Fdocs-en-config-theme-border-radius-example.png?alt=media\&token=9b9f8a56-3e34-4b0d-a159-9c12a1de24a8)
