Higgsfield Moodboard

Higgsfield Moodboard

What Moodboard Does

Moodboard translates a collection of visual references into a unified style direction that can be applied to any generation. Instead of describing a feeling in text and hoping the model interprets it correctly, you show the platform exactly what you want.

Location: Moodboard tab (marked "New" in nav) → higgsfield.ai/moodboard

Two tabs inside Moodboard:

• Curated — Higgsfield's own named preset moodboards, ready to use
• My Moodboards — your custom moodboards built from uploaded references

Curated Moodboard Presets

Named presets built by Higgsfield — apply any of these immediately without uploading reference images. Each represents a complete visual world.

How to apply a curated preset:

1. Go to Moodboard tab
2. Select Curated
3. Click any preset
4. It becomes available in My Moodboards or applies directly to generation

Building a Custom Moodboard

Upload Requirements

Recommended: 20+ photos, one cohesive style Avoid: Mixed styles, inconsistent quality

Two upload options in the Moodboard builder:

• Upload images — upload from your device
• Upload from assets — pull from your existing Higgsfield generations/assets

What "one cohesive style" means: All reference images should share the same visual world — similar lighting quality, color temperature, tone, and aesthetic. If half your references are dark and moody and half are bright and airy, the moodboard gets confused and produces a muddled output.

Good reference set (cohesive): Film stills from the same movie, a photographer's series, a curated Pinterest board with a single strong aesthetic, a fashion brand's lookbook.

Bad reference set (mixed): Random images from different genres, mixing a sunset photo with a dark studio portrait with a colorful illustration.

Building the Moodboard

1. Click Build your moodboard ✦ (yellow button at top)
2. Upload 20+ reference images via "Upload images" or "Upload from assets"
3. Higgsfield analyzes the visual properties across all references
4. Synthesizes dominant: colors, tonal values, lighting character, stylistic patterns
5. Creates a named moodboard saved under My Moodboards

Applying to Generation

Once built, your moodboard appears in:

• Soul 2.0 → Moodboard selector in the prompt bar
• Any generation interface that supports moodboard input

The moodboard acts as a style layer applied on top of your text prompt — you describe the scene, the moodboard handles the look.

Soul Hex — Color Transfer

Soul Hex is Moodboard's dedicated color feature. It extracts and transfers the exact color signature from a reference image.

Location: Soul 2.0 prompt bar → Color Transfer button

Named Color Palettes

Pre-built palettes available directly in Color Transfer:

Custom Color Reference Upload

1. Click Upload & Create ✦ in the Soul Hex section
2. Upload any reference image with the color world you want
3. Soul Hex extracts the color palette automatically — shows hex swatches
4. Apply to generations

Good color references to upload:

• Film still from a movie with the color grade you want
• Fashion editorial with a strong color world
• Your brand's visual assets to match brand colors
• Any image where the color palette is the dominant appeal

Moodboard + Soul ID: The Power Combination

Workflow for a consistent content series:

Copy code
Step 1: Create Soul ID character (20+ photos, Character tab)
Step 2: Build Moodboard from style references (20+ cohesive images)
Step 3: Set Color Transfer palette (named or custom upload)
Step 4: Every generation uses:
         → Character slot: Soul ID active
         → Style: appropriate preset
         → Color Transfer: consistent palette
         → Moodboard: your custom moodboard active
Step 5: Only the scene description changes post to post

Platform constraint — preset vs reference image (Soul 2.0) [OFFICIAL — platform CLI, 2026-09-26]: higgsfield model get text2image_soul_v2 rejects style_id combined with image_references and allows at most one image reference. The schema also has a separate custom_reference_id param that this rule does not mention. Which UI control maps to which param — Style preset → style_id? Soul ID character slot → custom_reference_id or image_references? — is unverified. So this workflow's "Soul ID + preset" pairing is not known to break, while "preset + an uploaded reference image" is the pair the CLI forbids if the preset is style_id: if a generation rejects or ignores one of them, drop the preset or the uploaded reference rather than retrying the pair. Detail: ../../image-models.md § Soul 2.0.

Per-post prompt template (with all consistency tools active):

Copy code
[Soul ID character] is [action] at [specific location].
[One unique visual detail for this post.]
Camera: [movement]. Aspect: 9:16.
[No style description needed — moodboard + preset handle it.]

Moodboard as a Prompt Modifier

When you want to write the moodboard's style into the prompt directly (rather than using the UI), use this structure:

Copy code
[MOODBOARD: Project Name]
Color palette: [2–3 dominant colors]
Tone: [warm/cool + emotional register]
Film look: [sensor/grain if applicable]
Lighting character: [quality of light]
Cultural reference: [specific aesthetic if using a curated preset]

Example — Y2K Studio:

Copy code
[MOODBOARD: Summer Campaign]
Color palette: electric blue backdrop, metallic silver, iridescent highlights
Tone: hyper-energized, maximalist, unserious
Film look: early 2000s digital — slightly blown highlights, vivid saturation
Lighting character: hard studio flash, colorful gels
Cultural reference: Y2K maximalism, early internet fashion

Example — Theatrical Light:

Copy code
[MOODBOARD: Dark Portrait Series]
Color palette: deep black, single amber key light, deep shadow fill
Tone: mysterious, composed, high-drama
Film look: medium format digital, razor-sharp
Lighting character: single hard source, theatrical — all else falls to black
Cultural reference: stage photography, Helmut Newton editorial

Related skills

• higgsfield-soul — Soul ID character consistency (combine with Moodboard for full visual lock)
• higgsfield-style — Visual styles and color grades
• higgsfield-mixed-media — Artistic preset overlays
• higgsfield-pipeline — Pipeline B uses Moodboard as a core stage
• templates/ — Annotated genre templates demonstrating style direction