> 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/tasks/expand.md).

# Expand

***

<figure><img src="/files/bHM8RIlbmlB0Kovr0Y9P" alt=""><figcaption></figcaption></figure>

***

## Interactive Tutorial

{% hint style="info" icon="language" %}
**How to Change Your Tutorial Language**\
Tutorials are shown in English by default. To view this tutorial in a different language, hover over the top right corner and select <i class="fa-language">:language:</i> **Language**.
{% endhint %}

{% @arcade/embed flowId="ft86jPMZKmiBM2JvAkUK" url="<https://app.arcade.software/share/ft86jPMZKmiBM2JvAkUK>" %}

***

## How to use

{% stepper %}
{% step %}

#### Select ”AI Expand”

In the left task menu, select <kbd><mark style="color:$primary;">**Resize**<mark style="color:$primary;"></kbd> then <kbd><mark style="color:$tint;">**AI Expand**<mark style="color:$tint;"></kbd>

This opens the AI Expand workspace.
{% endstep %}

{% step %}

#### Upload a Product Image

The product image will be used as the foreground element.

You may upload an image by:

* Selecting <kbd><mark style="color:$primary;">**Upload an image**<mark style="color:$primary;"></kbd> inside the scene
* Dragging and dropping an image from a folder on your computer
* Dragging and dropping an image from the Library panel at the bottom-left of the screen

Once uploaded, the product will appear in the scene.
{% endstep %}

{% step %}

#### Adjust the Output Size

You may manually adjust the image size directly on the canvas.

Alternatively:

* Use the zoom percentage controls in the AI Expand settings panel on the right side of the scene.

If you want to change the aspect ratio, proceed to the next step.
{% endstep %}

{% step %}

#### Select an Expand Ratio

In the right-side AI Expand settings panel:

* Open the <kbd><mark style="color:$primary;">**Expand Ratio**<mark style="color:$primary;"></kbd> dropdown menu.
* Select the new aspect ratio.

<details>

<summary><strong>Available aspect ratios</strong></summary>

* Portrait (9:16, 768×1344px)
* Widescreen (21:9, 1536×672px)
* Vertical Widescreen (9:21, 672×1536px)
* Flexible 5:4 (5:4, 1152×896px)
* Flexible 4:5 (4:5, 896×1152px)
* Square (1:1, 1024×1024px)
* Photo (3:2, 1248×832px)
* Vertical Photo (2:3, 832×1248px)
* Classic (4:3, 1184×864px)
* Vertical Classic (3:4, 864×1184px)
* Landscape (16:9, 1344×768px)

</details>
{% endstep %}

{% step %}

#### Optional: Add a Text Prompt

In the right-side AI Expand settings panel, you may add a text prompt for overall direction.\
In the Text prompt field:

1. Write directly in the text prompt field.
2. Select <kbd><mark style="color:$primary;">**Library**<mark style="color:$primary;"></kbd> to re-use a previously saved prompt.
3. From the <i class="fa-cloud-arrow-up" style="color:$primary;">:cloud-arrow-up:</i> icon, upload an image and Beachside will create a description and place the text in the prompt field.
   {% endstep %}

{% step %}

#### Expand

After confirming all settings, select <kbd><mark style="color:$primary;">**Expand**<mark style="color:$primary;"></kbd>.

The generated scene will appear in your Playground.
{% endstep %}
{% endstepper %}


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.theseaai.com/tasks/expand.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.