Frequently Asked Questions

BreznFlow is a free WordPress plugin that turns n8n workflow JSON exports into interactive, zoomable diagrams. You import a workflow JSON, embed it with a shortcode, and your readers can click nodes, zoom in, and explore the full workflow — all without leaving your page.

Yes. BreznFlow is GPL-2.0, free to download from WordPress.org, and has no pro version, no upsells, and no subscription. It's funded by the author's own use case.

WordPress 6.0 or newer, PHP 8.0 or newer. No other dependencies. No external API calls are made during rendering.

Yes. Export your workflow from n8n Cloud exactly like you would from a self-hosted instance: open the workflow, click the menu → Download. The exported JSON is identical regardless of where n8n runs.

Yes. Mouse wheel zooms to the cursor position. Click and drag to pan. On touch devices, pinch-to-zoom and swipe work. Zoom range is 10% to 500%.

A detail panel slides in showing the node's parameters in a readable format. Long code snippets are truncated with a "show more" option. Credential IDs and API keys are masked.

Yes. Use multiple shortcodes: [breznflow id="1"] and [breznflow id="2"]. Each one renders independently. Each gets its own minimap, zoom state, and controls.

Yes. The mode attribute controls this: mode="visual" (default) shows the full interactive diagram, mode="compact" hides the action bar, and mode="info" shows a node list instead of the diagram.

Five themes: Dark (default), Light, Minimal (clean white, soft palette), Tech (GitHub Dark inspired), and Brezn (Bavarian blue). Select with theme="minimal" in the shortcode.

Yes. Use the Theme Generator — 41 color tokens with color pickers and a live preview. Export to .breznflow.json and upload to WordPress.

In WordPress admin, go to BreznFlow → Themes → Import Theme, upload your .breznflow.json file. It then appears in the theme dropdown in shortcodes and in Settings.

They cover: canvas background, node background/text/border, connection lines, toolbar, detail panel, buttons, action bar, modals (10 tokens), tooltip, minimap, and 7 node category colors (Trigger, HTTP, Code, Logic, Database, AI, Fallback). See the full table in the docs.

Opens a modal with two copy buttons: one copies the full article URL, the other copies a direct anchor link to the workflow (e.g. https://yoursite.com/post/#breznflow-1). Enable with show_share="1" or in Settings.

Opens a modal with an iframe code snippet that embeds the workflow on any external site. The embed loads BreznFlow's standalone renderer — no WordPress needed on the embedding side. Enable with show_embed="1".

Shows the sanitized workflow JSON with syntax highlighting and the file size. Visitors can copy it. The JSON is the same masked/sanitized version stored in WordPress — not the raw original. Enable with show_get_json="1".

Globally: BreznFlow → Settings — toggle allow_share, allow_embed, allow_get_json. Per-shortcode: show_share="1", show_embed="1", show_get_json="1". Per-post override via the post meta box.

No. BreznFlow automatically masks Authorization header values, credential IDs, and names during import. Masked values are stored as *** in the WordPress database and shown as *** in the rendered diagram and JSON export.

No. BreznFlow is a pure renderer. It has no connection to n8n, makes no API calls, and cannot execute workflows. It only draws a diagram based on the stored JSON data.

Only to mask sensitive values (credentials, authorization headers). The structure, nodes, connections, and all non-sensitive parameters are stored as-is. The masking is one-way — the original values are not stored anywhere in WordPress.