docs
Core Features
Media Handling

Media Handling

Visual content is crucial for engagement. WP AutoFlow handles the image pipeline automatically, ensuring every post has a high-quality featured image hosted on your own server.

The Featured Image Pipeline

Unlike scrapers that hotlink images (steal bandwidth from the source) or screenshot low-quality thumbnails, WP AutoFlow uses the WordPress API to get the original media file.

  1. Detection: When a post is fetched from the source API, the system identifies the featured_media ID.
  2. Retrieval: It queries the source API for the full-resolution URL of that media object.
  3. Download: The worker downloads the image buffer to memory.
  4. Upload: It uploads the image directly to your WordPress Media Library via the REST API.
  5. Association: Finally, it attaches the new Media ID to your post as the Featured Image.

Why this matters: By uploading to your library, you own the asset. If the source site deletes the image or blocks hotlinking, your site remains unaffected.

Supported Formats

The system supports the standard web formats exposed by the WordPress API:

  • JPEG (.jpg, .jpeg)
  • PNG (.png)
  • WebP (.webp)

Storage & SEO

Since the images are uploaded natively to your WordPress:

  • CDN Compatible: If you use Cloudflare, Jetpack, or an S3 offload plugin on your WordPress, the images uploaded by AutoFlow will automatically benefit from them.
  • Alt Text: The system attempts to preserve the Alt Text provided by the source API, maintaining accessibility and SEO standards.

Troubleshooting Media

If images are failing to upload:

  1. Check File Size: Ensure your WordPress installation (upload_max_filesize in php.ini) accepts the file sizes being scraped.
  2. Check Permissions: The user account connected to WP AutoFlow must have permission to upload_files.
  3. Source Availability: If the source site has a broken media link in their API, WP AutoFlow will publish the post without an image rather than failing the job entirely.