For Paligo HTML5 publications

Ask AI for your Paligo docs

Add an Ask AI chatbot or AI search widget to your Paligo HTML5 publications. Readers get source-cited answers from the right topics, in their language.

Start free trial See the install code

14-day freeSelf-serveLive in 15 min

Biel.ai chatbot

Assistant

Hi! how can I help you?

Three ways to ship Biel on Paligo

A floating Ask AI chatbot via Custom JavaScript, an AI search field next to the navbar, or a hosted MCP endpoint Claude and Cursor can query directly.

Full installation guide

Inject via Paligo HTML5 customization

Paligo HTML5 publications support a custom JavaScript field in the publication settings. Drop the Biel snippet there and the Ask AI button appears on every published page. No DITA work, no XSLT.

→Floating Ask AI button on every published page
→Works on standard and customized HTML5 layouts
→Per-publication install: scope by publication
→Indexes the rendered HTML, including DITA-derived content

Paligo Custom JavaScript

// Publication settings → HTML5 layout → Custom JavaScript

(function() {
  // Load Biel.ai widget assets from CDN
  var link = document.createElement('link');
  link.rel = 'stylesheet';
  link.href = 'https://cdn.jsdelivr.net/npm/biel-search/dist/biel-search/biel-search.css';
  document.head.appendChild(link);

  var script = document.createElement('script');
  script.type = 'module';
  script.src = 'https://cdn.jsdelivr.net/npm/biel-search/dist/biel-search/biel-search.esm.js';
  script.onload = function() {
    var btn = document.createElement('biel-button');
    btn.setAttribute('project', '<YOUR_PROJECT_ID>');
    btn.setAttribute('header-title', 'Documentation AI');
    btn.setAttribute('button-position', 'bottom-right');
    btn.setAttribute('button-style', 'dark');
    btn.textContent = 'Ask AI';
    document.body.appendChild(btn);
  };
  document.head.appendChild(script);
})();

Add AI search alongside Paligo search

The same custom JavaScript hook can mount <biel-search-button> next to or in place of the navbar’s built-in search. Useful when readers should land on a search field rather than a floating button.

→AI search field in the navbar
→Returns synthesized answer, not a list
→Coexists with Paligo's built-in search
→Same custom-JS injection point

Paligo Custom JavaScript

(function() {
  var link = document.createElement('link');
  link.rel = 'stylesheet';
  link.href = 'https://cdn.jsdelivr.net/npm/biel-search/dist/biel-search/biel-search.css';
  document.head.appendChild(link);

  var script = document.createElement('script');
  script.type = 'module';
  script.src = 'https://cdn.jsdelivr.net/npm/biel-search/dist/biel-search/biel-search.esm.js';
  script.onload = function() {
    var btn = document.createElement('biel-search-button');
    btn.setAttribute('project', '<YOUR_PROJECT_ID>');
    btn.setAttribute('header-title', 'Documentation AI');
    btn.setAttribute('button-style', 'rounded');
    btn.textContent = 'Search';

    // Mount it inside your navbar element
    var nav = document.querySelector('.header__navigation') || document.body;
    nav.appendChild(btn);
  };
  document.head.appendChild(script);
})();

Make your docs queryable by AI agents

Every Biel project ships with a hosted MCP endpoint. Claude, Cursor, Cline, and other MCP-compatible assistants can search your Paligo HTML5 site directly. Configure once in mcp.json.

→Hosted MCP server, no self-hosting
→Same index as the chatbot, one source of truth
→Works with Claude Desktop, Cursor, Cline, Zed
→Auth via project token, scoped per-workspace

mcp.json

{
  "mcpServers": {
    "biel-ai": {
      "name": "Biel.ai",
      "type": "http",
      "url": "https://mcp.biel.ai/v2/YOUR_PROJECT_SLUG/mcp"
    }
  }
}

Biel.ai vs built-in Paligo search

Paligo's HTML5 output ships with a client-side keyword search. It is fast and offline. Biel is built for natural-language questions across topics, variants, and versions. Many Paligo sites run both.

Dimension	Paligo HTML5 search	Biel.ai
Query type	Paligo's HTML5 layout ships a client-side keyword search. Returns a list of pages.	Natural-language questions. Returns a synthesized answer with source citations.
DITA / topic-based content	Paligo search indexes the rendered output. Topic boundaries are visible only as page breaks.	Topic-aware indexing. Citations resolve to the topic title and section, preserving the DITA hierarchy.
Multi-publication	Each publication is its own HTML5 site with its own search index. No cross-publication answers.	Index multiple publications as one Biel project. Citations show which publication the answer came from.
Variants and outputs	Paligo lets you publish per-variant. Each variant gets its own search index.	Index each variant as a separate source. Readers on the audience-A variant get answers from the audience-A topics.
Languages	Per-language HTML5 outputs each ship with their own search.	Each language indexed as its own source. Plus answers in 60+ languages, including ones your docs are not written in.
Analytics	No content-gap signal from the built-in search.	Unanswered questions, satisfaction trends, and a Content Gaps view that updates daily.
Install	Built-in. No install required.	One Custom JavaScript field per publication. Live in 15 minutes.
Cost	Built into Paligo HTML5 output.	From $50/mo, self-serve. 14-day free trial, no credit card required.

Things teams ask during evaluation

Will it work with our HTML5 layout?

Yes. The default Paligo HTML5 layout and most customized layouts both expose a Custom JavaScript field in publication settings. The widget is injected from there. No XSLT changes, no DITA edits.

Does it understand topic-based content?

Yes. Indexing happens against the rendered HTML, so topic boundaries, admonitions, and code blocks are read in context. Citations resolve to the topic title.

What about variants?

Each variant publication gets its own URL. Index each as a separate source so a reader on the audience-A variant gets answers from the audience-A topics, not the audience-B ones.

Does it work with versioned publications?

Yes. Each version Paligo publishes is its own URL tree. Index each version as its own source so readers on /v1/ do not get answers from /v2/.

Can we keep the built-in search?

Yes. Biel sits alongside as a separate widget for natural-language questions. Many Paligo sites run both.

How long does the install take?

One Custom JavaScript field per publication. Most teams are live in 15 minutes including indexing.

Where does our content go?

EU-hosted by default. GDPR compliant. Your content is never used to train models.

Make your Paligo docs answer questions

Start free trial Book a demo

14-day free trial · No credit card required · From $50/mo

Use a different platform? See our integration pages for ReadMe, Document360, Confluence, Docusaurus, and MkDocs.