Image Library
Brand Asset Library
The Brand Asset Library is your central hub for all visual content in Cuppa. Upload your own brand images, generate new ones with AI, use existing images as style references, and edit images with text prompts. Everything lives in one unified grid, organized by time.
What You Can Do
Upload brand assets: Logos, photos, illustrations, screenshots
Generate AI images: Single, batch, or variations
Use images as references: Generate new images inspired by an existing one
Edit images with AI: Modify any image using a text prompt
Download and copy URLs: Quick access for use anywhere
Manage your library: Archive, delete, and organize assets
Getting There
Navigate to Image Library in the left sidebar. You'll see a unified grid showing both uploaded assets and AI-generated images, sorted by most recent.
Uploading Assets
How to Upload
Click the Upload area at the top of the Image Library (or drag and drop files directly)
Select one or more files
Assets appear in your library immediately
Supported Formats
JPEG/JPG
Photos, screenshots
PNG
Graphics, screenshots with transparency
WebP
Modern web images
SVG
Vector graphics, logos
Limits
Max file size: 50MB per file
Multiple uploads: Yes, upload several files at once
Thumbnails: Generated automatically for fast loading
What Gets Stored
For each uploaded asset, Cuppa captures:
Original file at full resolution
Auto-generated thumbnail (WebP, 400px max width)
Metadata: dimensions, file type, file size
Creation date
AI Image Generation
Accessing the Generator
You can generate images two ways:
From Image Library: Use the prompt bar at the top of the page
From Generate Images page: Navigate to Generate Images in the sidebar for the full generation interface
Generation Modes
Single
One image from one prompt
Quick one-off generation
Batch
Multiple images from different prompts (one per line, max 20)
Creating a set of unique images
Variations
Multiple variations of the same prompt (2-10)
Exploring different takes on a concept
Using Different Models
Click the model selector to choose your AI image model. Available models depend on your configured API keys and plan.
Aspect Ratio and Resolution
For supported models, you can control:
Aspect ratio: 16:9, 1:1, 9:16, 4:3, 3:4, and more
Resolution: 1K, 2K, or 4K (model-dependent)
Brand Colors
On Power plans and above, toggle Brand Colors to automatically include your brand's color palette in the generation prompt.
Reference Mode
Use any image in your library as a style reference for new generations.
How to Use
Hover over any image in the library
Click Use as Reference
The prompt bar switches to Reference mode
Adjust the Reference Strength slider (0-100%) to control how closely the new image matches the reference style
Enter your prompt and generate
Higher strength means the output will more closely match the visual style of your reference image. Lower strength gives the AI more creative freedom.
Edit Mode
Edit any existing image using a text prompt (powered by Flux Kontext Pro).
How to Use
Hover over any image in the library
Click Edit with AI
The prompt bar switches to Edit mode
Describe the changes you want (e.g., "change the background to a sunset," "add a red border," "remove the text")
Generate the edited version
The original image is preserved. Edits create new images in your library.
Managing Your Library
Grid View
Images are organized in time-grouped sections:
This Week
This Month
By month and year (older)
Each image shows a badge indicating whether it's an AI generated image or an uploaded asset.
Image Actions
Hover over any image to see quick actions:
Use as Reference
Start a new generation using this image as style reference
Edit with AI
Open edit mode with this image
Download
Save the image to your computer
Copy URL
Copy the public URL to clipboard
Delete
Remove from library (uploaded assets only)
Detail View
Click any image to open the detail modal, which shows:
Full-size preview
Metadata (dimensions, file type for uploads; prompt, model, aspect ratio for generated images)
Creation date
All available actions
Image Statuses
AI-generated images show a status during creation:
In Progress
Image is being generated (animated loading state)
Complete
Image is ready to use
Failed
Generation failed (click to retry)
Failed generations show an error card with a retry button. Images stuck in progress for more than an hour are automatically marked as failed.
Storage
Uploaded assets are stored in Cloudflare R2 with public URLs
Generated images are stored via the image generation provider
All images are scoped to your selected brand/site
Plan Availability
AI Image Generation
Hobby (with API key)
Image Upload / Asset Library
Business
Reference Mode
Hobby (with API key)
Edit Mode
Hobby (with API key)
Brand Colors in Generation
Power
Troubleshooting
Upload failing
Check:
File is under 50MB
Format is JPEG, PNG, WebP, or SVG
You have a stable internet connection
Generated image stuck on "In Progress"
Generation typically takes 10-60 seconds depending on the model
If stuck for more than a few minutes, the image will auto-fail after 1 hour
Check that your API key for the selected model is valid and has credits
"Failed" generation
Click the retry button on the failed image card
If it keeps failing, try a different model or simplify your prompt
Check your API key balance/credits
Reference mode not working as expected
Try adjusting the reference strength slider
Higher strength (70-100%) closely follows the reference style
Lower strength (10-40%) uses it as loose inspiration
Not all models support reference mode equally
Related Docs
Brand Kit: Brand colors and visual identity
Mood Board: Visual inspiration board
Knowledge Sources: Text-based brand context
Last updated
Was this helpful?