Block Types and Configuration

Reference guide for every workflow block type in the Skyvern Cloud UI, including Browser Task, Extraction, Login, Loop, Conditional, Code, HTTP Request, and more.

Workflows 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 editor, grouped by category.

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, 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 workflow 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 or Skyvern 2.0
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 for fetching TOTP codes
Error Code Mapping	Map error conditions to custom error codes (JSON)

---

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 has two engine modes, selected via the Engine dropdown. The fields shown change depending on which engine you choose.

Skyvern 2.0 (recommended):

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

Skyvern 1.0:

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

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 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.

Login

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.

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.

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

---

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.

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

---

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)

Conditional

Branch the workflow 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 }}

AI Validation

Assert conditions using AI and halt the workflow 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

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

Wait

Pause workflow execution for a specified duration.

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

---

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.

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

---

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

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 workflow 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)

Human Interaction

Pause the workflow 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”)