For Paligo HTML5 publications

Ask AI for your Paligo docs

Add a page-search widget with Ask AI and a separate chatbot to your Paligo HTML5 publications. Readers can find topics or request a source-linked answer.

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, a page-search field with an Ask AI handoff 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 Biel 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. It returns matching pages and offers an Ask AI handoff to the chatbot.

→Page-search field in the navbar
→Page results with an Ask AI handoff
→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 provides its own page-search widget plus an Ask AI handoff to the chatbot. 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.	Keyword page results, with Ask AI for natural-language questions and source-linked answers.
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.	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. Keep Paligo search, replace it with Biel's page-search widget, or run both. The Biel chatbot remains a separate surface, and Ask AI can carry a search query into it.

How long does the install take?

Add the snippet to one Custom JavaScript field per publication. Indexing time depends on the size of the publication.

Make your Paligo docs answer questions

Start free trial Book a demo

14-day free trial · No credit card required

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