ARN Smart Support
Language: English

Describe images with Media AI (Pro)

Updated 5 Nov 2026 6 min read
Browse WebPix articles

Media AI looks at your images through your own AI provider and suggests alt text, titles, captions, descriptions and clearer file names. You review every suggestion before it is applied, and every change can be undone.

Where to find it: ARN WebPix → Media AI, and the WebPix box in an image's details in Media → Library. The AI connection itself is in Settings → ARN Center.

Media AI is part of WebPix Pro. WebPix Free sends no AI requests.

WebPix Media AI illustration with field suggestions, review decisions and private-media exclusion

Step 1. Set up the shared AI connection

Every ARN Smart product on your site shares one AI connection. You set it up once in Settings → ARN Center, which has the tabs Connection, Model prices, Usage & limits and Licences.

AI requests use your own provider account, and your provider bills every request. This is separate from your WebPix licence.

  1. Choose the AI engine. On the Connection tab, choose WordPress AI (uses the WordPress AI Client and its connectors) or ARN Smart AI (your own provider connections). The selected engine is used by all connected products.
  2. Add a provider connection (ARN Smart AI). Open Add a connection, enter a Connection ID (lowercase letters, numbers, hyphens or underscores) and a Connection name, choose the Provider and paste your API key. Use Load models, then Test and save. Keys are encrypted and never displayed again.
  3. Choose an image model. Media AI needs an Image understanding connection and a model that accepts image input. Tick I have verified that this model accepts image input, then click Save model and access settings.
  4. Set limits if you need them. On Usage & limits, you can set a shared monthly request limit and monthly limits per product. Every attempted request counts, including tests, failed requests and retries.

In WebPix, Settings → AI connection shows the engine and whether Text and Image understanding (Media AI) are Ready or Not set up, with an Open ARN Center button (in Pro 3.0.0 it is labelled Open ARN Smart AI). "Ready" checks the saved settings only; the test in ARN Center sends a real request.

Note: On a multisite network, a network administrator can share one connection with selected sites through Manage network AI sharing. Other sites keep their own connections.

Step 2. Choose automation and fields

On the Media AI page, under Automation and fields:

SettingDefaultWhat it does
Suggest for new uploadsOffAsks the AI in the background a few seconds after an image is uploaded.
Minimum confidence for automatic alt text0.75An empty alt text is written at once when the AI is at least this confident. Below this value, the alt text waits for your review.
Suggest titlesOnA short title instead of the file name. The attachment page address follows the title.
Suggest captionsOffThe line some themes show under an image.
Suggest descriptionsOffThe description on the attachment page.
Suggest file namesOnOnly for names that say nothing, such as IMG_1234.jpg, DSC0042.jpg or screenshots.

Only an empty alt text is filled automatically. Existing alt text and every other field always wait for your review.

Step 3. Get suggestions for your library

Under Suggestions for the library, the page shows how many images have no alt text, how many have meaningless file names and how many the AI has not seen yet.

  1. Under Which images, choose Images without alt text, Images with meaningless file names or Every image the AI has not seen.
  2. Click Start and confirm. The job runs in the background; follow it on the Optimize page.

Each image is asked once. Start with a small selection, because your provider bills every request.

Step 4. Review in the media table

The Media table lists each item's file name, slug, title and alt text. Filter it by Without alt text, Meaningless file names, AI suggestion waiting, Changed (can be undone) or Never sent to AI, and by file type and folder.

  • Edit fields by hand, or click AI Preview to get a suggestion for one image without saving it.
  • Tick the fields you want, then click Apply, or Reject the suggestion.
  • To work on several rows, select them and use AI Preview selected or Apply selected.
  • Find and Replace with change words in the selected rows (Replace in selected).

Applying a new file name renames the original, every image size and the WebP/AVIF copies, and updates the links on your site. See Rename and replace media files.

Undo changes

  • Undo puts back the last change of a media item.
  • Restore original puts back every recorded change of that item, with the links on your site.
  • Recent changes lists the file names, titles and alt texts changed by WebPix or ARN Vendix, each with Undo and Restore original.

Use Media AI from the Media Library

In an image's details in Media → Library, click Suggest with AI. Edit or untick the suggested fields, then click Apply or Reject. Undo last change reverses the latest change.

Keep private images away from the AI

  • In the media table, select images and click Never send to AI. Allow AI reverses it.
  • In the folder panel, mark a whole folder with Never send to AI.

Images marked this way, and images in such a folder, are left out of every Media AI request and job.

Media that another plugin holds until it is approved, such as review photos in ARN Vendix, is not sent to the AI until it is approved.

Media AI and other ARN plugins

While WebPix Pro is active and licensed, ARN Vendix leaves its media AI work (alt text, titles, file names and reversible renames) to WebPix Media AI. Changes Vendix made earlier appear under Recent changes and can be undone in WebPix.

If Media AI suggests nothing

  • Check Settings → AI connection: Image understanding (Media AI) must be Ready.
  • In Settings → ARN Center, choose an image model, confirm that it accepts image input and run the test.
  • Check whether the images are marked Never send to AI, are in such a folder or are on hold.
  • Check under Usage & limits that Allow AI requests is on for WebPix and that no monthly limit has been reached.

Always review generated text for accuracy and for the image's purpose on the page.

On this page

Submit a ticket

Create a new support request without needing a portal account.

Priority
Attachments
Only you and our staff see a ticket. Never send passwords or licence codes.

Track a ticket

Use the ticket number and password from your confirmation email.

The number and the password are in your confirmation email.

Sign in

Access your support portal account.

New here?

Create account

Create your support portal account.

Already have an account?

Forgot password?

We email you a link to choose a new password.

Conversation

Was this helpful?
Open full article
↑ ↓ to moveEnter to openEsc to close