# How to Add a Run on Gradient Badge for Notebooks

Notebooks are a web-based Jupyter IDE with shared persistent storage for long-term development and inter-notebook collaboration, backed by accelerated compute.

A Run on Gradient URL opens a Jupyter notebook from a GitHub repository with the option to run it on Paperspace. You can use this URL directly as a link or additionally use the Run on Gradient badge, which looks like this: ![Run on Gradient](https://assets.paperspace.io/img/gradient-badge.svg)

## Clicking a Run on Gradient Link

When you click on a Run on Gradient link, you view the Gradient Notebook in a Paperspace page. A **RUN** button in the top right corner lets you run the notebook on Paperspace, and **START MACHINE** lets you create a machine. If you aren’t logged in to Paperspace, the page prompts you to sign up or log in.

## Creating a Run on Gradient URL

To create a Run on Gradient URL from a GitHub URL, replace `github.com` with `console.paperspace.com/github`.

For example, [this notebook file on GitHub](https://github.com/nlp-with-transformers/notebooks/blob/main/02_classification.ipynb) has the following URL:

```
https://github.com/nlp-with-transformers/notebooks/blob/main/02_classification.ipynb
```

The Run on Gradient URL for this notebook is:

```
https://console.paperspace.com/github/nlp-with-transformers/notebooks/blob/main/02_classification.ipynb
```

In addition, you can optionally specify one or both of the following parameters as query strings:

- `container` to specify a [container template](https://docs.digitalocean.com/products/paperspace/notebooks/concepts/notebook-templates/index.html.md)
- `machine` to specify a [machine type](https://docs.digitalocean.com/products/paperspace/notebooks/details/pricing/index.html.md#paperspace-machines)

The [structure for query strings](https://en.wikipedia.org/wiki/Query_string#Structure) is `parameter=value`. To add a query string to a URL, append a `?` character followed by the query string. Separate multiple query strings with `&`.

For example, you can specify the P4000 machine type by appending `?machine=P4000` to a Run on Gradient URL. You can specify the same machine type and a specific container image by appending `?machine=P4000&container=paperspace/gradient-base:tf29-pt112-py39-2022-06-29`.

## Run on Gradient Badge Examples

To use a Run on Gradient Badge in Markdown or HTML, you can use the following examples. Replace `YOUR_RUN_ON_GRADIENT_URL` with your Run on Gradient URL.

### Markdown

```md
[![Gradient](https://assets.paperspace.io/img/gradient-badge.svg)](YOUR_RUN_ON_GRADIENT_URL)
```

### HTML

```
<a href="YOUR_RUN_ON_GRADIENT_URL">
  <img src="https://assets.paperspace.io/img/gradient-badge.svg" alt="Run on Gradient"/>
</a>
```