> ## Documentation Index
> Fetch the complete documentation index at: https://docs.melius.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Elements

> Save products, avatars, and visual references once, then reuse them across canvases, projects, and generations.

**Elements** keep the references that define a product, character, or visual style together. Save photos, descriptions, dimensions, and guidelines once, then reuse the Element across your team's canvases and projects.

For a product, that might mean front and back photos, close-ups of the label, measurements, and packaging artwork. For an avatar, it might mean reference photos, appearance guidelines, and a saved voice. Melius uses that context to help keep your subject consistent as you change the scene, pose, or format.

## Choose an Element type

| Type | What to save | Example |
| - | - | - |
| **Product** | Product photos, dimensions, materials, packaging details, and guidelines | A jacket with distinctive stitching, or a bottle with a detailed label |
| **Avatar** | A character's appearance, reference images, guidelines, and optional voice | A recurring presenter or a character in a short film |
| **General** | Reusable visual context, such as a mood board, aesthetic, or location | A set shown from several angles, or a campaign's visual style |

You can use Elements throughout your team's work. Creating and editing them requires an editor, admin, or owner role. Product and General Elements also follow your plan's library allowance; see [Plans](https://docs.melius.com/billing/plans.md).

## Create a product Element

**1. Open Elements**

Open **Elements** in the library and start creating an Element. Choose
**Product** and give it a name you will recognize when searching or
mentioning it later.

**2. Add your reference images**

Upload photos or select images already in your files. Include the front,
back, and side views you have, plus close-ups of important details such
as labels, stitching, fasteners, or texture. Check the descriptions of
what each image shows. For packaging, add a dieline if you have one.

**3. Describe the product**

Add its materials, colors, dimensions, and other facts a photo may not
communicate. You can copy specifications from your product detail page.
Include units: a bottle's height in centimeters gives the model more
useful scale information than "small bottle."

**4. Add guidelines and create**

Use guidelines for details that should stay consistent, such as the
label wording, finish, or placement of a logo. Check the credit quote,
then select **Create**. Melius processes the references and generates a
reference sheet.

> [!TIP]
>
> Photograph details that matter to the final output. A clear phone photo of a
> jacket's lining is more useful than asking the model to infer an unseen
> lining from an exterior shot. Keep distinct products or color variants in
> separate Elements when you need to reference them independently.

## Review a product before using it

> [!NOTE]
>
> Product review, including generated views and detailed reference processing,
> is available on **Professional** and above. See [Plans](https://docs.melius.com/billing/plans.md).

When a product version is ready for review, open it to inspect the original images, detail crops, and generated views. Generated views fill in angles that your original photos may not show, so compare them carefully with the real product.

**1. Check the originals and details**

Confirm that the images and their view labels describe the right
product. Review the detail crops and exclude ones that are irrelevant or
misleading.

**2. Accept or reject generated views**

**Accept** a view that accurately represents the product. **Reject** a
view you do not want generations to use. Check shape, proportions,
labels, colors, and small construction details.

**3. Redraw a detail that is wrong**

Select **Redraw**, mark the area that needs attention, and describe the
correction. For example: "Add a small five-point metal star near the
shoulder seam." Review the result and use drawing history to compare
attempts. Each generated view allows up to three redraws. If the detail
still looks wrong, improve the source photos and create another version.

**4. Publish the version**

Check the views you want to use, then select **Publish**. Publishing
makes the reviewed version available for generations. Review each view
deliberately before publishing.

Melius selects relevant reference images and details for the requested generation, within the chosen model's input limits. A model with room for only one reference image may receive the reference sheet. You do not need to wire every crop into the canvas yourself.

## Create an avatar

Choose **Avatar**, give the character a name, and add reference images. Describe identifying details such as height, hairstyle, or clothing, then add guidelines for features you want to preserve across scenes.

You can also choose a voice or create a custom voice through the voice picker. Save the avatar so you can reuse its appearance and voice. Cast and Ditto use the shared avatar library, and product Elements are available in Cast's prop picker.

For example, save an avatar named **Joey** with reference photos, height, a preferred voice, and guidelines about hairstyle. You can then reuse Joey across editorial images, ads, and narrative scenes without rebuilding that context each time.

## Use Elements on the canvas

Open **Elements** in the canvas toolbar, search for the Element, and click or drag it onto the canvas. Connect it to a compatible generation node, or mention an Element when briefing Mel.

Type **`#`** and select an Element from the suggestions. Use **`@`** for canvas node references. Select the matching suggestion so the reference is attached to your prompt.

An example brief, after selecting the two Elements:

```text theme={null}
Create three editorial images of #Joey wearing #Leather jacket:
walking down a city street, seated in a cafe, and a close-up of the jacket.
Keep the jacket's stitching and hardware consistent.
```

You can connect up to **three Elements per node**. A model's reference-input limits may reduce how many it can use. If a connection or generation is refused, reduce the inputs or choose a model that supports them.

### Use an avatar's saved voice in video

Connecting an avatar to a video node gives the generation a visual reference, but does not by itself guarantee that it will use the saved voice. For a manual workflow:

1. Connect the avatar Element to an audio node that supports its voice.
2. Generate the spoken lines in that audio node.
3. Connect the generated audio to a video node that accepts audio input, along with the visual references.

You can also ask Mel, or an agent connected through [MCP](https://docs.melius.com/mcp/overview.md), to assemble the workflow. Include both the desired character and the instruction to use their saved voice in your brief.

## Versions and credits

An Element can have multiple versions. Updating the source images, description, or guidelines creates a new version and reruns its preparation. Review the new version before using it in production work.

Creating and updating Avatar Elements is free on every plan, including when Mel or an agent connected through MCP saves one for you.

Your team's first Product or General Element is free. Subsequent Product or General versions cost **2,500 credits**, unless a free-generation offer covers them. Check the quote and any free-generation option shown before selecting **Create** or **Save**.

Version credits can be deducted when creation starts. A charged version discarded before publication is refunded. Simply closing the review does not discard the version. Generating images, video, or audio with an Element has the usual generation costs shown for that run.

## Workflows to try

| Your work | What to save | What to make |
| - | - | - |
| **Ecommerce and retail** | A Product Element for each SKU, including dimensions and label details | Product photography, lifestyle scenes, and seasonal ad variants |
| **Marketing teams and agencies** | Products and recurring campaign presenters | A series of campaign assets using the same product and character across projects |
| **AI studios and filmmakers** | Avatar Elements for characters, Product Elements for props, and General Elements for sets | Connected scenes with recurring characters, props, and locations |
| **Creators with recurring personas** | An avatar's appearance, voice, and guidelines | A series of social videos built around the same character |

Elements improve consistency; they do not make generation exact. Inspect the finished output, especially small text, logos, scale, and details that were inferred from missing angles. Improve the references when the same error keeps recurring.

For a practical starting point, follow [Product photos and swaps](https://docs.melius.com/help-center/marketers/recipes/product-swap.md), or learn how to organize [Assets, logos, and fonts](https://docs.melius.com/help-center/marketers/assets.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.