<img height="1" width="1" style="display:none;" alt="" src="https://px.ads.linkedin.com/collect/?pid=108825&amp;fmt=gif">
Skip to content
English
Contact us
  • There are no suggestions because the search field is empty.

Transforming Knowledge Base Imagery into Actionable AI Data

HubSpot's Customer Agent can now extract and reason over your knowledge base images, but it relies on explicit text context to understand the instructional steps hidden inside your screenshots.

As of the April product updates, HubSpot's Knowledge Vault can now ingest your entire HubSpot Knowledge Base (KB) as a source, and inline images on KB articles, blogs, and landing pages are extracted, described, and indexed. This allows the AI agent to reason over the screenshots that often contain the actual instructions.

Why This is Important

For years, we have relied on screenshots with red arrows to show customers where to click. However, if an image is just uploaded as Screenshot_4.png with no surrounding context, an AI might miss the critical step depicted within it. Because the Customer Agent can now reason over these images, you need to ensure that the screenshots and diagrams carrying the actual instructional content are confirmed to be indexed properly.

Furthermore, HubSpot's inline image indexing supports up to 10 images per article or page. If you have a massive 30-step tutorial with 30 images, the AI might drop the crucial visuals at the end. You must optimise specifically for how the AI "sees."

How to Execute the AI Image Optimisation Strategy in HubSpot

Here is how to ensure your Customer Agent is actually "reading" your screenshots correctly:

1. Optimise Alt-Text for AI action

Standard accessibility best practices say alt-text should describe the image (e.g., "HubSpot settings menu"). AI optimisation requires actionable descriptions.

  • Click into the Knowledge Base article editor and click on your inline image.
  • Edit the Alt Text.
  • Change it from a basic description to an explicit instruction. Example: "To change your password, click the gear icon in the top right corner of the navigation bar, then select 'Security' from the left sidebar menu."

3. Add explicit on-page captions

If you don't want to stuff your alt-text, use visible captions directly below the image. The AI reads the text immediately surrounding an image to give it context.

  • Underneath your screenshot, add a caption that explains exactly what the red arrow in your image is pointing to.

4. Audit for the 10-Image Limit Because the inline image indexing maxes out at up to 10 per article or page, you need to condense highly visual guides.

  • Review articles with more than 10 images.
  • Combine multiple smaller screenshots into a single composite image before uploading it to HubSpot, or replace simple screenshots with clear, direct text instructions so you save your 10-image limit for complex diagrams.