Block Types and Configuration

Agents are built from blocks. Each block performs one specific operation: navigating a page, extracting data, making an API call, or branching logic. This page covers every block type available in the Cloud UI agent editor, grouped by category. If you’re writing automations in code instead, the equivalent operations are Page and Agent methods. See the Actions Reference for the code-first counterparts to these blocks.

how to add a block to an agent in Skyvern — To add a block in your agent, click the + button, click on Add block, then select the block type from the menu.

Quick reference

Category	Blocks
Browser Automation	Browser Task, Browser Action, Extraction, Login, Go to URL, Print Page
Data and Extraction	Text Prompt, File Parser
Control Flow	Loop, While Loop, Conditional, AI Validation, Code, Wait
Files	File Download, Cloud Storage Upload
Communication	Send Email, HTTP Request, Human Interaction

Common fields

These fields appear on most blocks:

Field	Description
Label	Display name on the canvas. Also determines how downstream blocks reference this block’s output (`{{ label_output }}`).
Continue on Failure	Allow the agent to continue if this block fails
Next Loop on Failure	Only inside loops. Skip to the next iteration on failure.
Model	Override the default LLM model for this block (Advanced Settings on most blocks)

Browser-based blocks (Browser Task, Browser Action, Extraction, Login, File Download) share these additional fields:

Field	Description
URL	Starting URL. Leave blank to continue from the previous block’s page.
Engine	AI engine. Skyvern 1.0 is the default for new browser blocks.
Max Steps Override	Cap the number of AI reasoning steps
Disable Cache	Skip cached script execution
TOTP Identifier	Link TOTP credentials for 2FA handling
TOTP Verification URL	Endpoint this block polls when it needs a 2FA code
Error Code Mapping	Map error conditions to custom error codes (JSON)

Set TOTP Verification URL on the block that may encounter 2FA. Top-level workflow run totp_url values do not automatically populate empty block fields.

Browser Automation

Browser Task

The primary block for browser automation. Accepts a natural-language prompt and autonomously navigates the browser to accomplish the goal. The block uses Skyvern 1.0 by default. Existing agents that already contain V2 browser blocks remain editable and may show a reduced field set. Skyvern 1.0:

Field	Type	Description
URL	text	Starting URL (optional)
Prompt	text	Natural language instructions for the AI

Existing V2 blocks:

Field	Type	Description
URL	text	Starting URL (optional)
Prompt	text	Natural language instructions for the AI
Max Steps	number	Maximum AI steps
Disable Cache	boolean	Skip cached script execution

Additional fields in Advanced Settings (Skyvern 1.0 only):

Field	Type	Description
Complete if…	text	Condition that signals the block is done
Include Action History in Verification	boolean	Include prior actions when verifying completion
Complete on Download	switch	Mark the block as complete when a file download occurs
File Name	text	Custom filename for downloaded files

Plus common browser fields.

Browser Task block configuration with URL and prompt fields

Browser Task is the recommended block for most browser automation. Use it for anything from form filling to multi-page navigation. Include your success criteria directly in the prompt so the AI knows when it’s done.

Browser Action

Execute a single browser action. Best for precise, one-step operations like clicking a specific button or entering text in a field.

Field	Type	Description
URL	text	Starting URL (optional)
Action Instruction	text	Specify the single action to perform

Additional fields in Advanced Settings:

Field	Type	Description
Complete on Download	switch	Mark the block as complete when a file download occurs
File Name	text	Custom filename for downloaded files

Plus common browser fields.

Extraction

Extract structured data from the current page using AI.

Field	Type	Description
Data Extraction Goal	text	What data to extract
Data Schema	JSON	JSON Schema defining the output format. Enable the checkbox to reveal the editor. Click Generate with AI to auto-suggest a schema from your extraction goal.

Plus common browser fields.

Extraction block configuration with Data Extraction Goal and Data Schema fields

