Axis To String
How prompt grids actually work in qq-nodes
- axis
- STRING
Text is the axis type people sweep most often, and this is the node that makes it real. Feed a list of prompts into the XY Grid Helper's row list, and each row's current prompt comes out of the helper as an opaque AXIS_VALUE. Axis To String converts that to an actual STRING, which you then wire into CLIP Text Encode. Row by row you get a grid where every image uses a different prompt - the classic "prompt on one axis, CFG on the other" layout from the README's example workflow.
The mechanism is the same for every converter in this family: one required axis input (AXIS_VALUE), no optional inputs, and a single STRING output. It doesn't format, truncate or clean anything. It just hands you the current row/column value as text, and all the shaping happens elsewhere.
Where it gets genuinely useful is pairing it with the pack's text tooling. Text Splitter takes one string and splits it on a delimiter into a LIST - so a single "hero;villain;robot" line becomes three rows. Load Lines From Text File reads a .txt from your input/ folder into a LIST, one prompt per line, which is how you run a real prompt batch instead of typing lists into the graph. Both feed the helper's row/column lists; Axis To String sits on the other side, converting back.
Keep one thing straight: this is the title-case spelling of the same node you'll also find registered as "Axis To STRING." Identical schema - axis in, STRING out. The pack builds every Axis To converter from axis-config.json at startup, which is where the all-caps names come from; comfy.icu hosts both spellings and they behave exactly the same.
It's part of the qq-nodes pack, so install is:
cd ComfyUI/custom_nodes
git clone https://github.com/kenjiqq/qq-nodes-comfyui
or via Manager (search "qq-nodes-comfyui"), then restart. No models to download, no exotic Python deps. If you want the final assembled grid you'll also need LEv145/images-grid-comfy-plugin - the grid nodes call it in behind the scenes.
Troubleshooting is mostly workflow habits rather than this node. Click Reset on the XY Grid Helper before a run, then queue one prompt per grid cell; the button counts "X of Y". If your prompt grid silently regenerates the same image, you've forgotten the reset and the helper's index is still counting from the previous run. If you need the string converted to something else - a number, a seed, a model name - the README's own advice is to follow Axis To String with a converter like WAS nodes rather than expect this node to do double duty. And keep the pack updated: older releases had a frontend break on newer ComfyUI (structuredClone error around the reset button) that's fixed in the current JS.
Inputs (1)
| Name | Type | Default | Description |
|---|---|---|---|
| axis | AXIS_VALUE | — |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| STRING | STRING | — |