Sub-Wikis & Documentation Mirroring

When your organization outgrows a single portal—or wants separate documentation spaces for different teams, products, or manuals (just like home.qwiki.wiki/docs and home.qwiki.wiki/manual)—you can deploy isolated Sub-Wikis directly from a parent Qwiki instance.

How Sub-Wikis Work

A sub-wiki lives in a child subdirectory beneath a parent Qwiki installation and carries a .subwiki marker plus "isSubwiki": true in its qwiki.json.

• Isolated Data & Users: Each sub-wiki maintains its own qwiki.json, users.json, content/, data/, and uploads/.
• Unified Code Updates: Sub-wikis inherit core code updates when the parent wiki updates, keeping maintenance centralized.
• Wayfinding & Breadcrumbs: Sub-wikis display a parent-to-child header breadcrumb (parentTitle / parentUrl, configurable in ⚙️ Settings ➔ 📡 Feeds & Integrations), and the parent wiki can optionally list active sub-wikis with chapter counts in the left sidebar (Show Subwikis in Left Sidebar Navigation).

Deploying a New Sub-Wiki

1. Log in as Admin on the parent wiki and open admin ▾ ➔ 🌐 Subwikis.
2. Under Deploy New Subwiki, fill in:
   • Subwiki Title: Display name for the portal.
   • Folder Slug: URL path segment under the parent wiki (for example, manual or engineering-electrical).
   • Initial Admin Username & Password: Isolated administrator credentials for the new sub-wiki.
3. Choose initialization mode:
   • Leave Mirror Official Qwiki Documentation and Include sample starter pages unchecked for a clean starter portal (a minimal getting-started welcome book).
   • Check Include sample starter pages to copy editable demo guides into the sub-wiki.
4. Click 🚀 Deploy Subwiki.

Official Qwiki Docs Mirror (/docs)

Click 📚 Deploy Qwiki Docs Mirror inside 🌐 Subwikis—or check Mirror Official Qwiki Documentation—to provision or refresh an official Qwiki documentation mirror sub-wiki.

• Mirror sync uses strict anti-overwrite guards: it only updates designated isDocSubwiki mirror instances and refuses to overwrite custom user documentation.
• When you instead publish bespoke manuals via qwiki-builder (such as home.qwiki.wiki/manual/), leave Mirror Official Qwiki Documentation unchecked so your custom manual remains independent.