> ## Documentation Index > Fetch the complete documentation index at: https://docs.bfl.ml/llms.txt > Use this file to discover all available pages before exploring further. # Single-Reference Editing > Write edit instructions for one image in FLUX 3 Image: name the target, say what changes and what stays, specify colors with hex codes, quote new text, and know when to switch to box rows. Includes a catalog of edit types. export const PromptDisplay = ({prompt}) => { const [copied, setCopied] = useState(false); const copy = () => { navigator.clipboard.writeText(prompt); setCopied(true); setTimeout(() => setCopied(false), 2000); }; return

{prompt}

; }; export const ImageComparisonSlider = ({beforeImage, afterImage, beforeLabel = "Before", afterLabel = "After", height = "500px", objectFit = "cover", garmentImage, garmentLabel = "Garment reference"}) => { const [position, setPosition] = useState(50); const dialogRef = useRef(null); const openLightbox = () => { if (dialogRef.current && typeof dialogRef.current.showModal === "function") { dialogRef.current.showModal(); } }; const closeLightbox = () => { if (dialogRef.current && typeof dialogRef.current.close === "function") { dialogRef.current.close(); } }; const getPosition = (e, container) => { const rect = container.getBoundingClientRect(); const clientX = e.touches ? e.touches[0].clientX : e.clientX; const x = clientX - rect.left; return Math.max(0, Math.min(100, x / rect.width * 100)); }; const onPointerDown = e => { e.preventDefault(); e.stopPropagation(); const container = e.currentTarget; setPosition(getPosition(e, container)); const onMove = ev => { ev.preventDefault(); setPosition(getPosition(ev, container)); }; const onUp = () => { window.removeEventListener("mousemove", onMove); window.removeEventListener("mouseup", onUp); window.removeEventListener("touchmove", onMove); window.removeEventListener("touchend", onUp); }; window.addEventListener("mousemove", onMove); window.addEventListener("mouseup", onUp); window.addEventListener("touchmove", onMove, { passive: false }); window.addEventListener("touchend", onUp); }; return
{ e.preventDefault(); e.stopPropagation(); }} style={{ position: "relative", width: "100%", height, overflow: "hidden", cursor: "ew-resize", userSelect: "none", WebkitUserSelect: "none" }}> {} {afterLabel} {}
{beforeLabel}
{}
{}
{} {}
{}
{beforeLabel}
{afterLabel}
{} {garmentImage &&
e.stopPropagation()} onTouchStart={e => e.stopPropagation()} onClick={e => { e.preventDefault(); e.stopPropagation(); openLightbox(); }} title={`${garmentLabel} — click to enlarge`} style={{ position: "absolute", bottom: "12px", right: "12px", height: "140px", maxWidth: "40%", borderRadius: "8px", overflow: "hidden", cursor: "zoom-in", background: "rgba(255,255,255,0.95)", border: "2px solid rgba(255,255,255,0.9)", boxShadow: "0 2px 12px rgba(0,0,0,0.45)", zIndex: 5, display: "flex", alignItems: "center", justifyContent: "center" }}> {garmentLabel}
}
{} {garmentImage &&
{garmentLabel} e.stopPropagation()} style={{ maxWidth: "90vw", maxHeight: "90vh", objectFit: "contain", borderRadius: "8px", boxShadow: "0 8px 32px rgba(0,0,0,0.6)", cursor: "default" }} />
}
; }; Send one image in `images` and describe the change in `prompt`. For the request format, see [Image editing](/guides/prompting_editing_overview). ## Write the instruction Write the instruction in three parts: 1. **Name the target precisely enough that only one thing matches.** For a flock, specify the bird's position and appearance. Pick it out by position, size, color, or what it's next to. 2. **Say what changes, and into what.** "Replace the flower with a slice of lemon." "Change the jacket from red to blue." Name the element as it is now and as it should be. 3. **Name any details that matter.** When a specific detail must stay, name it: "keep her pose", "keep the lace embroidery white". ### FLUX 3 example: recolor two elements, keep the rest The prompt names both targets by what they are ("the large tiger", "the small glowing butterfly"), states the change once, and lists the three things that must not change. The tiger's stripes, the snow on its fur, and the butterfly's glow carry over; only the color changes. This example comes from the FLUX 3 launch post, where it was sent with box rows: `` is the first image in `images`, and each `` token matches a row at the end of the prompt. [Edit with boxes](/flux_3/flux3_image_bounding_boxes#edit-an-image) shows the full rows. For a plain written edit, keep the same sentence structure and leave out the tokens. ## Specify colors, text, and positions Words like "pink" or "near the top" leave room for interpretation. When the exact value matters, write the value: | To get | Write | Example | | - | - | - | | A target color | A hex code | “change the color of only one bird in the middle to #e01075” | | Exact words | The text in quotes, plus where it goes | “Change the text on the neon sign to ‘zum Schlappen’” | | A specific place | A region of the frame | “On the lower left path, replace the tiny wolf with a cyberpunk dog” | | A preserved detail | The detail by name | “keeping all lace embroidery details white and fully visible” | FLUX 3 renders text in images, including multi-line poster typography. For a text edit, quote the exact words and describe their placement and style ("in handwritten pink marker, diagonally across the top photo"). ## Make several changes in one prompt For a multi-part edit, write an edit record: name the image and the operation, give each change with its location, then list what stays. This is the pattern the FLUX 3 launch examples use: 1. **Name the image and the operation.** "Modify `` by making three replacements." 2. **Give each change: where, what, and into what.** "On the lower left path, replace the tiny anthropomorphic wolf with a cyberpunk dog." 3. **List what stays.** "Keep the rest of the scene exactly unchanged, preserving the stone lantern, the frozen stream…" ### FLUX 3 example: three replacements at once Each replacement names its location and subject to distinguish the targets. The preserve list names every major element of the scene, not only "the rest of the image". This edit was also sent with box rows; [Edit with boxes](/flux_3/flux3_image_bounding_boxes#edit-an-image) has the full request. ## When to switch to box rows A written instruction is enough when only one thing in the image matches your description. Add box rows to the prompt when: * Several similar things match and you want to change one of them, such as one car in a row of parked cars. * The change needs an exact position or size. * You want to move or resize an element and keep it otherwise the same. * You want to remove one specific object and let FLUX 3 fill the space it leaves. * You want to keep specific elements in place while you change others. Each row names one element and gives its boxes on a 0–1000 grid: where it is in the source image and where it belongs in the output. [Edit with boxes](/flux_3/flux3_image_bounding_boxes#edit-an-image) explains the row types and has a complete request. ## Edit types The catalog below covers the most common single-image edits, each with the prompt that produced it. Results captioned "FLUX 3 Image" were generated with FLUX 3 Image. The rest were generated with FLUX.2. *** ### Background Replacement Change or replace the background while keeping the subject intact. Describe the new setting and its lighting so the subject fits into it. Input: bottle product photo Output: the Spritz bottle standing in a pile of wet strawberries on a white background Input: subject with original background Output: subject in cozy home environment *** ### Style Transfer Change the visual style or medium of an image, from illustration to photorealism or from photo to painting. Say what should keep its shape: "keep the proportions and layout exactly as in the illustration". Input: original photo Output: oil painting style Input: architectural illustration Output: photorealistic house Input: abstract artwork Output: mountain vista transformation *** ### Object Manipulation Add, remove, or replace objects in a scene. Be specific about what should change and what should stay. With FLUX 3 Image, if the object you want to remove or replace is one of several similar ones, use a [box row](/flux_3/flux3_image_bounding_boxes#edit-an-image) to point at it. Input: image with sprinkles Output: sprinkles removed Input: image with flower Output: flower replaced with lemon slice Input: gorge scene Output: goblins added to gorge wall Input: DJ scene Output: polar bear replaces DJ Input: jars with cherries Output: cherries replaced with sprinkles Input: moss-covered statues Output: clean stone statues Input: person on motorcycle Output: person on rearing black horse Input: portrait with feathers Output: portrait with rose petals *** ### Color & Material Changes Recolor specific elements or transform materials. Use a hex code to specify a target color, then check the result. Input: cow with natural colors Output: cow with custom colors Input: butterfly Output: silver butterfly Input: butterfly Output: ice butterfly *** ### Lighting, Weather & Season Changes Shift the time of day, season, or weather with a short instruction. Name the new condition plainly: "Change it to Night", "Change this to Winter". Input: scene in original season Output: winter scene Input: daytime scene Output: nighttime scene Input: scene with original lighting Output: warm autumn lighting *** ### Text Editing Add, replace, or modify text within images, from simple swaps to full ad layouts. Put the exact words in quotes and say where they go and how they should look. Input: image with original text Output: text changed to Flux.2 Input: neon sign with original text Output: neon sign with new text Input: shop scene Output: new neon sign and traffic light Input: fashion photo Output: fashion ad with text and CTA *** ### Virtual Try-On & Clothing Change outfits, add accessories, or adjust clothing colors. Useful for fashion and e-commerce. Input: woman in original outfit Output: the same woman in a fuchsia dress against a green studio gradient Input: woman without jacket Output: woman with fluffy jacket and hat Input: white lace wedding dress Output: sky blue lace wedding dress *** ### Pose & Expression Changes Adjust gaze direction, body pose, or facial expressions of subjects. Input: owl with closed eyes Output: owl with open eyes Input: woman looking away Output: woman looking at camera Input: woman in casual pose Output: woman in model pose *** ## Checklist: vague to specific | Instead of | Write | What it adds | | - | - | - | | “Make it better” | “Warm the light to late-afternoon sun and soften the shadows on her face. Keep the background unchanged.” | A concrete change and what stays | | “Change the shirt” | “Change the man’s grey T-shirt to #c0392b, keeping the print on the front.” | The target, the exact new value, a preserved detail | | “Remove the car” (with two cars in frame) | “Remove the white car parked on the right. Keep the red car and the street unchanged.” | Only one thing matches | | “Add some text” | “Add the words ‘Open late’ in white sans-serif letters on the shop window.” | The exact words, placement, and style | | “Fix the image” | “Open the owl’s eyes, making them look natural.” | The defect named | Combine up to 10 images in one FLUX 3 Image request. Target exact regions with box rows. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.