**Source URL:** https://general.veevavault.dev/safety/vault-toolbox/browser-extension/getting-started/quickstart.md

# Browser Extension Quickstart

Learn how to set up the Vault Toolbox extension for your browser, navigate its user interface, and run queries with the VQL Editor.

In this tutorial, you will learn how to:

* Install Vault Toolbox

* Log into Vault Toolbox using Basic authentication

* Use the VQL Editor to run a simple query

## Prerequisites {#prerequisites}

To follow this tutorial, you need:

* A [Google Chrome](https://www.google.com/chrome/dr/download/?brand=OZZY&ds_kid=11855101557&gclsrc=aw.ds&gad_source=1&gad_campaignid=21457145903&gbraid=0AAAAAoY3CA5jHsoMJNhMgDajgfwQC-nif&gclid=CjwKCAiA3L_JBhAlEiwAlcWO59XA8gGNfcTF9nlsdf6FOtyDcDrmqnmMf68BQM1Ztjd1-5BzSlRA-xoCBAkQAvD_BwE) or [Microsoft Edge](https://www.microsoft.com/en-us/edge/download?form=MA13FJ) browser downloaded and installed

* A sandbox Vault with full Admin and the [required permissions](/vault-toolbox/browser-extension/references/browser-extension-permissions)

## Installing Vault Toolbox {#installing-vault-toolbox}

You can install Vault Toolbox from the [Chrome Web Store](https://chromewebstore.google.com/detail/vault-toolbox/mnhgljfhifhchamigkieeghmcdjaahdg) or the [Microsoft Edge Add-ons Store](https://microsoftedge.microsoft.com/addons/detail/vault-toolbox/nghldafhefoopmepigogbhlehoennbhb). For other browsers, you can also download and install Vault Toolbox as an unpacked extension from our [GitHub repository](https://github.com/veeva/Vault-Developer-Toolbox).

## Logging Into Vault Toolbox {#logging-into-vault-toolbox}

Once the Vault Toolbox extension has been installed in your preferred browser, you can access Vault Toolbox from your **Extensions** (<Icon name="ph:puzzle-piece"></Icon>) menu in the top navigation bar. The Vault Toolbox login page appears in a new tab.

<ThemeImage srcLight="/images/toolbox/browser-extension/basic-login_light.png" srcDark="/images/toolbox/browser-extension/basic-login_dark.png" alt="Vault Toolbox browser extension login screen"></ThemeImage>
To log into Vault Toolbox:

<Steps>
1. Enter the **Vault DNS**. For example, `myvault.veevavault.com`.

2. For this Quickstart, select the **Basic** tab. See [Authenticating to Vault Toolbox](/vault-toolbox/browser-extension/guides/authenticating-to-vault-toolbox) to learn more about the other available authentication methods.

3. Enter your Vault **User Name** and **Password**.

4. Click **Log In**.

</Steps>
Once successfully logged in, the home page displays the *Vault Information*, such as the *Vault ID* and *Vault Name*. See [Navigating Vault Toolbox](/vault-toolbox/browser-extension/guides/navigating-vault-toolbox) to gain familiarity with the user interface.

## Running a Query {#running-a-query}

Within Vault Toolbox, navigate to the **VQL Editor** (<Icon name="ph:magnifying-glass"></Icon>). The following steps guide you through building a VQL query with the Query Builder to retrieve information about active *Person* (`person__sys`) records in your Vault.

To run a VQL query:

<Steps>
1. In the VQL Editor, select the <Icon name="ph:tree-structure"></Icon> icon to show the Query Builder.

2. From the **Category** dropdown, select **Objects** as the query target.

3. From the **Target** dropdown, select **Person (person__sys)**. This value will be added to the query’s `FROM` clause.

4. From the **Fields** dropdown, select the following fields: **ID (id__sys)**, **Name (name__v)**. These values will be added to the query’s `SELECT` clause.

5. Click **+ Add Filter** to set values for the query’s `WHERE` clause. Create a filter with the following values:

1. **VaultRecordField**: Status (status__v)

2. **Operator**: =

3. **Value**: Active

6. Click **Build Query in Editor**. Observe the following query appear in the editor panel:

</Steps>
`SELECT id, name__v 
FROM person__sys 
WHERE (status__v = 'active__v')
`
<Steps>
1. Click **Run VQL** to run the query. Observe the results in the bottom panel of the editor.

2. Click **Download CSV** to download a CSV file of the query results.

</Steps>
Congratulations, you’re up and running with the Vault Toolbox browser extension!



---

**Previous:** [Getting Started](/safety/vault-toolbox/browser-extension/getting-started)  
**Next:** [Guides](/safety/vault-toolbox/browser-extension/guides)