# Customizing the CSAT widget

Keeping comes with 5 CSAT widgets that have been specially designed to work with most email systems. However, you may customize your own widget if you prefer your own design.

<figure><img src="/files/fONNXeYYKNUOKpeLQxXA" alt=""><figcaption><p>Choose your CSAT widget</p></figcaption></figure>

## Which CSAT widgets may I choose from?

<div><figure><img src="/files/D6qBdZ9YgqZ1Gwq8panZ" alt=""><figcaption><p>Standard</p></figcaption></figure> <figure><img src="/files/rIPu9MRYYIeV6mHAdQL2" alt=""><figcaption><p>Boxes</p></figcaption></figure> <figure><img src="/files/f3FsSaVDfokB1hWA6PN7" alt=""><figcaption><p>Smileys</p></figcaption></figure> <figure><img src="/files/WGeIxLy6Qt0TfOFt746X" alt=""><figcaption><p>Link Only</p></figcaption></figure> <figure><img src="/files/aPu6X8N2j7Fcu2GhCvu3" alt=""><figcaption><p>Emoji</p></figcaption></figure></div>

## Customizing the CSAT widget

It's usually easiest to start with an existing CSAT widget as a template, and then make your edits from there. If you like, you can edit the HTML by clicking the **<> button** to see the underlying source code of the widget.

{% hint style="warning" %}
Adding images or external URLs here may get stripped out by some email clients. We recommend using email-safe HTML only. &#x20;
{% endhint %}

<figure><img src="/files/FhMGsfbohU1y92rDn5UN" alt=""><figcaption><p>Click the Source Code button to see the underlying HTML</p></figcaption></figure>

## Special HTML attributes

If you are creating your own HTML widget, you'll need to include special `href` attributes in your links so Keeping can replace them to generate your rating links. For example, a link for a **great** rating would look like this:

```html
<a href="{{ ratings.great }}">Great</a>
```

Here are the attributes to use for the three ratings:

<pre class="language-html"><code class="lang-html"><strong>&#x3C;a href="{{ ratings.great }}"> your text here &#x3C;/a> 
</strong>&#x3C;a href="{{ ratings.okay }}"> your text here &#x3C;/a>
&#x3C;a href="{{ ratings.bad }}"> your text here &#x3C;/a>
</code></pre>

Or, simply include a link if you'd prefer your customers to rate you on the next step.

```html
<a href="{{ ratings.url }}"> How did I do? </a>
```

Keep in mind that you must surround your `href` value **with quotes**, like this:

```html
<p><br><a href="{{ ratings.great }}"><strong>Great</strong></a> </p>
```


---

# 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.keeping.com/help/satisfaction-ratings-csat/customizing-the-csat-widget.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.
