Records are durable, markdown-backed docs — Persona, Brand, Business, or Doc — that live in your workspace and feed your flows. They can be scoped to one project or shared org-wide, and every edit archives the previous version first.
Where: flowGen → Asset Browser → Records section — Click "New ▾" in the Records header and pick a kind
Key ideas
- Four kinds: Persona, Brand, Business, and Doc (generic). Each renders its own card and its own create/edit dialog in the Records section.
- Body + structured fields: A record's markdown is the BODY (a persona's system prompt, a brand's brand book, a business profile). Typed fields — role, model, colors, logo, business name — ride alongside as structured metadata.
- Org vs project scope: A record is either org-scoped (shared across every project in the org) or scoped to the current project. The "Org-scoped" checkbox on the New dialog sets this; the card shows a "· org" tag for org-scoped records.
- Non-destructive edits: Every save archives the record's previous content before overwriting it — you never lose the old copy. Records nodes read the latest content on demand.
- Export a Brand as a brand book: Brand records can be exported as a designed HTML brand book, Markdown, or a print-ready document. The HTML export uses the Brand record’s own design system, including its colors and typography, and presents the logo, name, and prose as a readable editorial document rather than a raw list of fields.
Steps
- Open the Asset Browser in your flowGen project and scroll to the Records section.
- Click "New ▾" and choose Persona, Brand, Business, or Doc.
- Fill the title, the kind-specific fields, and the markdown body, then Save.
- Leave "Org-scoped" unchecked to keep the record in this project, or check it to share it across every project in the org.
- To reuse a record on the canvas, use "Add to canvas" (the rocket icon on a card, or the right-click menu), or add a Record (read) node and bind it.
- For a Brand record, open its export menu and choose Download brand book for a shareable HTML file; choose Markdown or Print / Save as PDF when you need those formats.
- Choose or create a named record from the card, confirm its field rail, then connect record_in to an exposed mini-app question if the person running the flow should choose the record.
Typed entities and selecting a record on the card
Brain Read now has record_in to choose which record it binds, and the picker is available on the card with inline New actions. Brand includes its design system and separate web/video CSS, HTML, and motion. Product, Character, and Place add typed visual, voice, 3D, HDRI, and audio fields instead of hiding everything in a prose body.
FAQ
What is the difference between a Record and an asset?
A record is a markdown-backed document (a persona, brand book, or profile) that nodes bind to and read live. Assets are media files. Records have their own section in the Asset Browser.
Can I share a record between projects?
Yes — check "Org-scoped" when you create it, or scope it to a single project. Org-scoped records show a "· org" tag and appear in every project in the org.
Related guides
- Personas: create and use
- Brain Brand and Business records: fields, references, and project links
- Packages: bundle and publish
- Flowgen canvas: cards, node graph, typed inputs, and running a workflow
- Brain entity presets: Brand, Product, Character, and Place
- Let a mini-app question choose a Brain record