Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Advanced Prompt Syntax
description: Fine control over prompts — attention weighting, blending and conjunctions for SD 1.5, SD 2.x and SDXL, and the advanced dynamic prompt syntax for multiple choices, weights, variables and comments.
lastUpdated: 2026-09-30
lastUpdated: 2026-10-15
sidebar:
order: 3
---
Expand All @@ -13,7 +13,7 @@ Most prompts need nothing more than plain text, perhaps with a [prompt template]
Attention weighting makes parts of the prompt count for more or less than the rest. It uses Compel syntax, which applies to **SD 1.5, SD 2.x and SDXL**. Newer model families, including FLUX, Z-Image, CogView4 and Qwen Image, do not use it, and the symbols are passed to the model as ordinary text.

:::note[Compatibility note]
If a weighted prompt seems to be ignored, check which model you are using. The syntax in this section only affects SD 1.5, SD 2.x and SDXL.
If a weighted prompt seems to be ignored, check which model you are using. The syntax in this section only affects SD 1.5, SD 2.x and SDXL. The prompt field colors weights, groups and embeddings only while one of those models is selected; with any other model, or none, they appear as plain text.
:::

| Syntax | Effect |
Expand Down Expand Up @@ -55,7 +55,7 @@ Groups can be nested, and the weights combine. In `(portrait with (blue eyes)1.3

### Adjusting weights with the keyboard

In a prompt field, select text and press **Ctrl+Up** or **Ctrl+Down** to raise or lower its attention. With no selection, the shortcut targets the word at the cursor. Selecting a group's parentheses or weight targets its contents.
In a prompt field, select text and press **Ctrl+Up** or **Ctrl+Down** to raise or lower its attention. With no selection, the shortcut targets the word at the cursor. Selecting a group's parentheses or weight targets its contents. The shortcut works while an SD 1.5, SD 2.x or SDXL model is selected; with any other model the keys keep their usual text-editing behavior.

- A selection inside a group changes only the selected words. A selection crossing a group boundary changes the selected words on both sides.
- Symbolic weights move one `+` or `-` step. Numeric weights change by `0.1` of effective attention, including inherited group weights.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Gallery Reference
description: Details of the Gallery — the board menu, archiving, downloading and deleting boards, the media menu, Gallery settings and keyboard shortcuts.
lastUpdated: 2026-10-05
lastUpdated: 2026-10-15
sidebar:
order: 2
---
Expand Down Expand Up @@ -104,7 +104,14 @@ These work while the Gallery has focus:
| **Escape** | Clear the selection |
| **.** (period) | Star or unstar the selection |
| **Delete** / **Backspace** | Delete the selection |
| **A** | Recall all of the selected image's settings |
| **R** | Remix the selected image: recall its settings, except the seed |
| **P** | Recall the selected image's prompts |
| **S** | Recall the selected image's seed |
| **D** | Use the selected image's size |
| **W** | Load the workflow saved with the selected image |

**A**, **R**, **P**, **S**, **D** and **W** also work while the Preview has focus.

On macOS, use **Cmd** in place of **Ctrl**. See [Hotkeys](/users-guide/workbench/hotkeys/) for all shortcuts.

Original file line number Diff line number Diff line change
Expand Up @@ -252,6 +252,7 @@
"source:src/platform/ui/colorPickerStore.ts",
"source:src/platform/ui/colorPickerSync.ts",
"source:src/platform/ui/hints/FeatureHint.tsx",
"source:src/platform/ui/hints/hintGeometry.ts",
"source:src/platform/ui/hints/hintRegistry.ts",
"source:src/platform/ui/hints/hintsContext.tsx",
"source:src/platform/ui/hints/index.ts",
Expand Down Expand Up @@ -559,6 +560,7 @@
"source:src/features/generation/core/projectPromptDraft.ts",
"source:src/features/generation/core/prompt/ast.ts",
"source:src/features/generation/core/prompt/attention.ts",
"source:src/features/generation/core/prompt/compel.ts",
"source:src/features/generation/core/promptHistory.ts",
"source:src/features/generation/core/promptTemplates.ts",
"source:src/features/generation/core/referenceImage.ts",
Expand Down Expand Up @@ -791,6 +793,7 @@
"source:src/platform/ui/colorPickerStore.ts",
"source:src/platform/ui/colorPickerSync.ts",
"source:src/platform/ui/hints/FeatureHint.tsx",
"source:src/platform/ui/hints/hintGeometry.ts",
"source:src/platform/ui/hints/hintRegistry.ts",
"source:src/platform/ui/hints/hintsContext.tsx",
"source:src/platform/ui/hints/index.ts",
Expand Down Expand Up @@ -1063,6 +1066,7 @@
"source:src/workbench/widgets/canvas/bboxGrid.ts",
"source:src/workbench/widgets/canvas/canvasSettings.ts",
"source:src/workbench/widgets/canvas/invoke/canvasCompositing.ts",
"source:src/workbench/widgets/canvas/invoke/canvasScaling.ts",
"source:src/workbench/widgets/canvas/invoke/canvasStrength.ts",
"source:src/workbench/widgets/canvas/manifest.ts",
"source:src/workbench/widgets/canvas/settingsContribution.ts",
Expand Down
29 changes: 19 additions & 10 deletions invokeai/frontend/webv2/performance/browser-baseline.json
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@
"fontRawBytes": 23664,
"imageRawBytes": 0,
"largestAssetRawBytes": 752421,
"otherRawBytes": 211323,
"otherRawBytes": 216879,
"requestCount": 30,
"scriptRawBytes": 1852857,
"scriptRequestCount": 26,
Expand Down Expand Up @@ -68,7 +68,7 @@
"fontRawBytes": 23664,
"imageRawBytes": 0,
"largestAssetRawBytes": 752421,
"otherRawBytes": 211323,
"otherRawBytes": 216879,
"requestCount": 30,
"scriptRawBytes": 1852857,
"scriptRequestCount": 26,
Expand Down Expand Up @@ -106,7 +106,7 @@
"fontRawBytes": 23664,
"imageRawBytes": 44398,
"largestAssetRawBytes": 752421,
"otherRawBytes": 211323,
"otherRawBytes": 216879,
"requestCount": 88,
"scriptRawBytes": 4131338,
"scriptRequestCount": 83,
Expand Down Expand Up @@ -144,7 +144,7 @@
"fontRawBytes": 23664,
"imageRawBytes": 44398,
"largestAssetRawBytes": 752421,
"otherRawBytes": 211323,
"otherRawBytes": 216879,
"requestCount": 88,
"scriptRawBytes": 4131338,
"scriptRequestCount": 83,
Expand Down Expand Up @@ -182,7 +182,7 @@
"fontRawBytes": 23664,
"imageRawBytes": 44398,
"largestAssetRawBytes": 752421,
"otherRawBytes": 211323,
"otherRawBytes": 216879,
"requestCount": 97,
"scriptRawBytes": 4647483,
"scriptRequestCount": 92,
Expand Down Expand Up @@ -220,7 +220,7 @@
"fontRawBytes": 23664,
"imageRawBytes": 44398,
"largestAssetRawBytes": 752421,
"otherRawBytes": 211323,
"otherRawBytes": 216879,
"requestCount": 97,
"scriptRawBytes": 4647483,
"scriptRequestCount": 92,
Expand Down Expand Up @@ -258,7 +258,7 @@
"fontRawBytes": 23664,
"imageRawBytes": 44398,
"largestAssetRawBytes": 752421,
"otherRawBytes": 211323,
"otherRawBytes": 216879,
"requestCount": 95,
"scriptRawBytes": 4575049,
"scriptRequestCount": 89,
Expand Down Expand Up @@ -296,7 +296,7 @@
"fontRawBytes": 23664,
"imageRawBytes": 44398,
"largestAssetRawBytes": 752421,
"otherRawBytes": 211323,
"otherRawBytes": 216879,
"requestCount": 95,
"scriptRawBytes": 4575049,
"scriptRequestCount": 89,
Expand Down Expand Up @@ -334,7 +334,7 @@
"fontRawBytes": 23664,
"imageRawBytes": 44398,
"largestAssetRawBytes": 752421,
"otherRawBytes": 211323,
"otherRawBytes": 216879,
"requestCount": 88,
"scriptRawBytes": 4131338,
"scriptRequestCount": 83,
Expand Down Expand Up @@ -372,7 +372,7 @@
"fontRawBytes": 23664,
"imageRawBytes": 44398,
"largestAssetRawBytes": 752421,
"otherRawBytes": 211323,
"otherRawBytes": 216879,
"requestCount": 88,
"scriptRawBytes": 4131338,
"scriptRequestCount": 83,
Expand Down Expand Up @@ -663,6 +663,7 @@
"source:src/platform/ui/colorPickerStore.ts",
"source:src/platform/ui/colorPickerSync.ts",
"source:src/platform/ui/hints/FeatureHint.tsx",
"source:src/platform/ui/hints/hintGeometry.ts",
"source:src/platform/ui/hints/hintRegistry.ts",
"source:src/platform/ui/hints/hintsContext.tsx",
"source:src/platform/ui/hints/index.ts",
Expand Down Expand Up @@ -983,6 +984,7 @@
"source:src/features/generation/core/projectPromptDraft.ts",
"source:src/features/generation/core/prompt/ast.ts",
"source:src/features/generation/core/prompt/attention.ts",
"source:src/features/generation/core/prompt/compel.ts",
"source:src/features/generation/core/prompt/dynamicPromptSyntax.ts",
"source:src/features/generation/core/prompt/highlight.ts",
"source:src/features/generation/core/promptHistory.ts",
Expand Down Expand Up @@ -1334,6 +1336,7 @@
"source:src/platform/ui/colorPickerStore.ts",
"source:src/platform/ui/colorPickerSync.ts",
"source:src/platform/ui/hints/FeatureHint.tsx",
"source:src/platform/ui/hints/hintGeometry.ts",
"source:src/platform/ui/hints/hintRegistry.ts",
"source:src/platform/ui/hints/hintsContext.tsx",
"source:src/platform/ui/hints/index.ts",
Expand Down Expand Up @@ -1772,6 +1775,7 @@
"source:src/workbench/widgets/canvas/bboxGrid.ts",
"source:src/workbench/widgets/canvas/canvasSettings.ts",
"source:src/workbench/widgets/canvas/invoke/canvasCompositing.ts",
"source:src/workbench/widgets/canvas/invoke/canvasScaling.ts",
"source:src/workbench/widgets/canvas/invoke/canvasStrength.ts",
"source:src/workbench/widgets/canvas/manifest.ts",
"source:src/workbench/widgets/canvas/settingsContribution.ts",
Expand Down Expand Up @@ -2076,6 +2080,7 @@
"source:src/features/generation/core/projectPromptDraft.ts",
"source:src/features/generation/core/prompt/ast.ts",
"source:src/features/generation/core/prompt/attention.ts",
"source:src/features/generation/core/prompt/compel.ts",
"source:src/features/generation/core/prompt/dynamicPromptSyntax.ts",
"source:src/features/generation/core/prompt/highlight.ts",
"source:src/features/generation/core/promptHistory.ts",
Expand Down Expand Up @@ -2432,6 +2437,7 @@
"source:src/platform/ui/colorPickerStore.ts",
"source:src/platform/ui/colorPickerSync.ts",
"source:src/platform/ui/hints/FeatureHint.tsx",
"source:src/platform/ui/hints/hintGeometry.ts",
"source:src/platform/ui/hints/hintRegistry.ts",
"source:src/platform/ui/hints/hintsContext.tsx",
"source:src/platform/ui/hints/index.ts",
Expand Down Expand Up @@ -3328,6 +3334,7 @@
"source:src/features/generation/core/projectPromptDraft.ts",
"source:src/features/generation/core/prompt/ast.ts",
"source:src/features/generation/core/prompt/attention.ts",
"source:src/features/generation/core/prompt/compel.ts",
"source:src/features/generation/core/prompt/dynamicPromptSyntax.ts",
"source:src/features/generation/core/prompt/highlight.ts",
"source:src/features/generation/core/promptHistory.ts",
Expand Down Expand Up @@ -3755,6 +3762,7 @@
"source:src/platform/ui/colorPickerStore.ts",
"source:src/platform/ui/colorPickerSync.ts",
"source:src/platform/ui/hints/FeatureHint.tsx",
"source:src/platform/ui/hints/hintGeometry.ts",
"source:src/platform/ui/hints/hintRegistry.ts",
"source:src/platform/ui/hints/hintsContext.tsx",
"source:src/platform/ui/hints/index.ts",
Expand Down Expand Up @@ -4193,6 +4201,7 @@
"source:src/workbench/widgets/canvas/bboxGrid.ts",
"source:src/workbench/widgets/canvas/canvasSettings.ts",
"source:src/workbench/widgets/canvas/invoke/canvasCompositing.ts",
"source:src/workbench/widgets/canvas/invoke/canvasScaling.ts",
"source:src/workbench/widgets/canvas/invoke/canvasStrength.ts",
"source:src/workbench/widgets/canvas/manifest.ts",
"source:src/workbench/widgets/canvas/settingsContribution.ts",
Expand Down
74 changes: 61 additions & 13 deletions invokeai/frontend/webv2/public/locales/en.json
Original file line number Diff line number Diff line change
Expand Up @@ -801,13 +801,6 @@
"title": "Hotkeys"
},
"hints": {
"aspectRatio": {
"heading": "Aspect Ratio",
"paragraphs": [
"The aspect ratio of the dimensions of the image generated.",
"An image size (in number of pixels) equivalent to 512x512 is recommended for SD1.5 models and a size equivalent to 1024x1024 is recommended for SDXL models."
]
},
"cfgRescale": {
"heading": "CFG Rescale Multiplier",
"paragraphs": [
Expand Down Expand Up @@ -845,12 +838,35 @@
"Gain scales the whole stack afterwards, which counteracts the quality dilution from distillation. Leave both at the defaults unless prompt adherence is the problem you are solving."
]
},
"conditioningRebalanceGain": {
"heading": "Rebalance gain",
"paragraphs": [
"Overall gain applied to the conditioning after per-layer weighting. Higher values push harder toward the prompt.",
"Default is 4.0. Very high values may over-saturate or distort the output."
]
},
"controlLayerWeight": {
"heading": "Control Layer Weight",
"paragraphs": [
"Adjusts how strongly the layer influences the generation process.",
"• Higher Weight (.75-2): Creates a more significant impact on the final result.",
"• Lower Weight (below .75): Creates a smaller impact on the final result. The slider stops at 0; models that allow it accept typed weights down to -1."
]
},
"creativity": {
"heading": "Creativity",
"paragraphs": [
"Creativity controls the amount of freedom granted to the model when adding details. Low creativity stays close to the original image, while high creativity allows for more change. When using a prompt, high creativity increases the influence of the prompt."
]
},
"denoisingStrength": {
"heading": "Denoising Strength",
"paragraphs": [
"Controls how much the generated image varies from the raster layers.",
"Lower strength stays closer to the combined visible raster layers. Higher strength relies more on the global prompt.",
"When there are no raster layers with visible content, this setting is ignored."
]
},
"guidance": {
"heading": "Guidance",
"paragraphs": [
Expand Down Expand Up @@ -890,11 +906,10 @@
]
},
"imageInfluence": {
"heading": "Denoising Strength",
"heading": "Image Influence",
"paragraphs": [
"Controls how much the generated image varies from the raster layers.",
"Lower strength stays closer to the combined visible raster layers. Higher strength relies more on the global prompt.",
"When there are no raster layers with visible content, this setting is ignored."
"How strongly a FLUX Redux reference image steers the generation, from Lowest to Highest.",
"Lower settings leave more room for the prompt. Highest follows the reference most closely."
]
},
"hidiffusion": {
Expand Down Expand Up @@ -932,6 +947,27 @@
"Can boost local detail, but may affect global coherence."
]
},
"seedVariance": {
"heading": "Seed variance",
"paragraphs": [
"Distilled few-step models like Krea-2-Turbo can produce nearly identical images across different seeds. This adds seed-based noise to the text embeddings to increase variation while staying reproducible.",
"Enable this to get more diverse results when exploring seeds, at some cost to prompt adherence."
]
},
"seedVarianceRandomize": {
"heading": "Randomized channels",
"paragraphs": [
"Percentage of embedding values that receive noise (0-100%); 0 disables.",
"Lower values create more selective perturbations, while 100% affects all values."
]
},
"seedVarianceStrength": {
"heading": "Variance strength",
"paragraphs": [
"Noise strength as a multiplier of the embedding's standard deviation, so it behaves consistently regardless of the embedding scale (including whether conditioning rebalance is on).",
"0 is off, 0.1 is subtle, 0.5 is strong. Higher values give more variety but drift further from the prompt."
]
},
"layerStackControl": {
"heading": "Control Layers",
"paragraphs": [
Expand Down Expand Up @@ -960,6 +996,10 @@
"Painted regions scope their prompts and reference images to just that area of the canvas."
]
},
"loraWeight": {
"heading": "LoRA Weight",
"paragraphs": ["Weight of the LoRA. Higher weight will lead to larger impacts on the final image."]
},
"model": {
"heading": "Model",
"paragraphs": [
Expand All @@ -970,7 +1010,7 @@
"heading": "Negative Prompt",
"paragraphs": [
"The generation process avoids the concepts in the negative prompt. Use this to exclude qualities or objects from the output.",
"Supports Compel syntax and embeddings."
"Compel attention weighting and embeddings work with SD 1.5, SD 2.x and SDXL only."
]
},
"pidMode": {
Expand All @@ -986,7 +1026,7 @@
"heading": "Positive Prompt",
"paragraphs": [
"Guides the generation process. You may use any words or phrases.",
"Compel and Dynamic Prompts syntaxes and embeddings."
"Dynamic Prompts syntax works with every model. Compel attention weighting and embeddings work with SD 1.5, SD 2.x and SDXL only."
]
},
"qwen35Encoder": {
Expand Down Expand Up @@ -1039,6 +1079,14 @@
"Disable the \"Random\" option to produce identical results with the same generation settings."
]
},
"stepRange": {
"heading": "Begin / End Step Percentage",
"paragraphs": [
"This setting determines which portion of the denoising (generation) process incorporates this guidance.",
"• Start Step (%): Specifies when to begin applying this guidance during the generation process.",
"• End Step (%): Specifies when to stop applying this guidance and revert to general guidance from the model and other settings."
]
},
"steps": {
"heading": "Steps",
"paragraphs": [
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,6 @@ export {
export { NegativePromptField } from './ui/promptFields/NegativePromptField';
export { PositivePromptField } from './ui/promptFields/PositivePromptField';
export { PromptTextarea } from './ui/promptFields/PromptTextarea';
export { PROMPT_ATTENTION_TARGET_PROPS } from './ui/promptFields/promptAttentionHotkeys';
export { SeedField, type SeedFieldProps } from './ui/shared/SeedField';
export { FluxReduxControls } from './ui/reference-images/ReferenceImageControls';
export { GenerateCollapsibleSection as GenerationSettingsSection } from './ui/shared/GenerateCollapsibleSection';
Expand Down
Loading
Loading