PrompteryxBeta
    ⌘K
    PlatformSupport
    Menu
    IntroductionInstall Desktop & extensionQuick StartPlatform Overview
    OverviewWhat you can makeAI Browser Agent in the chatModels and AutoConnectorsSchedulesProjectsExplore and publishingShare linksMemory and SkillsPersonal agent (beta)Welcome, settings and skinsPlans, credits and top-upsPrompteryx DesktopGroups (pilot)Phone app (early access)
    OverviewCreating WorkflowsTesting & DebuggingScheduling
    OverviewGetting StartedCommandsRecordingSettingsStructured OutputParallel AgentsTips & Best Practices
    OverviewInstallationSidebar AgentUsing Attached FilesExecute on Current TabExporting to Visual Studio
    Overview
    OverviewOpen PageClickClick CoordinatesFillExtract TextScreenshotWaitPress KeyFocus ElementBlur ElementSelect TextHighlight ElementSet ViewportGet Bounding BoxScrollHoverSelect OptionAssertionsCookiesEvaluate JavaScriptExample Workflows
    OverviewPrompteryx Browser AgentOpenAI
    OverviewSchedule TriggerWebhook Trigger
    OverviewGoogle SheetsGoogle CalendarConnect Hub (3,000+ apps)Example Workflows
    AI Vision SettingsChrome Automation ProfilesCloud BrowserBrowser Profiles & Persistent ContextVideo RecordingExecution LogsSharing & CollaborationEdit History
    Selectors GuideVariables
    Start hereGet an API keyRun the AI browser agentDrive a cloud browserRun workflows from anywhereUse connected apps (Connect Hub)SDK (TypeScript)CLIMCP for AI assistants
    REST APIWebhooksMCP toolsCloud Browser APICloud Browser quickstartMigrate from Browserbasen8nZapierMake.com

    Need help? Contact Support

    1. Documentation
    3. Features
    5. Video Recording

    Video Recording

    Feature

    Record workflow executions for review and debugging

    Overview

    Video recording captures a visual record of your workflow execution. This is especially valuable for debugging headless runs, reviewing automation behavior, and maintaining audit trails.

    Enabling Video Recording

    In Visual Studio, recording is switched on from the toolbar:

    1. Click the “Video Recording Off” button in the toolbar so it reads “Video Recording On”
    2. Optionally open Settings (gear icon) → Video Recording for more options, such as applying the settings to all workflows, creating a merged video and the save location
    3. Run your workflow - video will be saved automatically

    For the AI Browser Agent, the standing default lives in Settings → AI Browser Agent. With it on, cloud agent runs save an MP4 automatically, and the Schedule-an-Agent dialog pre-fills its per-schedule “Video recording” toggle from this default. Video recording is available on the Starter, Developer, Pro and Enterprise plans — not on the free trial.

    The Enable Video Recording by Default toggle in the Settings dialog's AI Browser Agent tab
    Settings → AI Browser Agent — the standing video-recording default for agent runs.

    Visible vs Headless Mode

    Visible Mode

    Browser window is visible on screen.

    • Great for development and debugging
    • Can watch automation in real-time
    • Video recording optional but useful for review
    Headless Mode

    Browser runs in background, no visible window.

    • Faster execution
    • Doesn't interrupt your work
    • Video recording essential for debugging

    Viewing Recordings

    Runs on your own Chrome (through Prompteryx Desktop):

    1. In Visual Studio, switch from Editor to History to see the workflow's executions
    2. Select the execution you want to review
    3. Click Watch Recording to open the video
    Local recordings are saved on your machine, in the folder set under Settings → Video Recording → Save Location (by default, Prompteryx\recordings in your AppData\Roaming folder).

    Runs on the cloud browser are recorded as an MP4. After a run, a Cloud Recording button appears next to the run controls, and every recorded cloud session is also listed in Cloud Platform → Cloud Sessions, where you can filter by recording and watch the replay. A recording is ready once the session has ended.

    Use Cases

    Debugging Failures
    When a workflow fails, watch the recording to see exactly what happened. Often reveals timing issues, unexpected popups, or selector problems.
    Audit Trail
    Keep visual proof of what your automation did. Useful for compliance, client reporting, or internal auditing.
    Documentation
    Record workflows to create training materials or documentation showing exactly how an automation works.

    Best Practices

    Always Record Headless Runs
    When running in headless mode, always enable video recording. It's your only way to see what happened if something goes wrong.
    Consider Storage Space
    Video files can be large, especially for long workflows. Local recordings stay in your save location until you delete them, so archive or clear out old ones now and then.

    Related Documentation

    Testing Workflows

    Debugging techniques

    Execution Logs

    Text-based logging