Cover images (required) and alt text
Every writeup needs a cover image. How to upload one or use an image from your writeup, which files work, and how to write alt text.
Every writeup needs a cover image before it can be published. The cover appears at the top of your writeup, on feed cards and topic pages, and when people share your link.
Add a cover
In step 2 (Get it ready to publish), find Cover image under How readers see it.

Cover image and alt text in step 2. Click Choose image and pick a file from your device. A preview appears.
Or, if your writeup already has images you uploaded, click one under Or use an image from your writeup. The image stays in your text too.
Add a short description in Image alt text (see below).
The preview on the right (Feed card, Google, Social) shows how your cover will look.
Which images work
- JPEG, PNG, WebP or GIF.
- Up to 5 MB.
- We save it as WebP so it loads fast.
Pick a clear image that fits your topic, and check the preview before you publish. Use a photo you took, made yourself or have the right to use.
Alt text: describe the image
Alt text is a short description of the image. Screen readers read it aloud to people who can't see the image, and search engines use it too. It's optional but recommended.
- Write one short sentence about what is in the picture, for example "A cup of tea next to an open notebook on a wooden desk".
- Up to 200 characters.
- Click Generate alt to let AI write it for you (this uses one of your AI tries; see AI writing help).
Images inside your text need descriptions too. The This draft card in step 1 tells you when an image has none, with Add it and Write with AI buttons.
Writeups in a book, course, collection or playbook
If the writeup is part of a book, course, collection or playbook (chosen in Part of), you can choose Title cover instead of uploading. We make a cover from the number, the title and the cover colour. See Series and books.
Change the cover of a live writeup
Open your writeup, click ⋯ and choose Edit.
Click Next: publish settings.
Under Cover image, choose a new image, then click Update.
It says "A featured image is required before publishing."
Your writeup has no cover yet. Add one as shown above, then publish again.
It says "Image upload failed".
Check that the file is a JPEG, PNG, WebP or GIF under 5 MB. Very large photos from a phone camera can be over the limit; try a smaller copy or a screenshot of it.
Can AI make a cover for my writeup?
Not for a standalone writeup. Upload your own image or use one from your text.