> For the complete documentation index, see [llms.txt](https://assetstore.essentialkit.voxelbusters.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://assetstore.essentialkit.voxelbusters.com/features/app-shortcuts/playmaker/use-cases/use-case-3-custom-icons.md).

# Custom Shortcut Icons (Settings + AddShortcut)

## Goal

Use custom shortcut icons reliably (primarily Android) when calling `AppShortcutsAddShortcut`.

## Actions Used

* `AppShortcutsAddShortcut`
* `AppShortcutsGetAddShortcutError` (optional)

## Setup (Essential Kit Settings)

1. Open: **Window → Essential Kit → Settings → App Shortcuts**
2. Add your shortcut icon textures to the **Icons** list.

## FSM Steps

1. Call `AppShortcutsAddShortcut`.
2. Set `iconFileName` to the icon file name you want to use (must include extension, e.g., `play.png`).

## Failure Handling

* If `AppShortcutsAddShortcut` fails, call `AppShortcutsGetAddShortcutError` to read `errorCode` + `errorDescription`.

## Notes

* `iconFileName` must refer to a texture present in the AppShortcuts settings **Icons** list; otherwise the icon won’t show up.