Docs Block Reference Instagent block

Instagent block

> Requires brand profile. Instagent reads Store Name, Description, > Industry, Audience, Tone, Value Prop, and Primary CTA from > Settings → Store Info. Fill those fields first. If any are missing, > generation fails with a list of what to fill.

Instagent is the AI section generator. Add the block to a page, write a brief, pick a section type, click Generate — the block is replaced with a fully built Impulse section.

Internal block type: section_generator Editor icon: aperture Frontend behaviour: renders nothing (editor-only placeholder; never appears on live site)

In-canvas card

The block appears as a dark card in the editor canvas:

| Field | Description | |---|---| | Brief | What this section needs — tone, focus, offer, audience. Required. Example: "push the spring sale, mention free shipping over $50" | | Section type | Dropdown — selects the section template family (see list below) | | Generate | Sends brief + type to Instagent → replaces block with built content |

Brief auto-saves after 0.6 s. Section type auto-saves immediately.

Section types

Hero · Features · Process · Pricing · FAQ · Call to action · Testimonial · About · Manifesto · Stats · Gallery · Team · Contact · Footer

Right-column panel

When the Instagent block is selected, the settings panel shows:

Brand Profile (read-only summary)

Pulled from Settings. Shown as stacked label/value rows:

| Field | Source | |---|---| | Industry | Settings → Store Info | | Audience | Settings → Store Info | | Tone | Settings → Store Info | | Value Prop | Settings → Store Info | | Primary CTA | Settings → Store Info |

"Not set" shown in dim grey for missing fields.

Edit profile in Settings → button opens Settings workspace directly.

Brand colours (editable inline)

| Field | Saved to | |---|---| | Brand primary | Site config — same key as Settings → Brand Primary | | Brand accent | Site config — same key as Settings → Brand Accent |

Changes write immediately to site config; no save button needed.

Per-section overrides

| Control | Description | |---|---| | Tone override | Overrides brand tone for this section only. Options: Inherit from brand (default) · Neutral · Friendly · Confident · Playful · Formal · Technical · Inspirational | | Must include | Comma-separated keywords Instagent must use in copy | | Exclude | Phrases Instagent must not write (e.g. "revolutionary, game-changing") |

Generation flow

  • User clicks Generate in the canvas card
  • Status shows "Composing…" with animated dots
  • Instagent (Claude via platform) receives: brief · section type · brand profile (industry, audience, tone, value prop, CTA, colours) · per-section overrides
  • Platform returns an element tree
  • Status shows template name: "Inserting 'Hero'…"
  • Tree is injected into the page; placeholder block is deleted
  • Result is a normal editable section — no Instagent state remains

    • Timeout: 45 s. If exceeded: "Timed out. Try again." Missing brand fields: "Set your store profile in Settings — missing: [field list]." with a link to open Settings.

    Do

    • Write a specific brief — the more context, the better the output
    • Use Must include to lock in specific offers, dates, or keywords
    • Use Exclude to ban corporate buzzwords or competitor names
    • Edit the generated section after it appears — Instagent output is a starting point

    Don't

    • Don't leave the brief empty — generation requires it
    • Don't expect generation without brand profile filled in Settings
    • Don't place multiple Instagent blocks and generate all at once without checking each result