> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rankai.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Article images

> Where article images come from, how to use your own brand images, alt text, where images are hosted, and how to fix a broken image.

**Every article gets a featured image that fits your brand.** To make new images follow your brand or photography guidelines, describe the look in a **Custom image prompt**. To use specific photos you already have, upload them.

> [!NOTE]
>
> **Optional:** upload brand images and pick an image style once. After that, images are added automatically.

> [!NOTE]
>
> \*\*In RankAI:\*\***Settings** → **Content & writing** → **Writer** → **Images** → **Edit** · `rankai.ai/dashboard/<project>/settings/content`

## What RankAI does

* Adds one featured image at the top of each article, right after the title.
* Uses your uploaded images first. Each one is used once; images already used are tagged **Used**.
* When your images run out, creates a new image in the style you picked.
* In list-style articles, such as "best tools for…", adds a screenshot of each listed website.
* Checks every image before publishing. If an image no longer loads, the article isn't published until you fix it.

## Your options

Open **Settings** → **Content & writing**, then click **Edit** on **Images** in the **Writer** card.

| Option | What it does |
| - | - |
| **Add image** | Upload your own photos or graphics, square or landscape, up to 500. RankAI also creates a few similar-style images from them. |
| **Website Theme + Text Based Images** | When your images run out: images in your **Main theme color** with the article title on them. |
| **Stock Images** | When your images run out: realistic, photo-style images without text. |
| **Custom image prompt** | Optional. Describe the look you want, for example "flat illustration, pastel colors, no people". It replaces the style above for new images. Use `{{title}}` and `{{excerpt}}` to include the article's title and summary. |

Click **View Samples** to compare the styles, then **Save brand images**.

### Custom image prompt or uploaded images?

They do different jobs, and you can use both:

| | **Custom image prompt** | **Uploaded images** (**Add image**) |
| - | - | - |
| Use it to | Set the style of every image RankAI creates, from your brand or photography guidelines | Use specific photos or graphics you already have |
| How it works | Applies to every new image RankAI creates | Each image is used once, before RankAI creates any |
| Best for | A consistent look across all articles | A limited set of real brand photos |

Following brand guidelines usually means writing a custom image prompt, for example: "Natural light, warm tones, real people at work, no text or logos". Uploaded images run out, and new images then follow the prompt.

## Alt text

The featured image's alt text is the article's keyword. To change it, open the article, click the image, click **Alt text**, and type a short description of what the image shows.

## Where images are hosted

RankAI stores images on its own servers. When you publish:

* **WordPress** and **Squarespace**: the featured image is uploaded to your media library; images in the body stay on RankAI's servers.
* **Wix**: all images are imported into your Wix media.
* **Sanity**: the featured image is uploaded to Sanity. Turn on **Upload body images to Sanity** in the Sanity connection to move body images too.
* **Webflow**, **Shopify**, **Framer** and **websites built with code**: RankAI sends image links, so images load from RankAI's servers unless your platform copies them.

## Fix a broken or wrong image

1. Open **Articles** and click the article to edit it.
2. Hover over the image, open the block menu, and click **Delete**.
3. Type `/` and choose **Image**, then **Upload an image**. You can also drag an image file into the article.
4. Click **Save**, then **Publish** to update your website.

The first image in an article is its featured image. If you delete it, the next image takes its place.

If publishing stops with "Some images in this article no longer load", replace or remove the listed images and publish again.

## Avoid these mistakes

* **Uploading only a handful of images.** Each image is used once, so a few uploads run out quickly. Pick a fallback style you're happy with.
* **Changing the image in your CMS only.** RankAI doesn't see that change, and the next update from RankAI can bring the old image back. Change it in RankAI instead.
* **Expecting old articles to change.** New image settings apply to articles written afterwards.

Questions? [Contact support](https://docs.rankai.ai/support/contact.md).

***

*Last reviewed: November 14, 2026.*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.