Image Management

SuperSense automatically sources, processes, and attaches relevant images to your generated content. This eliminates the manual work of finding and uploading images while ensuring every post has visual appeal.

How Image Management Works

Keyword Analysis → Image Search → Selection → Download → Optimization → Attachment → Caption

For each generated post:

1. AI analyzes the keyword for image context
2. Searches configured image sources
3. Selects the most relevant images
4. Downloads and processes images
5. Optimizes for web performance
6. Attaches to post as media
7. Generates captions using templates

Image Sources

SuperSense can source images from multiple providers:

Configuring Sources

Navigate to SuperSense → Settings → Images → Sources:

1. Enable/disable each source
2. Set priority order
3. Configure API keys if required
4. Add custom source domains

Image Settings

Quality Settings

Size Settings

Per-Post Settings

Image Processing

Automatic Optimization

SuperSense processes images for optimal performance:

• Resizing: Scale to configured dimensions
• Compression: Reduce file size while maintaining quality
• Format Conversion: Convert to WebP where supported
• EXIF Removal: Strip metadata for privacy

Image Transformations

Optional transformations available:

Configure in Settings → Images → Transformations.

Attachment Pages

Each image creates a WordPress attachment page with:

Automatic Content

• Title: Based on keyword and image context
• Description: Generated using attachment template
• Alt Text: SEO-optimized alternative text
• Caption: Formatted using caption template

SEO Benefits

Attachment pages provide:

• Additional indexed pages
• Keyword-relevant content
• Internal linking opportunities
• Image search visibility

Attachment Template

Configure attachment page content:

## {{post.post_title}} - Image Gallery

This high-quality image illustrates {{keyword}}.

### About This Image

This visual accompanies our comprehensive guide on {{keyword}}. 
It provides context and enhances understanding of the topic.

### Related Content

For detailed information, see our full article: {{post.post_title}}

---
*Image for: {{keyword}}*

Caption Configuration

Caption Templates

Create dynamic captions:

{{keyword}} - Professional illustration for {{post.post_title}}

With spintax:

[High-quality|Professional|Detailed] {{keyword}} [image|illustration|visual] for {{post.post_title}}

Caption Placement

Choose where captions appear:

• Below image
• As figure caption
• In alt text
• In image title

Image Library

Viewing Images

Navigate to SuperSense → Images to see:

• All downloaded images
• Source information
• Associated posts
• Usage statistics

Image Actions

Bulk Management

Select multiple images to:

• Delete unused images
• Update metadata
• Export
• Reassign to posts

Filtering & Blocking

Content Filtering

Prevent inappropriate images:

Domain Management

Configure allowed/blocked domains:

# Allowed domains
allowed_domains:
  - unsplash.com
  - pexels.com
  - pixabay.com

# Blocked domains
blocked_domains:
  - example-spam.com

Troubleshooting

Images Not Found

Possible causes:

• Keyword too specific/obscure
• Image sources unavailable
• Network connectivity issues

Solutions:

• Try broader keywords
• Check source configuration
• Verify internet connection

Poor Image Quality

Possible causes:

• Source images low resolution
• Over-compression settings

Solutions:

• Increase quality settings
• Enable higher-quality sources
• Review source priorities

Images Not Attaching

Possible causes:

• WordPress permission issues
• Upload directory not writable
• Memory limit exceeded

Solutions:

• Check folder permissions (755)
• Verify upload directory exists
• Increase PHP memory limit

Slow Image Processing

Possible causes:

• Large image files
• Server resource constraints
• Too many images per post

Solutions:

• Reduce images per post
• Lower max dimensions
• Increase server resources

Best Practices

Optimize for Performance

• Use WebP format when possible
• Keep images under 200KB
• Don't exceed 5 images per post
• Enable lazy loading in WordPress

Ensure Relevance

• Use specific keywords for better image matching
• Review images periodically
• Curate your allowed source list
• Filter inappropriate content

Maintain Quality

• Set quality to 85% for good balance
• Use appropriate dimensions for your theme
• Test on mobile devices
• Monitor page load speeds

Legal Considerations

• Understand image licensing
• Use royalty-free sources
• Consider stock photo subscriptions
• Add attribution when required