Images in documentation

The picture is meant to explain a step that is more difficult to describe in text. It should not replace the entire procedure or display more data than the customer needs.

Image preparation

• For a screenshot with text or transparency, use PNG.
• Use JPEG for photographs.
• The editor also accepts WebP; animated images are not supported.
• Trim unnecessary edges and highlight only the explained part.
• Check readability at the width of the article, not just on a large monitor.

Security check before upload

Remove passwords, tokens, verification links, webhook URLs, Ticket ID, personal information, payment information, private identifiers, and unnecessary game coordinates. Uploaded media may be publicly available even when the article is still a draft.

Upload in editor

1. On the documentation list, open the article and the correct language.
2. Place the cursor where the image should help.
3. Use the image button to select a file.
4. Fill in meaningful alternative text.
5. Save the draft and open the preview.
6. Check desktop and mobile views, alt text, and any transparency.

How to write alt text

Describe the meaning of the image in a specific step, for example "Slovak language card and Save draft button". A file name like screenshot-01.png is not useful. The important procedure must also be explained in the text for a person who cannot see the image.

Automatic variants

After uploading, the system will prepare reduced WebP variants with a quality of 80 and maintain transparency. The image will not be enlarged beyond its original dimensions. PNG or JPEG remains as a fallback; with WebP input, PNG fallback is also prepared. Individual sizes therefore do not need to be made by hand.

File Limits

When the upload fails

Check the format, size and dimensions. Shrink or split a large image into logical slices. Do not manually delete old files and variants - they may still be used in a published or historical revision.