Authenticate to a website using stored credentials. Pre-filled with a default login goal that handles common login flows including 2FA.

Field	Type	Description
URL	text	Login page URL
Login Goal	text	Login instructions (pre-filled with a comprehensive default)
Credential	selector	Select stored credentials for authentication

Additional fields in Advanced Settings:

Field	Type	Description
Complete if…	text	How to know login succeeded

Plus common browser fields.

Login block configuration with URL, Login Goal, and Credential fields

Go to URL

Navigate the browser directly to a specific URL without AI interaction.

Field	Type	Description
URL	text	(Required) The URL to navigate to. Supports parameter references.

Go to URL block configuration with URL field

Print Page

Print the current browser page to a PDF file. The PDF is saved as a downloadable artifact.

Field	Type	Description
Page Format	select	Paper size: A4, Letter, Legal, or Tabloid
Print Background	boolean	Include CSS background colors and images in the PDF
Headers & Footers	boolean	Add date, title, URL, and page numbers to the PDF

Additional fields in Advanced Settings:

Field	Type	Description
Custom Filename	text	Custom name for the generated PDF
Landscape	boolean	Use landscape orientation

Print Page block configuration with page format, print background, and headers & footers options

Data and Extraction

Text Prompt

Send text to the LLM for processing without browser interaction. Useful for summarizing, transforming, or analyzing data between browser steps.

Field	Type	Description
Prompt	text	The text prompt to send to the LLM
Model	selector	Which LLM model to use
Data Schema	JSON	Expected output structure. Enable the checkbox to reveal the editor. Click Generate with AI to auto-suggest a schema.

Text Prompt block configuration with Prompt, Model, and Data Schema fields

File Parser

Parse PDFs, CSVs, Excel files, and images to extract structured data.

Field	Type	Description
File URL	text	URL or parameter reference to the file
Data Schema	JSON	Schema for the extracted output. Enable the checkbox to reveal the editor.
Model	selector	Which LLM model to use

File Parser block configuration with File URL, Data Schema, and Model fields

Control Flow

Loop

Repeat a sequence of blocks for each item in a list. Child blocks are placed inside the loop on the canvas.

Field	Type	Description
Loop Value	text	The list to iterate over. Use a parameter reference (e.g., `{{ my_list }}`) or a natural language description (e.g., “Extract links of the top 5 posts”) which triggers automatic extraction.
Continue if Empty	boolean	Mark the loop as complete if the list is empty

Inside loop blocks, use these reserved variables:

{{ current_value }}: the current item
{{ current_index }}: the iteration number (0-based)

Use Loop when the item list is already known before the loop starts, such as rows extracted from a table, files uploaded by a user, or URLs passed as agent parameters.

While Loop

Repeat a sequence of blocks while a condition remains true. Child blocks are placed inside the loop on the canvas.

Field	Type	Description
Condition	expression	Jinja2 template or natural-language prompt evaluated before each iteration

Inside while-loop blocks, use these reserved variables:

{{ current_index }}: the iteration number (0-based)

Use While Loop for flows where the number of iterations is discovered during the run, such as pagination, polling, or retrying until a recoverable page state clears. For pagination, a common pattern is to extract a has_next_page boolean inside the loop, click Next, and let the next condition check decide whether to continue.

Conditional

Branch the agent based on conditions. The UI shows branches as tabs (A, B, C, etc.). Each branch has an expression that determines when it executes. Expressions can be Jinja2 templates or natural language prompts.

Field	Type	Description
Branches	tabs	One or more conditions. Each branch has an Expression field. Click + to add branches.
Else branch	auto	Automatically added. Executes when no other condition matches.

Example Jinja2 expression:

{{ extraction_output.price > 100 }}

Conditional block configuration with branch expressions

AI Validation

Assert conditions using AI and halt the agent on failure. Useful for checking that a previous block produced expected results before continuing.

Field	Type	Description
Complete if…	text	Condition that means validation passed
Terminate if…	text	Condition that means validation failed

