Skip to content

Products ​

The Products view lets you manage product references for generating consistent marketing and e-commerce images.

Products View

Overview ​

The Products feature enables:

  • Consistent product images across marketing scenes
  • URL-based import from product photos
  • Marketing scene generation with saved products
  • Usage tracking for popular products

Product Library ​

Library View ​

┌─────────────────────────────────────────────────────────────┐
│  Products                     [🔍 Search] [+ Add Product]   │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐        │
│  │    🖼️       │  │    🖼️       │  │    🖼️       │        │
│  │Water Bottle │  │ Headphones  │  │  Tote Bag   │        │
│  │  32 uses    │  │  18 uses    │  │  12 uses    │        │
│  └─────────────┘  └─────────────┘  └─────────────┘        │
│                                                             │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐        │
│  │    🖼️       │  │    🖼️       │  │     +       │        │
│  │  Sneakers   │  │   Watch     │  │ Add New     │        │
│  │   8 uses    │  │   5 uses    │  │             │        │
│  └─────────────┘  └─────────────┘  └─────────────┘        │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Sorting Options ​

SortDescription
Most UsedBy times_used (default)
Name A-ZAlphabetical
NewestRecently added
Recently UsedLast used date

Filtering ​

Filter by tags:

┌─────────────────────────────────────────────────────────────┐
│ Tags: [All] [Drinkware] [Electronics] [Apparel] [Lifestyle] │
└─────────────────────────────────────────────────────────────┘

Adding a Product ​

Step 1: Product Image URL ​

┌─────────────────────────────────────────────────────┐
│ Add Product                                    [×]  │
├─────────────────────────────────────────────────────┤
│ Product Image URL *                                 │
│ ┌─────────────────────────────────────────────────┐ │
│ │ https://example.com/product-photo.jpg           │ │
│ └─────────────────────────────────────────────────┘ │
│                                                     │
│ 💡 Provide a direct URL to a product image         │
│    (PNG, JPG, or WebP supported)                   │
│                                                     │
│ [Fetch Image]                                       │
└─────────────────────────────────────────────────────┘

Step 2: Preview and Details ​

┌─────────────────────────────────────────────────────┐
│ Product Details                                     │
├─────────────────────────────────────────────────────┤
│ ┌───────────────┐                                   │
│ │               │  Product Name *                   │
│ │    🖼️         │  ┌───────────────────────────┐   │
│ │   Preview     │  │ Premium Water Bottle      │   │
│ │               │  └───────────────────────────┘   │
│ └───────────────┘                                   │
│                                                     │
│ Description (optional)                              │
│ ┌─────────────────────────────────────────────────┐ │
│ │ Stainless steel insulated bottle, matte black  │ │
│ │ finish with rose gold accents, 24oz capacity   │ │
│ └─────────────────────────────────────────────────┘ │
│                                                     │
│ Tags (optional)                                     │
│ ┌─────────────────────────────────────────────────┐ │
│ │ drinkware, lifestyle, fitness                   │ │
│ └─────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────┘

Step 3: Confirm and Save ​

┌─────────────────────────────────────────────────────┐
│ Confirm Product                                     │
├─────────────────────────────────────────────────────┤
│ Product: Premium Water Bottle                       │
│                                                     │
│ The product image will be:                          │
│ • Downloaded and stored securely                    │
│ • Available for unlimited marketing scenes          │
│ • Automatically referenced in generations           │
│                                                     │
│ [← Back]                           [Save Product]   │
└─────────────────────────────────────────────────────┘

Product Detail View ​

Click a product to see full details:

┌─────────────────────────────────────────────────────────────┐
│ Premium Water Bottle                    [Edit] [Delete]     │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  ┌───────────────┐  Product Details                        │
│  │               │  ─────────────────                      │
│  │    🖼️         │  Name: Premium Water Bottle             │
│  │   Product     │  Added: Jan 8, 2024                     │
│  │    Image      │  Times Used: 32                         │
│  │               │  Last Used: Jan 15, 2024                │
│  └───────────────┘                                         │
│                                                             │
│  Description:                                               │
│  Stainless steel insulated bottle, matte black finish      │
│  with rose gold accents, 24oz capacity                     │
│                                                             │
│  Tags: drinkware, lifestyle, fitness                       │
│                                                             │
│  Recent Marketing Images                                    │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐          │
│  │  🖼️     │ │  🖼️     │ │  🖼️     │ │  🖼️     │          │
│  └─────────┘ └─────────┘ └─────────┘ └─────────┘          │
│                                                             │
│  [Generate Marketing Image]                                 │
└─────────────────────────────────────────────────────────────┘

Using Products ​

From Products View ​

  1. Click product card
  2. Click Generate Marketing Image
  3. Enter scene description
  4. Generate

From Composer ​

  1. Go to Composer → Product tab
  2. Select product from dropdown
  3. Enter scene/setting description
  4. Generate

Quick Generate ​

Right-click product for quick actions:

┌─────────────────────────────┐
│ Generate Marketing Image    │
│ View All Images             │
│ ─────────────────────────── │
│ Edit Product                │
│ ─────────────────────────── │
│ Delete Product              │
└─────────────────────────────┘

Scene Descriptions ​

Effective Scene Prompts ​

When generating with a product, describe the setting:

