# Replicate

{% hint style="danger" %}
**Replicate** is a beta feature and may not function as expected.
{% endhint %}

***

<figure><img src="/files/RrAsUUDkPUY4tkL0UgP3" 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="8SFzYMH7jLh1rgDdz6nZ" url="<https://app.arcade.software/share/8SFzYMH7jLh1rgDdz6nZ>" %}

***

## How to use

{% stepper %}
{% step %}

#### Select "Replicate"

In the left task menu, select <kbd><mark style="color:$primary;">**Replicate**<mark style="color:$primary;"></kbd>.

This opens the Replicate workspace for your current scene.
{% endstep %}

{% step %}

#### Upload a Product Image

Upload the image that will be replicated.&#x20;

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 %}

#### Define the Product Replacement Area

You can define one product to be replaced in two ways:

**Rectangle selection**

1. Click and drag to draw a rectangle around the product you want to replace
2. This creates a bounding box that tells which area to target

**Point placement**

Click once to place the replace sticker directly on the product.&#x20;

Point placement is faster but may yield slightly different results.
{% endstep %}

{% step %}

#### Select Replacement Products

1. After placing your selection, click on the replicate sticker to open the product replacement modal.
2. The modal shows three tabs for selecting replacement products:
   1. <kbd><mark style="color:$primary;">**Playground**<mark style="color:$primary;"></kbd> Shows all scenes currently in your Playground. Reuse products you've already generated.
   2. <kbd><mark style="color:$primary;">**Product assets**<mark style="color:$primary;"></kbd> Access your organized product library. Browse by brand, then select related products.
   3. <kbd><mark style="color:$primary;">**Upload**<mark style="color:$primary;"></kbd> Access your playgrounds uploads or upload another image from your computer.&#x20;
3. Select up to 8 replacement products across any combination of tabs.\
   Selected products show checkmarks, and tab headers display selection counts.
4. When finished, select <kbd><mark style="color:$primary;">**Apply**<mark style="color:$primary;"></kbd> to confirm your selection.
   {% endstep %}

{% step %}

#### Configure Scene Behavior Settings (optional)

In the right-side Replicate settings panel, control how the task will handle global elements:

* **Background**
  * <kbd><mark style="color:$primary;">**Exact**<mark style="color:$primary;"></kbd> Locks background pixel-perfectly across all variations
  * <kbd><mark style="color:$primary;">**Adapt**<mark style="color:$primary;"></kbd> Allows subtle variation to prevent copy-paste effect
* **Light**
  * <kbd><mark style="color:$primary;">**Exact**<mark style="color:$primary;"></kbd> Locks lighting across all variations
  * <kbd><mark style="color:$primary;">**Adapt**<mark style="color:$primary;"></kbd> Allows lighting to adjust subtly per product
* **Light**
  * <kbd><mark style="color:$primary;">**Exact**<mark style="color:$primary;"></kbd> Locks color grading exactly
  * <kbd><mark style="color:$primary;">**Adapt**<mark style="color:$primary;"></kbd> Allows color treatment to shift slightly

{% hint style="info" %}
Text and shape layers are always preserved and remain editable after generation, regardless of scene behavior settings.
{% endhint %}
{% endstep %}

{% step %}

#### Generate

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

Preview generation takes longer than other tasks.

Results appear in your Playground once complete.

{% hint style="warning" %}
**Only one Replicate generation can run at a time.**
{% endhint %}
{% endstep %}
{% endstepper %}


---

# Agent Instructions: 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://docs.theseaai.com/tasks/replicate.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.
