Go back

Knowledge base integrations workflow: A step-by-step path past knowledge base articles that go unused

Connecting one source to Velo is a quick setup. Turning that into a reliable process that keeps your whole knowledge base watchable, not just readable, takes a bit more planning. This is the workflow for making that shift properly.

Setting up knowledge base integrations as a lasting workflow means deciding which sources and articles to connect first, building a habit of checking that videos actually surface the right content, and setting a cadence for expanding coverage as more of your documentation gets connected. Support, Knowledge Management, and IT and Cybersecurity teams tend to lead this shift, since their documentation gets referenced under the most time pressure. Teams that skip the prioritization step and connect everything at once tend to end up with a pile of unreviewed videos nobody has confidence in, which defeats the purpose of building trust in the new format.

Before You Start: Which Sources and Articles to Prioritize

Resist the urge to connect every documentation source simultaneously; proving the workflow on one source first makes the case for expanding far more convincingly than a broad rollout with mixed early results.

Not every article needs a video on day one, and connecting everything at once makes it hard to catch problems early. A few filters worth applying:

  • High-traffic articles with low completion. Content that gets opened often but rarely finished start to finish is the clearest sign a video would help more than the current format.
  • Articles tied to recurring tickets or questions. If the same question keeps coming up despite an article already answering it, that’s a strong early candidate.
  • Fast-changing documentation. Content that updates often benefits the most from a live connection, since the alternative, manually re-recording every time it changes, is exactly the maintenance burden this workflow removes.
  • Your most-used source first. Connect the documentation, help center, or changelog tool your team relies on most, rather than trying to connect every possible source simultaneously.

Articles that don’t fit these, low-traffic, rarely referenced, stable content, are reasonable to leave as text for now.

The Workflow, Step by Step

Treat the first source connection as a pilot, not a full rollout, since the lessons from watching how well it handles your actual, messy documentation shape how confidently you can expand from there.

1. Audit which articles actually go unread. Pull traffic and completion data where available, and note anything repeatedly referenced in tickets or questions despite already existing as a written answer.

2. Connect your primary source. Link the documentation, help center, or changelog tool your team relies on most to Velo. Confirm the specific tool is currently supported, since source coverage is still expanding.

3. Generate videos for the highest-priority articles first. Start with the content flagged in your audit, rather than converting the entire library at once.

4. Check that the video surfaces the right answer. Confirm the generated video maps to the specific question the article was written to answer, not a generic summary.

5. Publish alongside the existing article. Embed the video in your help center or knowledge base next to the written version, rather than replacing the article entirely, since some readers still prefer text for a quick lookup.

6. Monitor engagement. Check whether the video is actually getting watched, and whether ticket volume or repeated questions on that topic actually drop. This tells you whether the fix is working, not just whether it shipped.

7. Expand source coverage as it becomes available. As more documentation platforms connect, extend the workflow to cover additional sources, rather than treating the initial setup as the finished state.

Setting This Up by Team

All three approaches below share a common thread: start with the content already causing the most pain, and let that first success build the case for expanding further.

How to Set Up Knowledge Base Integrations in a Support Team’s Workflow

Start with the articles most frequently linked in ticket responses, since those are the clearest evidence of content that’s correct but underused. Tie video generation to your help center specifically, and check ticket volume on those specific topics after publishing to confirm the video is actually reducing repeat questions, not just adding another format nobody watches either.

How to Set Up Knowledge Base Integrations in a Knowledge Management Team’s Workflow

Connect your primary documentation platform first, and prioritize content that’s both high-traffic and frequently updated, since that combination benefits most from a live connection rather than a one-time conversion. Build a habit of reviewing newly generated videos against source accuracy periodically, especially while source coverage is still expanding across your broader documentation stack.

How to Set Up Knowledge Base Integrations in an IT and Cybersecurity Team’s Workflow

Prioritize setup and security documentation where a skimmed article carries real risk. Keep a review step on generated videos before publishing, given how much precision matters in this context, and confirm the connected source stays tied to whichever documentation tool holds your most sensitive or frequently updated procedures specifically.

Common Mistakes When Setting Up Knowledge Base Integrations

Most of these mistakes share a root cause: moving faster than the underlying trust in the connection and the generated content actually justifies.

  • Converting the entire library at once. Starting broad makes it harder to catch a video that doesn’t quite surface the right answer before it reaches a wide audience. Start with high-priority articles and expand.
  • Replacing the written article instead of pairing with it. Some readers still prefer text for a quick lookup. Keep both available rather than removing the option that already works for part of your audience.
  • Not checking whether coverage extends to your actual sources. Source integrations are still expanding. Confirm your team’s specific documentation tool is connected before assuming full library coverage.
  • Skipping engagement monitoring. Publishing a video doesn’t guarantee it gets watched. Check whether it’s actually reducing repeat questions or ticket volume, not just whether it exists.
  • No review step on high-stakes content. For setup guides, security documentation, or anything where precision matters, a quick review before publishing catches issues a fully automatic process might miss.

Build a Knowledge Base People Actually Watch

The articles already causing the most repeat questions are the fastest place to start. Connect your primary source to Velo, generate video for your highest-priority content, and use what you learn to expand from there.

Try Velo for free · See how it works


About the author

Ritu Parakh is Growth Lead at Velo, the AI video messaging platform that turns a screen recording, a deck, or a URL into a polished, narrated video - and an editable written doc. She writes about video for demos, onboarding, training, and enablement. Connect on LinkedIn

Connecting a source is a one-time setup step. Generating videos for a prioritized set of articles after that is fast, since Velo builds directly from content that already exists rather than starting from a blank script.

No. Start with high-traffic, low-completion articles and anything tied to recurring tickets or questions. Converting the entire library indiscriminately produces videos that may not get watched any more than the original articles did.

Generally, pair them rather than replace one with the other. Some readers still prefer skimming text, especially for a fast lookup, and every video generated through knowledge base integrations already comes with a written version kept in sync.

Check engagement on the video itself, and check whether ticket volume or repeated questions on that specific topic actually decrease. Both signals matter more than whether the video was published at all.

Source coverage is still expanding. Confirm current support for your specific platform, and prioritize whichever connected source covers the most of your high-priority content in the meantime.

Bring the video layer to your product team