> For the complete documentation index, see [llms.txt](https://docs.win.win/twins/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.win.win/twins/twix-testnet-user-guides/token-icons.md).

# Token Icons

Introduction: Follow these simple steps to set a token icon using the TWIX testnet public cloud wallet hosted on <https://w.twix.live>. Make sure to have an icon in SVG format and a size no larger than 4096 bytes.

Step-by-Step Instructions:

1. Find or generate an icon for your token in SVG format. Ensure the file size is no more than 4096 bytes.
2. Visit an online tool, such as <https://base64.guru/converter/encode/image/svg>, to encode your SVG file into a base64 string. Upload the file and copy the generated base64 string.

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

3. Log in to your public Twix wallet at <https://w.twix.live>.
4. Navigate to your tokens page, which is named "mosaics".
5. Click on "Add Meta Data" and choose your desired token. Note that you must be the creator of the token and have a positive balance of this token in your account.

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

6. In the "Scoped Metadata Key" field, type "tokenIconImage".
7. In the metadata field, paste the base64 string you copied in step 2.

<figure><img src="/files/0sb9haE31hI8EZmGa0XV" alt=""><figcaption></figcaption></figure>

8. Enter your wallet password and sign the transaction.
9. In a few minutes, your token will be updated with the new icon.

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

10. To replace the icon, you can either repeat the process or edit the metadata with the new value. Be aware that the "Scoped Metadata Key" will appear as a hash value (9271ACDBD57BCE79) when editing.

Conclusion: By following these steps, you can set or update the icon for your token on the TWIX testnet public cloud wallet. This will make your token more recognizable and visually appealing within the wallet interface.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.win.win/twins/twix-testnet-user-guides/token-icons.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.