> For the complete documentation index, see [llms.txt](https://docs.keeping.com/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.keeping.com/help/satisfaction-ratings-csat/customizing-the-csat-widget.md).

# Customizing the CSAT widget

Learn how to customize 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="https://1058495162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCHa8WIsJ5Z5NqmPmq5VS%2Fuploads%2Fgit-blob-3d33979061c975dd26840f2bf9aca8be3c11952b%2FChoose%20CSAT%20Widget.png?alt=media" alt=""><figcaption><p>Choose your CSAT widget</p></figcaption></figure>

## Which CSAT widgets may I choose from?

<div><figure><img src="https://1058495162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCHa8WIsJ5Z5NqmPmq5VS%2Fuploads%2Fgit-blob-eae3b144649e8138f519cd5be65866f301ef863b%2Fstandard%20widget.png?alt=media" alt=""><figcaption><p>Standard</p></figcaption></figure> <figure><img src="https://1058495162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCHa8WIsJ5Z5NqmPmq5VS%2Fuploads%2Fgit-blob-b1ca5e5e7292dab7d70a28567d23708f445c8faf%2Fboxes%20widget.png?alt=media" alt=""><figcaption><p>Boxes</p></figcaption></figure> <figure><img src="https://1058495162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCHa8WIsJ5Z5NqmPmq5VS%2Fuploads%2Fgit-blob-c1718e391f457e418cdb4ff03cba5059adc42e45%2Fsmileys%20widget.png?alt=media" alt=""><figcaption><p>Smileys</p></figcaption></figure> <figure><img src="https://1058495162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCHa8WIsJ5Z5NqmPmq5VS%2Fuploads%2Fgit-blob-4e28adb715951fcc94b2dffb4b577b57b47197fd%2Flink%20only%202%20widget.png?alt=media" alt=""><figcaption><p>Link Only</p></figcaption></figure> <figure><img src="https://1058495162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCHa8WIsJ5Z5NqmPmq5VS%2Fuploads%2Fgit-blob-4cc8a43c30f9ec24b9bd587a5a1bd78914db59d0%2Femoji%20widget.png?alt=media" 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.
{% endhint %}

<figure><img src="https://1058495162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCHa8WIsJ5Z5NqmPmq5VS%2Fuploads%2Fgit-blob-81d6ba06eab9f5c7a550bfad7580264e525cd2d1%2Fsource%20code%20button%20in%20csat%20editor.png?alt=media" 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>
```
