Avatar uploads

Manage your avatar on the With account page. The portal handles upload, cropping, processing, and review status.

Change your avatar

Sign in to the With portal and open your account’s avatar section.
Choose an image file and follow the crop and upload controls.
Wait for processing and check the displayed review state. An accepted upload still needs moderation before applications can receive it.
Use the avatar menu to reset to a generated avatar when that action is available.

Follow the file-size and format limits shown in the portal. Upload acceptance depends on the actual image, not just its filename. Processing may reject malformed or unsupported images.

Animation and delivery

The portal supports static images and eligible animated GIF/WebP uploads. Processing normalizes the image; applications receive WebP delivery images rather than the original file. Use the static avatar when animation is inappropriate, and respect the user’s motion preferences.

Review states

Pending: the account page can show your uploaded preview while review is pending. Applications continue to receive the approved avatar or generated fallback allowed by claim policy.
Approved: the uploaded avatar becomes eligible for sharing through the normal claim policy and consent checks.
Rejected: the upload is not shared with applications. Check the portal’s current avatar and review message before uploading a replacement.

See Avatar review lifecycle for review behavior.

For application developers

Direct users to the With portal to change their avatar. The portal cannot be embedded, and its account-management API is reserved for first-party clients; ordinary application access tokens cannot call it.

Obtain shared avatar URLs through Session or OIDC UserInfo, following Avatar claims and delivery. Treat those URLs as display data: do not parse them, use them as account identifiers, or depend on uploaded originals. Availability follows the application’s claim policy, the user’s consent, and current review state.