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

# Image Editor (Layer Editor)

Compose images, text, shapes and 3D models into a single layered image

The Image Editor is a fullscreen compositing tool. It combines images, text, shapes and 3D models into one layered composition, with precise control over position, size, order and appearance. The node outputs the finished composite as a single image that other nodes can use.

{% hint style="info" %}
The Image Editor was previously called the **Layer Editor**. Existing Layer Editor nodes open in the Image Editor unchanged.
{% endhint %}

{% embed url="<https://www.youtube.com/watch?v=4uD55AA5UEw>" %}

Use it for collages, mood boards, social graphics, product composites, and any image built from several pieces.

***

## Getting Started

{% stepper %}
{% step %}
**Add the Node**

From the node menu, select **Image Editor**, or press `L`.
{% endstep %}

{% step %}
**Connect Sources**

Connect image, text or 3D nodes to the Image Editor. Each connected source becomes a layer: images become image layers, text becomes a text layer, and 3D models become 3D layers.
{% endstep %}

{% step %}
**Open the Editor**

**Double-click** the node, click **Edit layers** on the node, or click **Edit** in the node toolbar. The editor opens fullscreen with your layers, tools and panels.
{% endstep %}

{% step %}
**Finish**

Click **Done** at the top of the editor, or press `Esc`, to return to the canvas. `Esc` steps out one level at a time: it first closes an open tool or clears the selection, then exits.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Shortcut:** on an image or 3D node, choose **Open in Image Editor** from the node's **Tools** menu (or the right-click menu on an image node). FLORA adds a new Image Editor connected to that node and opens it.
{% endhint %}

***

## Adding Layers

Besides connected nodes, you can add layers from the toolbar at the bottom of the editor:

* **Text** (`T`) - Add a text layer, then style it in the Typography panel
* **Shape** - Add a square, circle or triangle
* **Vector** - Draw a path
* **Image** - Add an image from your Library, Unsplash, an upload, or a new generation

***

## Working with Layers

### The Layers Panel

The Layers panel lists every layer. The layer at the top of the list appears in front.

* **Visibility** - Show or hide a layer (`Cmd/Ctrl + Shift + H`)
* **Lock** - Prevent accidental edits (`Cmd/Ctrl + Shift + L`)
* **Rename** - Double-click a layer's name
* **Reorder** - Drag layers up or down
* **Group** - Group selected layers with `Cmd/Ctrl + G`; ungroup with `Cmd/Ctrl + Shift + G`

### Selecting Layers

* **Click** a layer to select it
* **Cmd/Ctrl + Click** or **Shift + Click** on the canvas to add or remove a layer from the selection
* **Shift + Click** in the Layers panel to select a range
* **Drag** across empty space to select several layers
* **Cmd/Ctrl + A** selects all layers; click empty space to deselect

***

## Transforming Layers

### Moving

* **Drag** a layer to move it. Hold `Alt` while dragging to duplicate it.
* **Arrow keys** nudge by 1 pixel; **Shift + Arrow keys** nudge by 10 pixels.

### Resizing

Drag the corner or edge handles. The aspect ratio is locked by default; toggle the lock next to the W/H fields in the properties panel. Hold `Shift` while dragging to keep the aspect ratio.

**Double-click** an image layer to fill the frame with it. Double-click a text or vector layer to edit it.

### Rotating and Flipping

* Drag the round handle above the selection to rotate it. Hold `Shift` to snap to angle steps.
* Use the transform actions to **Flip horizontal** (`Shift + H`), **Flip vertical** (`Shift + V`), or rotate 90° either way.

### Snapping

Layers snap to edges, centers and margins as you move them, with guide lines. Use the magnet button to turn snapping on or off, or hold `Cmd/Ctrl` while dragging to skip it.

***

## Alignment

The alignment actions align a single layer to the frame, or several layers to each other:

* Align left, Center horizontally, Align right
* Align top, Center vertically, Align bottom
* Center in frame
* Distribute horizontal or vertical spacing (three or more layers)

***

## Layer Ordering

Right-click a layer for **Send to top**, **Send up**, **Send down** and **Send to bottom**, or drag it in the Layers panel.

| Action        | Shortcut       |
| ------------- | -------------- |
| Bring forward | `Cmd/Ctrl + ]` |
| Send backward | `Cmd/Ctrl + [` |

The same menu also has **Duplicate**, **Fill to frame**, **Split into layers**, **Extract layer**, **Flatten layers** and **Delete**.

***

## Appearance and Adjustments

* **Opacity** - Slider in the Appearance panel. Keys `1`–`9` set 10–90%, and `0` sets 100%.
* **Blend mode** - Also in the Appearance panel
* **Color** - Text color for text layers, shape color for shape layers, and fill, stroke and stroke width for vector layers
* **Image adjustments** - Exposure, contrast, highlights, shadows, saturation, tint and temperature

### Fill and Stroke Opacity

Vector layers keep separate fill and stroke opacity. The Appearance Panel shows each paint's color and opacity, and you can edit them apart from the layer's overall opacity.

### Full-height Numbers

Text layers have a **Full-height numbers** button. It switches fonts that use old-style numbers by default to full-height numbers that line up with capital letters. The button is disabled when the font has only one number style.

***

## Zoom and Pan

While in edit mode, you can zoom and pan around the frame:

