What does the Divide Ratio control?

It defines the relative size of each region. For columns or rows, comma-separated numbers set the proportions (e.g. 1,2 makes the second region twice as wide). For matrix mode, a semicolon separates rows and commas separate columns within each row.

How does the BREAK keyword work?

Regional Prompter splits your prompt at each BREAK. The first block maps to the first region, the second block to the second region, and so on, in the layout's reading order. Keep each block focused on the subject for that region.

What is the Base prompt for?

The Base prompt applies globally across all regions. Put shared elements there — overall style, lighting, color grade — so you don't repeat them in every region block. Per-region blocks then only describe what differs.

When should I use matrix layout?

Matrix mode is for grids — a 2×2 layout of four subjects, or a full-width band over a row of subjects below. Use columns or rows for simpler left-right or top-bottom compositions.

Regional Prompter Composition Guide

Controlling composition with Regional Prompter

Regional Prompter is an Automatic1111 extension that lets you point different prompts at different parts of the canvas — a knight on the left, a dragon on the right, a sunset sky above a city below. Instead of fighting a single prompt that blends everything together, you define regions and give each one its own description. This tool generates the exact split mode, divide ratio, and a BREAK-separated prompt template for the layout you choose.

How it works

You pick the number of regions and a layout. The tool maps that to Regional Prompter’s settings: the split mode (Columns, Rows, or Matrix), the Divide Ratio string that proportions the regions, and a prompt template where each block separated by BREAK corresponds to one region in reading order. For matrix layouts it uses the ; row separator and , column separator syntax the extension expects, so the ratio is always valid.

Tips for reliable regions

Use a Base prompt for shared style. Put global lighting, medium, and color grade in Base; keep per-region blocks about subjects only.
Keep region blocks distinct. Overlapping descriptions bleed between regions — make each subject clearly different.
Match block order to layout. Columns read left-to-right, rows top-to-bottom, matrix row-by-row. The template already orders them correctly.
Adjust the ratio for emphasis. Change a 1,1 to 1,2 to give one region more canvas when a subject needs more room.