> ## Documentation Index
> Fetch the complete documentation index at: https://docs.browseract.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Build and run a Bot by connecting browser actions and data operations in the visual Workflow Builder.

## Video Tutorial

[![Watch Build Your First Workflow in 5 Minutes](https://i.ytimg.com/vi/8fYWAQhm3QU/hqdefault.jpg)](https://www.youtube.com/watch?v=8fYWAQhm3QU)

[Watch **Build Your First Workflow in 5 Minutes** on YouTube](https://www.youtube.com/watch?v=8fYWAQhm3QU).

## 1. Create a Workflow Built Bot

1. Select `Create`.
2. Under `Build with Workflow`, select `Open editor`.

<img src="https://mintcdn.com/browseract/29l4R2D8vKlJa4eu/images/create-workflow-built-bot.png?fit=max&auto=format&n=29l4R2D8vKlJa4eu&q=85&s=715ccec1f39b4b80f5cc010d78dfb78b" alt="Open Build with Workflow from the Create menu" width="1759" height="742" data-path="images/create-workflow-built-bot.png" />

3. Enter an `AI Workflow Name` and an optional description.
4. Select `Create` to open the Workflow Builder.

<img src="https://mintcdn.com/browseract/NsOCzqG0hq750owC/images/name-workflow-built-bot.png?fit=max&auto=format&n=NsOCzqG0hq750owC&q=85&s=68006a62aac3de04f7a0c6bcd5226c5c" alt="Name and create the Workflow Built Bot" width="1749" height="626" data-path="images/name-workflow-built-bot.png" />

***

## 2. Build the Workflow: Google Maps Example

A Workflow connects nodes that represent the actions you would perform on a real website. For example, use a **Visit Page** node when you need to open a page, and use a **Click Element** node when you need to click a button.

This tutorial uses Google Maps to demonstrate the complete process. The Bot searches for restaurants in a selected location and extracts structured data from the results.

**Inputs**

* **Country:** e.g., `USA`
* **Area:** e.g., `Avalon, CA`

**Browser Actions**

1. Open `https://www.google.com/maps`
2. Search `{Country} {Area}`
3. Click search icon
4. Click **Nearby**
5. Click **Restaurant**
6. Extract list data

**Output**

A CSV file containing:

* `name`
* `full_address`
* `star_rating`
* `review_count`
* `average_price_per_person_range`

*All steps below are performed on the Workflow Build page.*

### Step 1 - Start Node: Define Input Parameters

1. On the canvas, click the **Start** node.
2. In **Input Parameters**, add:
   * **Name:** `Country` | **Default Value:** `USA`
   * **Name:** `Area` | **Default Value:** `Avalon, CA`

<img src="https://mintcdn.com/browseract/Hr8lt4ILVIVAd2kj/images/workflow-builder-add-node.png?fit=max&auto=format&n=Hr8lt4ILVIVAd2kj&q=85&s=78c7440520483289321b2549574cbae9" alt="Configure the Start node and add the next action" width="1866" height="791" data-path="images/workflow-builder-add-node.png" />

### Step 2 - Visit Page: Open Google Maps

1. Click **+** on the canvas (or right-click) and choose [**Visit Page**](/bot/workflow-built/node-types/visit-node).
2. Connect it after **Start**.
3. Set URL to:

   ```
   https://www.google.com/maps

   ```

<img src="https://mintcdn.com/browseract/Hr8lt4ILVIVAd2kj/images/workflow-overview-visit-page.png?fit=max&auto=format&n=Hr8lt4ILVIVAd2kj&q=85&s=87216e8e2d7d154a5d1917310272da7b" alt="Visit Page node configured for Google Maps" width="797" height="523" data-path="images/workflow-overview-visit-page.png" />

### Step 3 - Input Text: Search for the Location

1. Add an [**Input Text**](/bot/workflow-built/node-types/input-text-node) node and connect it after **Visit Page**.
2. In the page preview/selector, target the **top search bar**.
3. In Text to Input, enter: Country Area

   (This references the Start parameters).

<img src="https://mintcdn.com/browseract/Hr8lt4ILVIVAd2kj/images/workflow-overview-input-text.png?fit=max&auto=format&n=Hr8lt4ILVIVAd2kj&q=85&s=d27f7a0698fa682bf4b9ca3d7defe7f0" alt="Input Text node configured for the Google Maps search" width="818" height="999" data-path="images/workflow-overview-input-text.png" />

### Step 4 - Click Element: Navigate to Restaurants

Use one or more [**Click Element**](/bot/workflow-built/node-types/click-element-node) nodes to perform these three clicks in order:

1. **Search:** Click the magnifying-glass icon.
2. **Nearby:** Click the `Nearby` button.
3. **Restaurant:** Click the `Restaurant` category.

<img src="https://mintcdn.com/browseract/Hr8lt4ILVIVAd2kj/images/workflow-overview-click-element.png?fit=max&auto=format&n=Hr8lt4ILVIVAd2kj&q=85&s=985984b0cf1963a99a294687c6358f1c" alt="Click Element nodes configured for the Google Maps example" width="796" height="1724" data-path="images/workflow-overview-click-element.png" />

### Step 5 - Extract Data: Scrape the Restaurant List

1. Add an [**Extract Data**](/bot/workflow-built/node-types/extract-data-node) node after the last Click Element node.
2. In the left restaurant list, select **one full restaurant item** as the sample.
3. Configure fields to extract:
   * `name`
   * `full_address`
   * `star_rating`
   * `review_count`
   * `average_price_per_person_range`

<img src="https://mintcdn.com/browseract/Hr8lt4ILVIVAd2kj/images/workflow-overview-extract-data.png?fit=max&auto=format&n=Hr8lt4ILVIVAd2kj&q=85&s=f52ad6277aa4c4c80b56df4ec02ba936" alt="Extract Data node configured for restaurant records" width="812" height="897" data-path="images/workflow-overview-extract-data.png" />

***

## 3. Publish & Run

Before executing the workflow, ensure your latest changes are saved and versioned.

1. **Publish Version:** Click the **Publish** button (top-right corner) and select **Publish as New Version** to save your current configuration.
2. **Enter Run Mode:** Click the **Run** tab (located next to the *Build* tab).

<img src="https://mintcdn.com/browseract/Hr8lt4ILVIVAd2kj/images/workflow-quick-start-publish.png?fit=max&auto=format&n=Hr8lt4ILVIVAd2kj&q=85&s=574eda427cae1a2db27fde8720ed45ac" alt="Publish the Workflow Built Bot as a new version, then open Run" width="840" height="186" data-path="images/workflow-quick-start-publish.png" />

3. **Set Parameters:**
   * Country: `USA`
   * Area: `Avalon, CA`
4. **Execute:** Click **Start Run** and watch the nodes execute one by one.

You’re done when:

1. All steps show **Succeeded / ✔**.
2. The run result shows a **downloadable CSV file**.
3. The CSV contains rows like:

Code snippet

```
name,full_address,star_rating,review_count,average_price_per_person_range
Bluewater Avalon,306 Crescent Ave,4.3,2342,$30–50
Buffalo Nickel Inc,57 Pebbly Beach Rd,4.6,646,$20–30
...
```

<img src="https://mintcdn.com/browseract/Hr8lt4ILVIVAd2kj/images/workflow-quick-start-run-result.png?fit=max&auto=format&n=Hr8lt4ILVIVAd2kj&q=85&s=2f31fd2a09339e286605e58352597241" alt="Review the completed workflow steps and download the CSV result" width="840" height="484" data-path="images/workflow-quick-start-run-result.png" />

***

## 4. Common Roadblocks (Quick Fixes)

* **CSV is empty or has very few rows:**
  * Check the sample in [**Extract Data**](/bot/workflow-built/node-types/extract-data-node): it should be a full list item, not a tiny sub-element.
  * **Wait for load:** Add a short [wait](/bot/workflow-built/node-types/wait-node) before Extract Data if the list loads slowly.
* **Click Element does nothing:**
  * Re-select the actual clickable element (button/text) in the [Click Element node](/bot/workflow-built/node-types/click-element-node).
  * Confirm node order: Search → Nearby → Restaurant.
* **Run error and not sure why:**
  * Check URL in Visit Page is exactly `https://www.google.com/maps`.
  * Ensure Run parameters (Country/Area) are filled.
  * Ensure no node has missing config ([Click Element](/bot/workflow-built/node-types/click-element-node), etc.).

### Need Help?

If the issue continues, [contact BrowserAct Support](../../support/contact-support.mdx) or create a ticket in [Discord](https://discord.com/invite/UpnCKd7GaU). Include:

* A short description of your goal
* A screenshot of the error
* The Task ID

***

## Next Steps

Run the Bot again with different input values to confirm that the workflow can be reused for other locations.

For example:

| Country | Area     |
| ------- | -------- |
| USA     | New York |
| Japan   | Shibuya  |

Once the workflow runs successfully with new inputs, continue to [Node Types](./node-types/index.md) to learn how to build other browser interactions, or see [Run a Workflow Built Bot](../run/run-workflow-built-bot.md) for more ways to run and review a Bot.