* **Zoom** — `Ctrl/Cmd + scroll`, or pinch on a trackpad
* **Pan** — scroll, or drag the empty space around the frame
* **Zoom menu** — click the zoom percentage to choose **Zoom to fit**, **Zoom to 50%**, **Zoom to 100%**, or **Zoom to 200%**

## Frame Size

The frame sets the output dimensions:

* **Default size**: 2048 × 2048 pixels
* **Maximum size**: 4096 × 4096 pixels
* **Minimum size**: 100 × 100 pixels

With no layer selected, the **Frame** panel shows the width, height, aspect ratio and margins. Press `C` to crop the frame by dragging its edges.

***

## 3D Layers

The Image Editor can hold live 3D models as layers. You orbit a 3D model in place, and a flattened image of its current pose is used everywhere else: the node preview, downloads, and downstream nodes.

### Adding a 3D Layer

* **Wire a 3D node** - Connect a 3D node to the Image Editor. Its model becomes a 3D layer.
* **Drag and drop** - Drop a 3D asset, such as a generation from a 3D node, into the editor.
* **Generate** - A generation started from the editor that produces a 3D model lands as a 3D layer.

### Orbiting

Select a 3D layer and drag the **Rotate 3D model** handle near its top-left corner to orbit the model. When you let go, the current pose is flattened into an image that stands in for the layer in the composite. The pose is saved with the node, so it is still there when you reopen the editor.

{% hint style="info" %}
At most **two** 3D layers show a live 3D view at the same time. Other 3D layers show their last flattened pose.
{% endhint %}

***

## Splitting Layers

Click **Split into layers** on a layer in the Layers Panel, or use it from the layer's menu, to break the layer into separate layers you can move and edit one by one.

| Option                      | What it does                                                         | Time | Cost    |
| --------------------------- | -------------------------------------------------------------------- | ---- | ------- |
| **Vector Split**            | Turns each shape in an SVG into its own editable vector layer        | \~1s | Free    |
| **Quick Split**             | Splits the image into the areas it identifies, without changing them | \~5s | Free    |
| **Seedream 5 Pro Layerize** | Regenerates each element as a complete layer. May change details     | \~2m | Credits |

Vector Split appears only for SVG layers. Seedream 5 Pro Layerize needs an image at least 512px on each side.

### Importing SVGs

When you add an SVG to the Image Editor, FLORA splits it into editable vector layers, one per shape. Dashed strokes keep their dashes. Parts that vector layers can't draw, such as filters, masks and patterns, become image layers in their place in the stack.

An SVG with more than 128 shapes, or with more than three parts that need image layers, stays a single image layer when you add it. Use **Vector Split** to split it anyway. An editor holds at most 1,280 layers, so a split that would go past that is refused.

{% hint style="info" %}
**Vector Split** is greyed out when the layer's opacity is below 100%, its blend mode isn't Normal, or it has adjustments, and its shapes overlap. Splitting would change how it looks. Hover the option to see the reason. To enable it, reset opacity to 100%, set the blend mode to Normal and remove adjustments.
{% endhint %}

***

## Editing and Splitting with AI

Select a single image layer to open the **Edit Layer** panel:

* **Generate** - Prompt to edit the layer in place
* **Remove background**, **Upscale 2×** and **Upscale 4×**
* **Quick Split** and **Generative Split** - Break an image into separate layers (see [Splitting Layers](#splitting-layers); Generative Split runs Seedream 5 Pro Layerize)
* **Actions** - Run an action on the layer, or describe a new one in **Create a tool…**

To generate a new layer instead, choose **Image → Generate** in the toolbar.

***

## Output and Export

All visible layers are composited into the node's output image. Hidden layers are left out, so toggle visibility to exclude a layer without deleting it. Connect the Image Editor to other nodes to keep working with the result.

From the **Export** panel you can also:

* **Download** the composition as PNG, JPG or WEBP, or as SVG when every visible layer is a vector layer
* **Output** the composite or a selected layer to the canvas as a new node
* **Generate** a new image, video, text or 3D node from the composition

***

## Keyboard Shortcuts

| Action                     | Shortcut                                |
| -------------------------- | --------------------------------------- |
| Add Image Editor node      | `L` (on the canvas)                     |
| Delete selected layers     | `Delete` or `Backspace`                 |
| Undo                       | `Cmd/Ctrl + Z`                          |
| Redo                       | `Cmd/Ctrl + Shift + Z`                  |
| Copy / paste layers        | `Cmd/Ctrl + C` / `V`                    |
| Duplicate layer            | `Cmd/Ctrl + D`                          |
| Select all                 | `Cmd/Ctrl + A`                          |
| Group / ungroup layers     | `Cmd/Ctrl + G` / `Cmd/Ctrl + Shift + G` |
| Text tool                  | `T`                                     |
| Crop frame                 | `C`                                     |
| Nudge 1px / 10px           | Arrow keys / `Shift + Arrow keys`       |
| Bring forward              | `Cmd/Ctrl + ]`                          |
| Send backward              | `Cmd/Ctrl + [`                          |
| Lock / hide layer          | `Cmd/Ctrl + Shift + L` / `H`            |
| Set opacity                | `1`–`9`, `0`                            |
| Flip horizontal / vertical | `Shift + H` / `Shift + V`               |
| Exit the editor            | `Esc`                                   |

***

## Tips

* **Lock finished layers** so you don't move them while working on others
* **Name your layers** to stay organized in complex compositions
* **Hide instead of delete** to try variations without losing work


---

# 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.flora.ai/nodes/image-editor.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.
