# Custom Images

Each collectable set or item can have its own custom sticker image that displays in the UI.

## Image Creation

The resource includes tools for creating stickers that match the provided style.   

### Photoshop Template

`/images/sticker-template.PSD`

This template can be used to size your images appropriately. Scale your image to snap to the included guides. You can open one of the included images as an example to get your sizing right.

1. **Open** the `sticker-template.psd` file
2. **Place** your sticker image inside, transparency recommended
3. **Select** your sticker layer and **run** the included action: `sticker-outline.ATN`
4. **Size** your image: line up the outline of your sticker with the guides
5. **Export** your image

### Photoshop Action

`/images/sticker-outline.ATN`

This action allows you to create the same white outline and drop shadow that the included images are styled with.

***

## Adding Images

1. Place your image in the `images/` folder:

   ```
   images/my_custom_icon.png
   ```
2. Reference it in your set configuration:

   ```lua
   example_set = {
       icon = 'my_custom_icon.png',
   },
   ```

***

## Image Requirements

* **Format:** `PNG/GIF/WebP` recommended (supports transparency)
* **Size:** Square images work best (e.g., `128x128`, `256x256`)
* **Recommended Size:** Around `500px` works best. Keep file size as low as possible.
* **Location:** Must be in the `images/` folder

***

## Using Font Awesome Icons

Instead of a custom image, you can use a Font Awesome icon:

```lua
example_set = {
    icon = 'fa:child',  -- Font Awesome icon
},
```

The `fa:` prefix tells the UI to render a Font Awesome icon instead of loading an image file.

***

## Pre-loaded Images

The resource comes with images for all included sets. Check the `images/` folder to see what's available.


---

# 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://madcap.gitbook.io/docs/premium-resources/mad_collectables/custom-images.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.