# Sticker troubleshooting

> Resolve unavailable sticker media, pending phone requests and catalog access problems.

> **Note**
>
> Release candidate. These sticker operations are not yet available in staging or production. API version `2026-11-10` and matching released packages are required.

## The phone sync was requested, but the catalog did not change

`requested` confirms that Polymorfa issued the request. Keep the primary phone
available and wait for history or `sticker.update` events. Do not present the
request receipt as completed synchronization or automatically issue another
write after a transport timeout.

## A sticker shows Media unavailable

Its display metadata does not include a usable send reference. If you have the
required permission, request a media refresh and wait for a successful phone
result. A failed or unknown result does not restore media. Do not substitute an
unrelated URL or another sticker's descriptor.

## Recent stickers are empty

Recents belong to the Number's own account. Receiving someone else's sticker
does not add it. Hosted state also needs enabled HMS, accepted sticker-storage
terms, live access and retained data. An empty catalog does not prove that the
phone has no installed packs. Customer-owned stores need the schema 3 migration.

## The storage terms are unavailable or a change is unconfirmed

Do not treat unavailable terms as accepted. Wait until the reviewed terms are
available. If acceptance or withdrawal could not be confirmed, refresh before
trying again. Withdrawal remains available from the scope's Chats settings
without send permission. Existing retention and deletion rules still apply.

## Removing a recent did not remove a newer use

Supply the exact observed `lastStickerSentTs` in milliseconds. Removal covers
that use and older uses. A later use remains recent; do not replace the timestamp
with the current time.

## A sticker or pack fails validation

Check the image limits and use one source form. For an uploaded pack, use flat
file names, matching item metadata, valid sticker bytes and the pack encryption
domains. Authenticate downloaded media before parsing it. See
[Stickers and sticker packs](https://docs.polymorfa.com/messaging/stickers).
