Wiki source code of Wikis vs Nested Pages
Last modified by Eleni Cojocariu on 2026/03/19 08:16
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | What [[Wikis>>xwiki:documentation.xs.user.base.wikis.WebHome]] bring over [[Nested Pages>>xwiki:documentation.xs.user.base.page.nested-pages.WebHome]], or vice-versa: | ||
| 2 | |||
| 3 | |=Feature|=Supported by Wikis?|=Supported by Nested Pages?|=Notes/Ideas | ||
| 4 | |Set a custom Skin/Color Theme/Icon Theme|(/)|(/)| | ||
| 5 | |Set custom Panels|(/)|(/)| | ||
| 6 | |Delegate Administration/Right Management|(/)|(/)*|An administrator can give [[Admin rights>>xwiki:Documentation.AdminGuide.Access Rights.Permission types.WebHome||anchor="HAdministrationRight"]] to a user or group for a Page and all its [[children Pages>>xwiki:documentation.xs.user.base.page.nested-pages.relations.WebHome]]. While implementing rights in Farm Mode is generally more challenging with Nested Pages than with a separate Wiki, it is still possible. | ||
| 7 | |Dedicated Users and Groups|(/)|(x)|Provides isolation, both in terms of visibility and security. | ||
| 8 | |Notion of Owner|(/)|(x)|The [[Owner of a Wiki>>extensions:Extension.Wiki Application||anchor="HConfigureWiki"]] has all [[permissions>>xwiki:Documentation.AdminGuide.Access Rights.Permission types.WebHome]] in a Wiki. | ||
| 9 | |Ability to install ##JAR## Extensions|(/)|(x)|When installing an extension via the [[Extension Manager UI>>extensions:Extension.Extension Manager Application]], you can only install it for the whole Wiki. It’s not possible to install an extension only under a specific Nested Page. The XWiki Core does have some support for [[space-level>>xwiki:documentation.xs.admin.base.content-organization.WebHome||anchor="HFAQ"]] features (e.g., ##JAR## components or macros that work only in one space). You can, however, restrict their activation to certain Pages or spaces using permissions or configuration. | ||
| 10 | |Ability to install Applications/Flavors|(/)|(x)|When importing or using the [[EM UI>>extensions:Extension.Extension Manager Application]] to install an application (##XAR##), you cannot install it under a specific Nested Page (i.e., relative to a Nested Page). Similarly, it’s not possible to install a [[Flavor>>extensions:Extension.Flavor Module]] within a Nested Page. | ||
| 11 | |Ability to have a dedicated domain name/Clean URL scheme and Breadcrumb|(/)|(!)*|[*]Possible, but requires some configuration at the Apache level or via the [[URLRewriteFilter>>xwiki:Documentation.DevGuide.Architecture.URL Architecture.WebHome||anchor="HCustomizingURLs"]]. | ||
| 12 | |Ability to maintain the database easily|(/)|(x)|Each Wiki has its own schema, making maintenance, backups, and restores easy on a per-Wiki basis—ideal for farm setups. Wikis can be moved independently to another server (though some links may break, depending on usage), addressing scalability concerns. Extensions can create custom tables within a Wiki's schema, and schemas can be optimized for specific purposes, such as custom mappings. | ||
| 13 | |Ability to easily query data across instances|(x)*|(/)|[*] Since each Wiki uses an independent schema, you cannot run a single database query across multiple Wikis. However, you can query content across schemas using the [[Query Manager’s Solr>>extensions:Extension.Solr Search Query API]] syntax. In contrast, Nested Pages reside within the same Wiki (and schema), so a single database query can access data from multiple Nested Pages. For example, displaying data from different Wikis in a LiveTable is not straightforward and typically requires custom JSON. | ||
| 14 | |Ability to search in multiple instances|(/)|(/)|[[Solr search>>extensions:Extension.Solr Search Application]] indexes data independently from the database storage, so searching works across both Wikis and Nested Pages. | ||
| 15 | |Deletion of Wiki or Nested Page|(/)*|(/)|[*] Deleting a Nested Page will warn about broken links which is not the case when deleting a Wiki. Also, you cannot rollback a deleted Wiki, so unless you have a backup you've lost your data. You can't restore a deleted Page with a single click from the UI either, but at least you can restore each children Page under a Nested Page from the UI, or use a script. In other words, there's no Recycle bin for Wiki. | ||
| 16 | |Renaming of Wiki or Page|(x)|(/)|[[Page Rename>>xwiki:Documentation.UserGuide.Features.DocumentLifecycle.WebHome||anchor="HMove2FRename"]] updates backlinks automatically, but it's not the case across Wiki. | ||
| 17 | |Invite Users|(/)|(x)|You cannot invite users only for a Page, but you can [[invite users on a Wiki>>extensions:Extension.Wiki Application||anchor="HInvitesomeoneonasubwiki"]]. | ||
| 18 | |Implement a "playground"|(/)|(x)|Nested Pages share [[XClasses>>xwiki:documentation.xs.dev.data-model.x-classes.WebHome]] Pages. If you modify one XClass (e.g. ##XWiki.JavaScriptExtension##) you affect all the Pages that use it. Wikis have to duplicate the XClasses, but this means the modifications are isolated. As a consequence, it's much harder (if not impossible) to implement a "playground" using Nested Pages than using a Wiki. | ||
| 19 | |Easiness of upgrades|(x)|(/)|Harder to [[upgrade XWiki>>xwiki:Documentation.AdminGuide.Upgrade.WebHome]]: each Wiki needs to be upgraded individually, even if it's only 1 click in the UI. Also it's slower to upgrade multiple wikis (e.g. when running database migrations since each Wiki is a database). | ||
| 20 | |Easiness of creation|(x)|(/)|While it's fast to create Nested Pages in XWiki, creating a Wiki takes more time. In addition, creating a Wiki requires [[Create Wiki rights>>extensions:Extension.Wiki Application||anchor="HRights"]], while creating a Page requires [[Edit rights>>xwiki:Documentation.AdminGuide.Access Rights.WebHome||anchor="HSettingRightsforaPageandItsChildren"]]. | ||
| 21 | |Scalability|(x)|(/)|While the number of Wikis is not limited, having an XWiki instance with thousands of wikis is not recommended (each "empty" Wiki will contain thousands of internal Pages) and thus doesn't scale in practice (long time to create, hard to upgrade). Also note the limitation that installing a ##XAR## application on the farm means [[installing it on each Wiki which is resource consuming (time, memory)>>https://jira.xwiki.org/browse/XWIKI-16647]]. |
