> For the complete documentation index, see [llms.txt](https://docs.theseaai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.theseaai.com/layout-overview.md).

# Layout overview

Design banners and scale to different sizes in Beachside.

Layout Playground lets you design one primary banner and generate all different sizes at once, ready to be publish for your campaign.

#### Create a primary banner

Design one primary size first, all generated sizes are built from it.

<figure><img src="https://3377749587-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOUQ3EAPIPziQuBKQgmTy%2Fuploads%2FVRgcYbeMs5Olj0Gh2YI6%2Fgitbook_layout_primary%20size.png?alt=media&amp;token=55345eee-4ddd-45c4-9f52-395f0f2bbecb" alt=""><figcaption></figcaption></figure>

#### Generate all sizes

Generate all sizes in one click, then make changes as needed.

<figure><img src="https://3377749587-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOUQ3EAPIPziQuBKQgmTy%2Fuploads%2F2jvq0trIuYsg59wjWYjD%2FLayout-generated%20size.png?alt=media&amp;token=851094bf-fdad-4d28-9f3d-db68cfccd399" alt=""><figcaption></figcaption></figure>

***

## Create a primary banner

Design your primary banner in any sizes, every other size is generated from it.

{% stepper %}
{% step %}

### Open a Layout Playground

From the playground page, create a new <mark style="color:$primary;">**`Layout`**</mark> playground.
{% endstep %}

{% step %}

### Start from an empty banner

The empty new banner scene opens at the center of your screen, you can choose the banner size in the right side panel.

<figure><img src="https://3377749587-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOUQ3EAPIPziQuBKQgmTy%2Fuploads%2FnNZMVmYC7qi1Luw1Grdt%2Fgitbook_layout_empty.png?alt=media&amp;token=3bc1a234-c427-4e41-80b7-05ab9cd62cb3" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Add your content

* Upload your images by selecting from the library & uploads panel or dropping a file in
* Add text, shapes and vectors element from the toolbar at the bottom of the canvas.

<figure><img src="https://3377749587-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOUQ3EAPIPziQuBKQgmTy%2Fuploads%2FPh0WtQw7HxCKWc1EqEJE%2Fgitbook_layout_add%20layer.png?alt=media&amp;token=59af0b5a-af38-4324-bf94-380fc60b30d7" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
You can upload JPG, JPEG, PNG, WEBP, and SVG files, up to 90 MB each.
{% endhint %}
{% endstep %}

{% step %}

### Design the layout

Position, style, and edit every layer directly on the scene or adjusting parameters in the editing panel. Everything you created here carries into the sizes you generate next.
{% endstep %}
{% endstepper %}

***

## Generate all sizes

Once your primary banner is ready, start to generate every size from it.

{% stepper %}
{% step %}

### Start adding more sizes

Click <i class="fa-grid-2-plus" style="color:$primary;">:grid-2-plus:</i>  <mark style="color:$primary;">**`Add more sizes`**</mark>  button to open the size selection panel.
{% endstep %}

{% step %}

### Pick the sizes to generate

* Choose from E-commerce channel presets sizes or add custom sizes.
* You can see available sizes from **Rakuten, Amazon** and **Qoo10** in [FAQ section here.](#what-e-commerce-channel-size-are-supported)

<figure><img src="https://3377749587-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOUQ3EAPIPziQuBKQgmTy%2Fuploads%2Ft7E4ULgCAUiw1xl3DUtt%2Fgitbook_layout_select%20size.png?alt=media&amp;token=b9c5218b-29a9-4a22-98ec-ae4aac04a563" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
You can select up to 9 sizes in one generation.
{% endhint %}
{% endstep %}

{% step %}

### Generate

Click on the <i class="fa-plus-large" style="color:$primary;">:plus-large:</i>  <mark style="color:$primary;">**`Add [number] sizes`**</mark>  button to start generation.

Generated banners appear below your primary banner. All banner layouts are adapted to each size while preserving the original layers.
{% endstep %}

{% step %}

### Review and adjust the results

When something in a generated banner needs adjusting, edit it in the same way how you created the primary size.

<figure><img src="https://3377749587-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOUQ3EAPIPziQuBKQgmTy%2Fuploads%2FZ5tTAoXU2saHcccqzPDR%2Fgitbook_layout_all%20size%20edits.png?alt=media&amp;token=5ae25a30-187d-4e48-b10b-33cc05a281b1" alt=""><figcaption></figcaption></figure>

To edit several banners at once, you can select multiple layers, or turn on <i class="fa-send-backward" style="color:$secondary;">:send-backward:</i> <mark style="color:$primary;">**`Select matching layers`**</mark> to update matching elements in every sizes together.<br>
{% endstep %}
{% endstepper %}

***

## Export banners

<figure><img src="https://3377749587-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOUQ3EAPIPziQuBKQgmTy%2Fuploads%2FCcgMs34BCJjhqMvNvon1%2Fgitbook_layout_export.png?alt=media&amp;token=f8973fae-40b5-4983-bfa4-edd1d9060862" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Select what to export

Select single or multiple banners to export together.
{% endstep %}

{% step %}

### Select the format and scale

Select the export format as PNG or JPG, and scale at 1x or 2x. When exporting multiple banners, the setting applies to all.
{% endstep %}

{% step %}

### Export

Clicking on the <i class="fa-download" style="color:$primary;">:download:</i> <mark style="color:$primary;">**`Export`**</mark> button will download each banner as a separate file. You can also find the exported banners in your gallery.
{% endstep %}
{% endstepper %}

***

## FAQ

<details>

<summary><strong>Can I add multiple primary banners?</strong></summary>

You can click on the <i class="fa-plus" style="color:$primary;">:plus:</i>  <mark style="color:$primary;">**`plus icon`**</mark> on the left-side panel to create more primary sizes.

</details>

<details>

<summary><strong>Can I change a banner scene's size after I create it?</strong></summary>

Yes. Select the banner scene, then set a new size from the panel on the right. You can enter custom values or choose a channel preset.

</details>

<details>

<summary><strong>Can I edit the same text across several banner scenes at once?</strong></summary>

Yes. Select multiple banner scenes, then edit the text from the panel. Text layers that share a name and value update together. Layers with the same name but different values appear as separate fields.

</details>

<details>

<summary><strong>My banner file is too large for the channel submission . What can I do?</strong></summary>

Channels set their own file size limits. Rakuten allows up to 150 KB per banner, and Amazon's limits range from 20 KB to 200 KB depending on the placement. To reduce file size, export as JPG rather than PNG, and at 1x rather than 2x.

</details>

<details>

<summary><strong>I don't see Layout Playground. How do I get access?</strong></summary>

Layout Playground is enabled per organization. If you don't see it as a playground type, contact your organization admin.

</details>

<details>

<summary><strong>What file types can I upload?</strong></summary>

JPG, JPEG, PNG, WEBP, and SVG, up to 90 MB each.

</details>

<details>

<summary><strong>Why does my generated banner scene look different from the primary one?</strong></summary>

Layers are adapted to each new shape rather than scaled as one flat image. Backgrounds extend, products and logos scale without distortion, and text reflows to stay readable. When space is tight, decorative elements may be reduced or removed so the product and the main message stay clear. You can edit any generated banner scene directly if you want a different result.

</details>

<details>

<summary><strong>What E-commerce channel size are supported?</strong></summary>

{% tabs %}
{% tab title="Rakuten" %}

| Format          | Size       | Device            |
| --------------- | ---------- | ----------------- |
| 1280x200 Banner | 1280 x 200 | PC and smartphone |
| 880x320 Banner  | 880 x 320  | Smartphone        |
| 400x800 Banner  | 400 x 800  | PC                |
| 480x360 Banner  | 480 x 360  | PC                |
| {% endtab %}    |            |                   |

{% tab title="Amazon" %}

| Format             | Size      | Device             |
| ------------------ | --------- | ------------------ |
| Medium Rectangle   | 300 x 250 | Desktop and mobile |
| Large Rectangle    | 336 x 280 | Desktop and mobile |
| Leaderboard        | 728 x 90  | Desktop            |
| Half Page          | 300 x 600 | Desktop            |
| Wide Skyscraper    | 160 x 600 | Desktop            |
| Billboard          | 970 x 250 | Desktop            |
| Mobile Leaderboard | 320 x 50  | Mobile             |
| Home Page Banner   | 600 x 500 | Smartphone         |
| Detail Page Banner | 828 x 250 | Smartphone         |
| {% endtab %}       |           |                    |

{% tab title="Qoo10" %}

{% endtab %}
{% endtabs %}

</details>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.theseaai.com/layout-overview.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
