Usage
Installation
Section titled “Installation”- In WordPress, go to Plugins → Add New Plugin and search for Visionati
- Click Install Now, then Activate
- Go to Settings → Visionati
Alternatively, download the ZIP from GitHub and install via Plugins → Add New Plugin → Upload Plugin.
- Enter your Visionati API key and click Verify to confirm the connection. Don’t have one? Sign up for an account.
- Pick your AI model under API Settings. The default is Gemini.
- Choose your output language (default: English).
- Review context settings if you want different roles or models for different fields.
Generating Alt Text, Captions, and Descriptions
Section titled “Generating Alt Text, Captions, and Descriptions”Open any image in the Media Library (grid view or list view). Below the standard fields you’ll see three Visionati buttons:
- Alt Text: Concise, accessibility-focused alt text
- Caption: A short caption
- Description: A longer description
Click any button to generate. A preview appears with the result. Review it, then Apply to save or Discard to throw it away. All three buttons work independently, and you can generate multiple fields at once.
You can change which role and model each field uses in the settings.
Bulk Generate
Section titled “Bulk Generate”Go to Media → Bulk Generate to process images in bulk.
- Check which fields to generate: Alt Text (checked by default), Caption, Description
- Click Start
- Confirm the number of images to process (warns if overwrite is enabled)
- Watch the progress bar and results log
- Click Stop at any time to pause. Click Resume to continue where you left off.
Only images missing content for the selected fields are queued. Images that already have all selected fields are skipped unless you enable Overwrite Existing in the settings. The page shows counts of how many images are missing each field.
You can also select images in the Media Library list view and choose Generate with Visionati from the Bulk Actions dropdown. This redirects to the Bulk Generate page with those images pre-queued.
Auto-Generate on Upload
Section titled “Auto-Generate on Upload”In Settings → Visionati → Automation, check which fields to auto-generate when new images are uploaded:
- Alt Text
- Caption
- Description
When multiple fields are enabled, they run in parallel, so three fields take roughly the same time as one. Leave all unchecked to disable auto-generation.
Settings Reference
Section titled “Settings Reference”API Connection
Section titled “API Connection”| Setting | Description |
|---|---|
| API Key | Your Visionati API key. Click Verify to test the connection. |
API Settings
Section titled “API Settings”| Setting | Description |
|---|---|
| AI Model | Default AI model for all fields. Default: Gemini. See AI Backends. |
| Language | Output language for all generated text. See Supported Languages. |
Context Settings
Section titled “Context Settings”Override the default role and AI model for individual fields. Each row has a role dropdown and an optional model dropdown. When the model is set to Default, it uses the global AI Model above.
| Context | Default Role | Description |
|---|---|---|
| Alt Text | Alt Text | Short, accessibility-focused descriptions. |
| Caption | Caption | Brief captions for displaying below images. |
| Media Description | General | Longer descriptions for the description field. |
| WooCommerce | Ecommerce | Product descriptions from featured images. |
Custom Prompts
Section titled “Custom Prompts”Write your own instructions for any field. When set, the custom prompt overrides the selected role. Leave blank to use the role.
| Setting | Description |
|---|---|
| Alt Text Prompt | Overrides the Alt Text role. |
| Caption Prompt | Overrides the Caption role. |
| Media Description Prompt | Overrides the Media Description role. |
| WooCommerce Prompt | Overrides the Ecommerce role. Supports {product_name}, {categories}, and {price} placeholders. |
Automation
Section titled “Automation”| Setting | Description |
|---|---|
| Auto-generate on Upload | Which fields to generate when images are uploaded (Alt Text, Caption, Description). |
| Overwrite Existing | Which fields can be overwritten during bulk and auto generation. Off by default. |
| WooCommerce Product Context | Include product name, categories, attributes, and price in WooCommerce prompts. On by default. |
Credits
Section titled “Credits”Each field you generate costs credits based on the AI model. Gemini costs 1 credit, Claude costs 3. See Credit System for full details.
Supported Image Formats
Section titled “Supported Image Formats”JPEG, PNG, GIF, WebP, and BMP. Maximum file size: 20MB.