Reference Form Context Data

The context object gives you access to form field values, launch workflow results, and URL parameters. Use it in visibility expressions, default values, and HTML content.

Context Structure

{
  field: {
    // Current form field values
    email: "user@example.com",
    department: "engineering"
  },

  workflow: {
    // Results from launch workflow
    user_id: "user-123",
    is_admin: true
  },

  query: {
    // URL query parameters
    customer_id: "cust-456"
  }
}

Accessing Field Values

Reference form field values with context.field.*:

Visibility Expression

// Show field if checkbox checked
context.field.is_manager === true

// Show if dropdown has specific value
context.field.department === "engineering"

// Show if field has any value
context.field.email && context.field.email.length > 0

Default Value

// Pre-fill from another field
context.field.primary_email

// Use workflow data
context.workflow.user_email

HTML Content

<div className="p-4 bg-blue-50 rounded-lg">
  <p>Email: {context.field.email}</p>
  <p>Department: {context.field.department}</p>
</div>

Accessing Workflow Data

Reference launch workflow results with context.workflow.*:

// In visibility expression
context.workflow.is_admin === true

// In HTML content
<p>Welcome, {context.workflow.user_name}!</p>

// In default value
context.workflow.organization_name

Tip

Click Info button in form builder to see all available context.workflow data.

Accessing URL Parameters

Reference query parameters with context.query.*:

First, enable the parameter on a form field:

1. Create field with same name as parameter
2. Enable Allow as Query Parameter
3. Access in form with context.query.field_name

Example URL: /execute/form?customer_id=123

// In visibility expression
context.query.customer_id !== null

// In default value
context.query.customer_id

// In HTML content
<p>Customer ID: {context.query.customer_id}</p>

Common Patterns

Show Field Conditionally

// Show if another field has specific value
context.field.request_type === "urgent"

// Show if user is admin
context.workflow.is_admin === true

// Show if URL parameter provided
context.query.edit_mode === "true"

Pre-fill Fields

// From launch workflow
context.workflow.customer_email

// From another field
context.field.billing_email

// From URL parameter
context.query.preset_value

Display Dynamic Content

{/* Show user-specific message */}
<div className="p-4 bg-blue-50 rounded-lg">
  <p>Hello {context.workflow.user_name}!</p>
  <p>Selected department: {context.field.department}</p>
</div>

{/* Conditional content */}
{context.workflow.is_premium && (
  <div className="p-4 bg-gold-50 rounded-lg">
    <p>Premium features enabled</p>
  </div>
)}

Null Safety

Always check if values exist before using them:

// Safe check for field value
context.field.email && context.field.email.length > 0

// Safe check for workflow data
context.workflow.user_name || "Guest"

// Safe navigation
context.workflow.user?.email

// Safe array check
context.workflow.permissions?.includes("admin")

Troubleshooting

Undefined values: Use Info button in form builder to see available context. Verify launch workflow returns expected data.

Field not updating: Form fields update in real-time. Visibility and HTML content re-evaluate when referenced fields change.

Query parameters not working: Ensure field with matching name exists and has “Allow as Query Parameter” enabled.

Next Steps

• Show Fields Based on User Permissions - Conditional visibility
• Display Personalized Welcome Messages - Dynamic content
• Pre-fill Forms from URL Parameters - Launch workflows
• Context Object Reference - Complete API reference