Ghost Blog Featured Images: Complete Setup Guide

Ghost is the platform of choice for serious publishers. Its clean design puts content first—but featured images still matter for engagement, sharing, and SEO. Here's how to get them right in Ghost.

Ghost Image Sizes

Feature Image

Recommended: 1200 x 630 pixels (1.9:1 ratio)

The main image associated with each post. Appears:

• At the top of posts (theme-dependent)
• In post cards on homepage/archives
• In RSS feeds
• In social sharing cards (Open Graph, Twitter)

This size matches Open Graph specifications, making it optimal for social sharing.

Alternative Sizes by Theme

Different Ghost themes handle images differently:

Check your theme's documentation for specific recommendations.

Content Images

Images within posts have different requirements:

Recommended width: 1200-2000 pixels

Ghost responsive images handle sizing, but provide high-resolution originals for retina displays.

How Ghost Handles Images

Responsive Images

Ghost automatically generates multiple sizes from your upload:

• 300w, 600w, 1000w, 2000w versions
• Browser selects appropriate size
• Original preserved for full-quality viewing

Upload the largest practical size—Ghost handles the rest.

Image Optimization

Ghost Pro includes built-in optimization:

• Automatic compression
• WebP conversion (where supported)
• CDN delivery

Self-hosted Ghost: Consider using a CDN or image optimization service.

Storage

• Ghost Pro: Images stored on Ghost's infrastructure
• Self-hosted: Local storage or configure external (S3, etc.)

Setting Featured Images

In the Editor

1. Open your post
2. Click the settings gear (top right)
3. Scroll to "Feature image"
4. Click to upload or drag image
5. Add alt text (important for SEO/accessibility)

Via API

For automated publishing:

{
  "posts": [{
    "title": "My Post",
    "feature_image": "https://example.com/image.jpg",
    "feature_image_alt": "Description of image"
  }]
}

Bulk Updates

For existing posts, use Ghost Admin API or a migration tool to update images programmatically.

Theme Considerations

Feature Image Display

Themes display featured images differently:

Full-width hero: Image spans viewport, high impact Contained: Image within content width, more modest Card-based: Image as card thumbnail Hidden: Some minimal themes don't show on post page

Preview your theme to understand how images display.

No Feature Image Fallback

What happens when a post has no image:

Good themes:

• Graceful text-only display
• No broken image indicators
• Social cards use site logo/default

Poor themes:

• Blank space where image should be
• Layout issues
• Missing Open Graph data

Test your theme with and without featured images.

Customizing Display

Many themes let you control feature image behavior:

{{#if feature_image}}
  <img src="{{feature_image}}" alt="{{feature_image_alt}}">
{{/if}}

Check theme documentation for options.

Best Practices

1. Optimize Before Upload

Ghost optimizes images, but starting with reasonable files helps:

• Compress with TinyPNG or Squoosh
• Target 200-500KB for featured images
• Use JPG for photos, PNG for graphics

2. Write Good Alt Text

Ghost lets you add alt text to featured images:

• Describe the image content
• Include relevant keywords naturally
• Keep it under 125 characters
• Don't start with "Image of..."

3. Maintain Consistency

Develop a visual style:

• Consistent aspect ratios
• Similar color palettes
• Recognizable aesthetic
• Professional quality

4. Consider the Card View

Your image appears as a card on:

• Homepage
• Tag archives
• Author pages
• Related posts

Ensure images work at card size (typically 300-400px wide).

5. Plan for Social

Featured images become social cards. Test with:

• Facebook Sharing Debugger
• Twitter Card Validator
• LinkedIn Post Inspector

Check that cropping doesn't cut important elements.

Ghost + Unsplash Integration

Ghost has built-in Unsplash integration:

Using It

1. In the editor, add an image block
2. Click "Unsplash" button
3. Search and select
4. Image inserted with proper credit

For Featured Images

1. Open post settings
2. Click feature image area
3. Select "Unsplash" option
4. Search and insert

Considerations

• Credit is automatically added (visible in theme)
• Images are high quality but may be overused
• Good for quick posts, less distinctive for brand

SEO Optimization

Image Filename

Before uploading, name files descriptively:

• Good: ghost-blog-setup-guide.jpg
• Bad: IMG_4532.jpg

Alt Text

Always add alt text:

• Describes image for screen readers
• Helps with Google Image Search
• Required for accessibility compliance

Schema Markup

Ghost automatically includes image in schema.org markup:

• Shows in Google search results
• Enables rich snippets
• Improves click-through rates

Page Speed

Large images hurt SEO. Ghost helps with:

• Lazy loading
• Responsive images
• Format optimization

Monitor Core Web Vitals in Google Search Console.

Ghost Pro vs Self-Hosted

Ghost Pro Image Handling

• Automatic CDN delivery
• Built-in optimization
• Global edge caching
• No configuration needed

Self-Hosted Image Handling

• Configure your own CDN (Cloudflare, etc.)
• Consider image optimization plugins
• Manage storage (local or S3)
• More control, more responsibility

For most users, Ghost Pro's image handling is sufficient and simpler.

Common Issues

Images Not Displaying

Check:

• File format (JPG, PNG, GIF, WebP)
• File size (under 10MB recommended)
• Theme's image handling
• Cache (clear browser and Ghost cache)

Poor Quality on Retina

Solution: Upload images at 2x intended display size. If an image displays at 600px, upload at 1200px.

Slow Loading

Solutions:

• Compress before uploading
• Use Ghost Pro or configure CDN
• Check hosting performance
• Enable lazy loading (theme-dependent)

Social Sharing Shows Wrong Image

Solutions:

• Clear Facebook/Twitter caches
• Check Open Graph tags in source
• Ensure featured image is set
• Wait for cache expiration

FAQ

Q: What's the maximum image size Ghost accepts?

Ghost handles large files, but recommend staying under 5MB for featured images. Larger files slow your site.

Q: Can I use SVG images?

Yes, but with limitations. SVGs work best for content images, not featured images (social sharing issues).

Q: How do I add image captions?

For content images: click the image, then the caption area below. Featured images don't have built-in captions—add text after if needed.

Q: Does Ghost support WebP?

Yes. Ghost can serve WebP to supporting browsers automatically (on Ghost Pro or with proper configuration).

Q: Can I add multiple featured images?

Not natively. Ghost supports one featured image per post. For image galleries, use the gallery card in the editor.

---

Find Better Featured Images

Every Ghost post deserves a compelling featured image. CoverImage.app uses AI to match images to your content—not just keywords. Paste your post and find the right image instantly.