Additional fields in Advanced Settings:

Field	Type	Description
Error Code Mapping	JSON	Custom error codes for failure reasons
Input Parameters	select	Parameters to evaluate

AI Validation block configuration with Complete if and Terminate if fields

Code

Execute custom Python code. Input parameters are available as global variables. Top-level variables in your code become the block’s output.

Field	Type	Description
Code	code editor	Python code to execute
Input Parameters	select	Parameters available as globals in the code

Code block configuration with Python code editor and Input Parameters field

Wait

Pause agent execution for a specified duration.

Field	Type	Description
Wait in Seconds	number	Seconds to wait (0–300)

Wait block configuration with Wait in Seconds field

Files

File Download

Navigate the browser to download a file.

Field	Type	Description
URL	text	Starting URL (optional)
Download Goal	text	Instructions for finding and downloading the file
Download Timeout (sec)	number	Seconds to wait for the download to complete

Additional fields in Advanced Settings:

Field	Type	Description
File Name	text	Custom filename for the download

Plus common browser fields.

File Download block configuration with URL, Download Goal, and Download Timeout fields

Cloud Storage Upload

Upload downloaded files to S3 or Azure Blob Storage.

Field	Type	Description
Storage Type	select	`Amazon S3` or `Azure Blob Storage`
Folder Path	text	Upload path/prefix (optional)

S3 fields

Field	Description
S3 Bucket	Bucket name
AWS Access Key ID	AWS credential
AWS Secret Access Key	AWS credential
Region Name	AWS region

Azure fields

Field	Description
Storage Account Name	Storage account name
Storage Account Key	Storage account key
Blob Container Name	Container name

Cloud Storage Upload block configuration with Storage Type and Folder Path fields

Communication

Send Email

Send an email notification, optionally with file attachments from previous blocks.

Field	Type	Description
Recipients	text	Comma-separated email addresses
Subject	text	Email subject line
Body	text	Email body. Supports parameter references.
File Attachments	text	Path to files to attach

Send Email block configuration with Recipients, Subject, Body, and File Attachments fields

HTTP Request

Make an API call to an external service. Click Import cURL in the block header to populate fields from a cURL command.

Field	Type	Description
Method	select	GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS
URL	text	Request URL. Supports parameter references.
Headers	JSON	HTTP headers. Use Quick Headers to add common headers.
Body	JSON	Request body (POST/PUT/PATCH only)
Files	JSON	File uploads (POST/PUT/PATCH only)

Additional fields in Advanced Settings:

Field	Type	Description
Timeout	number	Request timeout in seconds (1–300, default: 30)
Follow Redirects	boolean	Automatically follow HTTP redirects (default: true)
Continue on Failure	boolean	Continue agent if the request fails
Save Response as File	boolean	Save the response body as a downloadable file
Download Filename	text	Filename for the saved response (shown when Save Response as File is enabled)

HTTP Request block configuration with Method, URL, Headers, and Body fields

Human Interaction

Pause the agent and request human input. Optionally sends an email notification to reviewers.

Field	Type	Description
Instructions For Human	text	Instructions displayed to the reviewer
Timeout (minutes)	number	Minutes to wait before auto-continuing (default: 120 minutes / 2 hours)

Email notification fields:

Field	Type	Description
Recipients	text	Email addresses to notify (comma-separated)
Subject	text	Notification email subject
Body	text	Notification email body

Additional fields in Advanced Settings:

Field	Type	Description
Positive Button Label	text	Label for the approval action (default: “Approve”)
Negative Button Label	text	Label for the rejection action (default: “Reject”)

Human Interaction block configuration with Instructions For Human and Timeout fields

Getting Started

Building Agents

Agent Blocks

Running Tasks

Re-using Browsers

Viewing Results

Managing Credentials

Integrations

Account & Settings

Block Types and Configuration

Quick reference

Common fields