When you add links to social posts in HubSpot, you’ll see a preview that includes a featured image, page title, and page description. If the image, title, or description don’t appear or you’re seeing issues with the featured image, use the steps below to troubleshoot.
Social previews are based on meta tags in the <head> section of your page HTML. These tags tell social media sites like Facebook, LinkedIn, and Twitter what to focus on when creating a preview of your shared link. The basic meta tags are:
The title, meta description, and the featured image are automatically set for blog posts. For landing pages and website pages, while the title and meta description are set also automatically, the featured image must be set manually.
Please note: LinkedIn will show your featured image, page title, and URL in their preview card, but will not include your meta description.
If your social post preview isn't showing the expected featured image, page title, or page description, you can troubleshoot in HubSpot or by using external debugging tools.
If you're linking to a HubSpot-hosted blog post, landing page, or website page, make sure a featured image is set in the page or post’s settings.
You can also manually set an og:image tag to add a featured image:
In your HubSpot account, navigate to your landing pages or website pages.
<meta property="og:image" content="IMG URL">
<meta name="twitter:card" content="summary_large_image">
If you're sharing an external page in your social post, you can use browser developer tools such as Chrome Developer tools to make sure the meta tags for the page are set up correctly. View the page's source, then check and confirm the following:
og:image and other meta tags are correctly displayed. og:image tag is correct.If you're seeing a discrepancy between your social preview and the meta tags, the social network may need to recrawl that page. Use the following validation tools for each social network to surface any errors or trigger a page recrawl:
In general, any posts published prior to recrawling the page will still retain the incorrect image. If the og:image tag has not been set for a page, the social network will scan the page to find the most appropriate image to include in social posts, which is usually the first image it finds. A link preview image may not appear at all if a robots.txt file or security software is used to prevent page crawling.
If your social post preview is displaying the expected featured image, but the image is displaying incorrectly, you can check the following.
If the featured image isn't appearing correctly in your social preview (e.g., the image is cut off or the ratio is incorrect), you may need to edit the image so it has the right dimensions for the social network you're posting to, then republish the page.
The following dimensions are recommended for featured image optimization on each network:
Ensure that any media included in your social posts follows the file size guidelines for each network. If HubSpot determines that a file is too large to post to a certain network, a warning will appear when creating the social post. These are the maximum file sizes for each social network:
Embedded color profiles may impact how your featured image appears in your social post. Different systems process uncommon color profiles in different ways, which is why the colors may look different when previewing the image in your file manager.
You can run your image URL through an external tool to see if it’s using an uncommon color profile. If necessary, you can remove the interfering color profile in an external photo editing tool like Photoshop, then republish the page before publishing your social post.
HubSpot’s file manager uses image compression on JPEGs and PNGs to help optimize loading speeds on your HubSpot-hosted content. Social media networks also use image compression in posts, which may vary in quality from what you see in HubSpot.
For this reason, it’s recommended to use relatively high-resolution images for each network. If your image doesn’t conform with a social network’s requirements, a warning will appear in HubSpot’s social publishing tool to help adjust your image accordingly.