***

title: Add script runner blocks to your notebook
updated: 2026-02-20T00:00:00.000Z
slug: >-
docs/postman-api-network/showcase/publish/notebooks/draft/add-script-runner-blocks
max-toc-depth: 2
----------------

Write JavaScript code in your notebook to create an interactive experience. For example, you can add a script runner block that generates a random number and use that number in a [request block](/docs/postman-api-network/showcase/publish/notebooks/draft/add-request-blocks/) that accepts one. In addition, you can [import external libraries](/docs/tests-and-scripts/write-scripts/packages/external-package-registries/) and [visualize your data](/docs/tests-and-scripts/write-scripts/postman-sandbox-reference/pm-visualizer/).

You can also reference a script runner block's output elsewhere in your notebook.

## Add a script runner block

To add a script runner block, do the following:

1. Open your notebook or [create a new one](https://www.postman.com/notebook/new).
2. Place your cursor where you want to add the script runner block. Then, enter a forward slash ("/"). Postman displays a block menu.
3. Choose <img alt="Run icon" src="https://assets.postman.com/postman-docs/aether-icons/action-run-stroke.svg#icon" width="16px" /> **Script Runner**.
4. Name your script runner block.
5. Write your code.
6. Click <img alt="Run icon" src="https://assets.postman.com/postman-docs/aether-icons/action-run-stroke.svg#icon" width="16px" /> **Run**.

Postman runs the code and returns the result. To see the logs, open the **Logs** tab.

## Reference your script runner block

Reference your script runner block by name. For example, if you name your script runner block "randomNumber", you can reference its output with the syntax `{{randomNumber}}` in text, an [input block](/docs/postman-api-network/showcase/publish/notebooks/draft/add-input-blocks/), a [request block](/docs/postman-api-network/showcase/publish/notebooks/draft/add-request-blocks/), or an [AI request block](/docs/postman-api-network/showcase/publish/notebooks/draft/add-ai-request-blocks/).

Or you can reference it with the syntax `$randomNumber` in another script runner block.

Furthermore, you can use dot notation to reference data within the output. For example, in request block, you can reference the user's first email with the syntax `{{randomNumber.emails.0}}`. Or in another script runner block, you can reference the same value with the syntax `$randomNumber.emails[0]`.

To reference your script runner block, do the following:

1. Open your notebook or [create a new one](https://www.postman.com/notebook/new).
2. Get your script runner block's name.
3. Reference your script runner block:

   * To reference your script runner block in text, an input block, a request block, or an AI request block, use the syntax `{{scriptRunnerBlockName}}` or `{{scriptRunnerBlockName.path.to.data}}`.
   * To reference your script runner block in another script runner block, use the syntax `$scriptRunnerBlockName` or `$scriptRunnerBlockName.path.to.data`.