# Customising embed links

## Supported URL parameters

* **`background`**: Possible values are `transparent` (no background, default), `original` (background set in Lottielab document properties ), or a hexadecimale color value **without the leading \`#\`.** For example, `ff0000` would be red.
* **`loop`**: Possible values are `true` (loop the animation, default), `false` (play the animation only once without looping), or any positive number (e.g. `2`), which means to loop the animation that many times before stopping.
* **`speed`**: Adjusts playback speed. Possible value is any positive number. For example, `0.5` will play the animation twice as slowly.
* **`width`** and **`height`**: Adjusts the animation's width and height. Possible values are a numerical pixel value (e.g. `200`), or `original` (uses the original respective dimension of the Lottie).

## Examples

```
https://cdn.lottielab.com/l/EFurnxiztpDwSV.html?background=00ff00
```

```
https://cdn.lottielab.com/l/EFurnxiztpDwSV.html?loop=false&width=200&height=400
```

```
https://cdn.lottielab.com/l/EFurnxiztpDwSV.html?loop=3&speed=0.5
```

```
<iframe
     src="https://cdn.lottielab.com/l/EFurnxiztpDwSV.html?background=original"
     width="456"
     height="204"
     frameborder="0">
</iframe>
```

## How-to

### Embed link

The list above refers to URL (query) parameters supported by the **Embed link** provided by Lottielab.

To get your Lottie's embed link, open it, and then click the **Export** button in the top right. If necessary, click **Embed Link** in the newly opened export panel. Your embed link ends with `.html`.

This document also applies to the **iFrame code,** since it also uses the embed link. To customise the **iFrame code**, simply apply the customisations to the link inside the code snippet, which you will identify by its `.html` ending.

<figure><img src="/files/zjd4Ghvtuxbq10jwXAVf" alt=""><figcaption></figcaption></figure>

If you're using a JSON URL, your Lottie player or Lottie integration will typically offer these controls instead.

### URL (query) parameters

The list at the top explains URL (query) parameters that you can add to your embed link to customise how the Lottie is played back and displayed.

URL (query) parameters are added to a link by appending a single question mark (`?`), and then adding  parameter-value pairs with an equals sign (`parameter=value`) and delimited by ampersands (`&`).

For example, if we have a link:

```
https://cdn.lottielab.com/l/EFurnxiztpDwSV.html
```

And want to add the following parameters to it:

* `loop` with value `4`
* `background` with value `original`

The link will look like this:

<pre><code>https://cdn.lottielab.com/l/EFurnxiztpDwSV.html<a data-footnote-ref href="#user-content-fn-1">?loop=4&#x26;background=original</a>
</code></pre>

[^1]: URL (query) parameters


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.lottielab.com/export-and-hand-off/livelink-cdn/customising-embed-links.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.