media_sideload_image ( $file, $post_id = 0, $desc = null, $return_type = 'html' )

  • (string) file The URL of the image to download.
  • (int) post_id Optional. The post ID the media is to be associated with.
  • (string) desc Optional. Description of the image.
  • (string) return_type Optional. Accepts 'html' (image tag html) or 'src' (URL), or 'id' (attachment ID). Default 'html'.
  • (string|int|WP_Error) Populated HTML img tag, attachment ID, or attachment source on success, WP_Error object otherwise.
Defined at:
Change Log:
  • 4: .
  • 4: .
  • 5: .
  • 5: .
  • 5: .


Downloads an image from the specified URL, saves it as an attachment, and optionally attaches it to a post.

Related Functions

media_upload_image, media_upload_file, media_handle_sideload, media_upload_video, wp_load_image

Top Google Results

User discussions

wpseek mobile