┌─────────────────────────────────────────────────────┐
│ Scene Description                                   │
├─────────────────────────────────────────────────────┤
│ ┌─────────────────────────────────────────────────┐ │
│ │ on a rustic wooden table by a sunny window,     │ │
│ │ with fresh flowers and morning light            │ │
│ └─────────────────────────────────────────────────┘ │
│                                                     │
│ Example scenes:                                     │
│ • "on a gym bench with workout equipment"          │
│ • "at a beach picnic with ocean backdrop"          │
│ • "in a modern kitchen with marble countertop"     │
│ • "held by a hiker on a mountain trail"            │
└─────────────────────────────────────────────────────┘

Scene Templates ​

Quick-start templates for common use cases:

TemplateDescription
LifestyleNatural setting with people
StudioClean background product shot
Flat LayTop-down arrangement
In UseProduct being actively used
SeasonalHoliday or seasonal setting

Marketing Campaigns ​

Batch Generation ​

Generate multiple scenes for a campaign:

┌─────────────────────────────────────────────────────┐
│ Marketing Campaign                                  │
├─────────────────────────────────────────────────────┤
│ Product: Premium Water Bottle                       │
│                                                     │
│ Generate scenes:                                    │
│ ☑ Studio shot (white background)                   │
│ ☑ Lifestyle (gym setting)                          │
│ ☑ Outdoor (hiking trail)                           │
│ ☑ Flat lay (fitness accessories)                   │
│                                                     │
│ Aspect Ratio: [Square ▼] (for social media)        │
│                                                     │
│ [Generate All (4 images)]                           │
└─────────────────────────────────────────────────────┘

Style Consistency ​

Apply style presets for brand consistency:

┌─────────────────────────────────────────────────────┐
│ Brand Style                                         │
├─────────────────────────────────────────────────────┤
│ Style Preset: [Brand Product Photography ▼]         │
│                                                     │
│ Applied settings:                                   │
│ • Soft studio lighting                              │
│ • Clean minimal aesthetic                           │
│ • Warm color temperature                            │
└─────────────────────────────────────────────────────┘

Editing Products ​

Update Details ​

┌─────────────────────────────────────────────────────┐
│ Edit Product                                   [×]  │
├─────────────────────────────────────────────────────┤
│ Product Name                                        │
│ ┌─────────────────────────────────────────────────┐ │
│ │ Premium Water Bottle - Limited Edition          │ │
│ └─────────────────────────────────────────────────┘ │
│                                                     │
│ Description                                         │
│ ┌─────────────────────────────────────────────────┐ │
│ │ Updated description...                          │ │
│ └─────────────────────────────────────────────────┘ │
│                                                     │
│ Tags                                                │
│ ┌─────────────────────────────────────────────────┐ │
│ │ drinkware, premium, limited-edition             │ │
│ └─────────────────────────────────────────────────┘ │
│                                                     │
│ [Cancel]                           [Save Changes]   │
└─────────────────────────────────────────────────────┘

Replace Product Image ​

To update the product image, delete and re-add the product with the new URL.

Deleting Products ​

WARNING

Deleting a product removes the reference permanently. Marketing images generated with this product are NOT deleted.

┌─────────────────────────────────────────────────────┐
│ Delete Product?                                     │
├─────────────────────────────────────────────────────┤
│ Are you sure you want to delete                     │
│ "Premium Water Bottle"?                             │
│                                                     │
│ • Product reference will be removed                 │
│ • Stored product image will be deleted              │
│ • 32 marketing images will NOT be affected          │
│                                                     │
│ [Cancel]                               [Delete]     │
└─────────────────────────────────────────────────────┘

Best Practices ​

Product Image Quality ​

Ideal product photos:

  • Clean, white or transparent background
  • High resolution (1000px+ recommended)
  • Product centered and well-lit
  • No watermarks or text overlays
✅ Good: Clean product shot on white background
❌ Bad: Product in cluttered scene with text overlay

Scene Description Tips ​

  1. Be specific about setting and lighting
  2. Include context for the product use
  3. Mention style preferences
  4. Consider audience for the marketing material
✅ Good: "on a minimalist desk setup with a laptop
and plant, soft natural lighting from a window"

❌ Bad: "on a table"

Organizing Products ​

Use consistent tagging:

Tag TypeExamples
Categorydrinkware, electronics, apparel
Use Casefitness, office, outdoor
Campaignsummer-2024, holiday-sale
Statusactive, archived, seasonal

Analytics ​

Product Performance ​

View which products generate the best images:

┌─────────────────────────────────────────────────────┐
│ Product Analytics                                   │
├─────────────────────────────────────────────────────┤
│ Most Used Products (Last 30 Days)                   │
│                                                     │
│ 1. Premium Water Bottle    ████████████  32 uses   │
│ 2. Wireless Headphones     ██████████    18 uses   │
│ 3. Canvas Tote Bag         ████████      12 uses   │
│ 4. Running Sneakers        ██████         8 uses   │
│ 5. Smart Watch             ████           5 uses   │
└─────────────────────────────────────────────────────┘

API Access ​

Products are also accessible via:

  • MCP Tools: create_product_reference, list_product_references, generate_with_product
  • REST API: GET/POST /api/products

See Products API → for details.

Use Cases ​

E-Commerce ​

Generate product images for:

  • Product listing pages
  • Category banners
  • Social media ads
  • Email campaigns

Social Media ​

Create engaging content:

  • Instagram posts
  • Pinterest pins
  • Facebook ads
  • Story content

Generate for:

  • Catalogs
  • Brochures
  • Packaging
  • Point-of-sale displays

Next Steps ​

Released under the MIT License.