Metadata Panel

The Metadata panel is your control center for managing prompt properties beyond the content itself. Access it by clicking the Tag icon in the editor header or pressing Cmd + Shift + M.

Panel Overview

The Metadata panel contains four main sections:

+---------------------------+
| VARIABLES                 |  <- Define template variables
|  + Add Variable           |
+---------------------------+
| INJECTIONS                |  <- View detected prompt references
|  [[ prompt-path ]] ✓      |
+---------------------------+
| TAGS                      |  <- Organize with labels
|  [tag1] [tag2] + Add      |
+---------------------------+
| SETTINGS                  |  <- Configure behavior
|  ○ Raw Content Mode       |
+---------------------------+
| [Render Preview]          |  <- Test rendering
+---------------------------+

Variables Section

Define and manage template variables that can be used in your prompt with {{ variableName }} syntax.

Auto-Detection

The panel automatically detects variables used in your content:

Your prompt contains: {{ userName }}

Variables section shows:
├── userName (detected, undefined) [+ Add]

Click + Add to quickly define detected variables.

Adding Variables Manually

1. Click + Add Variable in the Variables section
2. Fill in the variable details:

3. The variable is saved automatically

Variable Types

Variable Actions

Hover over any variable to see available actions:

Inherited Variables

Variables from parent folders appear with a lock icon and source label:

Variables
├── brand_name 🔒 (from: marketing)    <- Inherited
├── tone 🔒 (from: marketing)          <- Inherited
└── greeting                            <- Own variable

Actions for inherited variables:

• Override: Create a local copy to customize
• Unlock: Remove local override, revert to inherited value

Injections Section

View and validate all prompt injections detected in your content.

Detection

The panel finds all [[ path/to/prompt ]] references:

Your prompt contains: [[ personas/expert ]]

Injections section shows:
├── personas/expert ✓ Valid

Validation Status

Injection Actions

Error Messages

When validation fails, the panel shows helpful messages:

• "Prompt not found" — Check the path spelling
• "Circular dependency" — This prompt references itself (directly or indirectly)
• "Injection disabled" — The target prompt has disabled injection

Tags Section

Organize prompts with descriptive labels for easy filtering and discovery.

Adding Tags

1. Type a tag name in the input field
2. Press Enter or click Add
3. Tag appears as a chip

Tag Display

Tags appear as clickable chips:

Tags
[customer-support] [email] [v2] [+ Add]

Tag Actions

• Click tag: Copy tag name
• Click ✕: Remove tag (own tags only)

Inherited Tags

Tags from parent folders are merged with own tags:

Tags
[brand] 🔒           <- From parent folder
[email]              <- Own tag

Inherited tags show a lock icon and cannot be removed (only overridden at the folder level).

Settings Section

Configure prompt behavior and rendering options.

Raw Content Mode

Toggle: Disable Variable Substitution

When enabled:

• {{ variableName }} is preserved literally in output
• Variables are NOT replaced with values
• Useful for prompts that contain template syntax as content

Use cases:

• Code examples showing template syntax
• Jinja/Handlebars templates as prompt content
• Documentation about the variable system

Inherited Settings

Settings can be inherited from parent folders:

Settings
├── Raw Content Mode: OFF 🔒 (from: templates)
│   [Override] [Revert]

• Override: Set a different value for this prompt
• Revert: Remove override, use inherited value

Render Preview

Test your prompt rendering without running it through an AI model.

Opening the Modal

1. Click Render Preview at the bottom of the Metadata panel
2. Or press Cmd + Shift + R

The Render Modal

+----------------------------------------+
| RENDER PREVIEW                    [✕]  |
+----------------------------------------+
| Variables                              |
| ┌────────────────────────────────────┐ |
| │ userName: [_______________]        │ |
| │ company:  [_______________]        │ |
| │ isPremium: ☑                       │ |
| └────────────────────────────────────┘ |
+----------------------------------------+
| Rendered Output                        |
| ┌────────────────────────────────────┐ |
| │ Hello, Alice!                      │ |
| │ Welcome to Acme Corp.              │ |
| │ Premium features enabled.          │ |
| └────────────────────────────────────┘ |
+----------------------------------------+
| [Copy] [Download .md] [Re-render]      |
+----------------------------------------+

Features

What Gets Rendered

1. Injections resolved first: All [[ ]] references are replaced
2. Variables applied: All {{ }} expressions are evaluated
3. Final output shown: Ready-to-use prompt text

Variable Collection

The modal collects variables from:

• Current prompt’s defined variables
• All injected prompts’ variables
• Parent folder inherited variables

Variables show their source:

userName (from: current prompt)
brand_name (from: marketing folder)
tone (from: personas/expert)

Folder Metadata

Folders can have their own metadata that cascades to all contained prompts.

Editing Folder Metadata

1. Select a folder in the sidebar
2. The Metadata panel shows folder-specific options
3. Changes affect all prompts within

What Cascades

Affected Prompts

When editing folder metadata, the panel shows:

This folder contains 12 prompts
Changes will affect all prompts in this folder

Keyboard Shortcuts

Mobile Experience

On mobile devices, the Metadata panel appears as a bottom sheet:

• Swipe up to expand
• Swipe down to minimize
• Tap the grab handle to toggle
• Full functionality maintained

Auto-Save

Metadata changes are saved automatically:

1. Debounce delay: 1 second after last change
2. Retry on failure: Up to 3 attempts
3. Visual feedback: Save indicator in header

No manual save needed — just make your changes and they’re persisted.

Best Practices

1. Define Variables Proactively

Add variable definitions before using them in content:

• Provides autocomplete suggestions
• Documents expected inputs
• Sets sensible defaults

2. Use Descriptive Tags

Good tags make prompts discoverable:

Good: [customer-support] [email-reply] [v2.1]
Bad:  [misc] [test] [new]

3. Document with Descriptions

Add descriptions to variables:

userName
  Type: string
  Description: "Customer's first name for personalization"
  Default: "valued customer"

4. Leverage Inheritance

Set common metadata at folder level:

marketing/                  # brand_name, tone defined here
├── emails/                # Inherits brand_name, tone
├── social/                # Inherits brand_name, tone
└── ads/                   # Inherits brand_name, tone

5. Test with Render Preview

Before deploying, always:

1. Open Render Preview
2. Enter realistic test values
3. Verify output looks correct
4. Check for undefined variable errors

Troubleshooting

Variables not appearing

1. Check syntax: Must be {{ name }} (double braces)
2. Variable names can’t have hyphens (use userName not user-name)
3. Refresh the panel if recently added

Inherited metadata not showing

1. Verify the parent folder has metadata defined
2. Check you’re viewing a prompt, not a folder
3. Inherited items show a lock icon

Render preview shows errors

Common error types:

• Undefined variable: Add it to the Variables section
• Invalid syntax: Check for typos in {{ }}
• Circular injection: Review [[ ]] references

Changes not saving

1. Check the save indicator in the header
2. Verify network connection
3. If “Error” state, try refreshing the page