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

# Runtime Variables

Runtime variables in Requestly are **temporary variables** that last until the session is closed. Unlike environment or collection variables, they are available globally across all workspaces.

<Tip>
  Runtime variables are the only type of variables that work **across multiple workspaces**.
</Tip>

You can choose whether variables should **persist** it’s value after restarting the app .

## Why use runtime variables?

Runtime variables are designed to give you flexibility when testing APIs across different workspaces. Some common use cases include:

* **Quick testing**: Store temporary values like access tokens or session IDs while debugging.

* **Cross-workspace usage**: Share the same variable across multiple local workspaces without redefining it each time.

* **Persistence control**: Choose whether the variable should survive after restarting the app or clear automatically for a fresh start.

<Warning>
  Runtime variables are **not synced to the cloud**. They only exist locally on your device. If you switch machines or reinstall the app, these variables will not carry over.
</Warning>

## Creating a runtime variable

<Steps>
  <Step title="Open Requestly and Go to runtime variables.">
    From the sidebar, click on **Runtime variables**.

    <img src="https://mintcdn.com/requestly/C-8RNowaOOgmOMj9/images/runtime-variables/7126d4f7-a436-49aa-b0c0-3139af0be69f.png?fit=max&auto=format&n=C-8RNowaOOgmOMj9&q=85&s=bb198e913469404e1ed519e73609bc86" align="center" fullwidth="false" width="2400" height="1608" data-path="images/runtime-variables/7126d4f7-a436-49aa-b0c0-3139af0be69f.png" />
  </Step>

  <Step title="Create a new Variable">
    In the variables table, click **+ Add More** and enter the variable details:

    * **Key** – The variable name (e.g., `session_id`).

    * **Value** – The value you want to store.

    * **Type** – Select from **String**, **Number**, **Boolean**, or **Secret**.

    * **Persistent** – Toggle whether the variable should be saved across app restarts.

      * **Yes** → Keeps its value after restarting the app.

      * **No** → Clears itself automatically on restart.

    <img src="https://mintcdn.com/requestly/C-8RNowaOOgmOMj9/images/runtime-variables/94304f29-becc-4dd6-8789-1ed8c7b0206b.png?fit=max&auto=format&n=C-8RNowaOOgmOMj9&q=85&s=92051f7a9a6d168344f29acdf9dbf454" align="center" fullwidth="false" width="2400" height="1608" data-path="images/runtime-variables/94304f29-becc-4dd6-8789-1ed8c7b0206b.png" />
  </Step>
</Steps>

## Using runtime variables

**Method 1: Insert variables directly in requests**

You can use runtime variables just like environment or collection variables. Wrap the variable name in double curly braces `{{ }}`:

`https://api.example.com/users/{{session_id}}`

**Method 2: Set variables in scripts**\
You can define or update runtime variables in the **Scripts** tab using the `rq.variables` object.

```javascript theme={null}
rq.variables.set("token", "12345");
rq.variables.get("token");
```