How does WPSSO Core find / detect / select images?

The images used in the Open Graph, Rich Pin, Twitter Card meta tags and Schema markup are chosen in this sequence:

  1. Video preview image(s), when the “Include Preview Images” option is checked under the “Priority Media” tab in the Document SSO metabox (Premium version).
  2. An image selected under the “Priority Media” tab in the Document SSO metabox (Premium version).
  3. An e-commerce product image from a supported 3rd-party plugin like Easy Digital Downloads, WooCommerce, or WP eCommerce (Premium version).
  4. A featured or attached image from the WordPress Media Library or NextGEN Gallery.
  5. An image from the NextGEN Gallery ImageBrowser in combination with an nggalbum or nggallery shortcode (Premium version).
  6. A preview image from a NextGEN Gallery nggalbum or nggallery shortcode (Premium version).
  7. Image(s) from expanded NextGEN Gallery singlepic, nggallery, nggtags or ngg_images shortcodes.
  8. Image(s) from <img/> HTML tags in the content text.
    1. NextGEN Gallery <div|a|img/> HTML tags with the ‘data-ngg-pid‘ or ‘data-image-id‘ attribute (Premium version).
    2. <img/> HTML tags with the ‘data-wp-pid‘ attribute for media Library Images.
    3. Any other <img/> HTML tag with a ‘data-lazy-src‘ or ‘src‘ attribute.
  9. A default / fallback image defined on the SSO General settings page.

Most of these methods will lead to a properly sized image with correct dimensions since the image ID can be determined (provided the original image is large enough).

Always upload the largest images you can to the Media Library and/or NextGEN Gallery, and let WordPress create the resized / smaller versions as required. If an original image is smaller than the required image dimensions, it will be ignored / rejected – so always upload the largest images possible.

To satisfy the recommended Facebook image size of 1200x630px and the required Google Article AMP 1×1 image size of 1200x1200px (if you use an AMP plugin), you should always make sure to upload images that are larger than 1200x1200px.

See the Setup Guide for additional information on image related settings.

See why you shouldn’t upload small images to the Media library.