URLs

Last modified by Eleni Cojocariu on 2026/11/16 18:36

Explanation

Every page of a wiki is reached through a URL, and XWiki builds those URLs from a scheme that is configuration rather than content. The default scheme spells out the web application, the servlet mapping, the action and the page:

https://example.org/xwiki/bin/view/Sandbox/WebHome
                    ^^^^^ ^^^ ^^^^ ^^^^^^^^^^^^^^
                      |    |    |         page reference
                      |    |    action performed on the page
                      |    servlet mapping
                      context path of the web application

Each of those segments can be removed or changed. Short URLs covers dropping the context path and the servlet mapping so that the address above becomes https://example.org/Sandbox/WebHome, with one page per way of doing it: the bundled UrlRewriteFilter, Apache HTTP Server, Nginx, or deploying XWiki as the root web application.

On an instance serving several wikis, the URL also decides which wiki answers the request. Wiki URL Resolution gives the two algorithms XWiki uses, path-based and domain-based, and Switch to Domain-Based URLs is the change from one to the other.

URLs also go the other way, from the wiki out to other sites. Configure Interwiki Links registers the short prefixes that let a page link to an external wiki by name instead of by address.

FAQ

Does changing the URL scheme break the links already stored in pages?

No. XWiki stores links as page references and renders them through the URL scheme in force, so every stored link follows the new scheme the moment it changes. Addresses that were copied out of the wiki, into a bookmark or another site, are the ones that need a redirect from the web server.

More

To find more about the current topic, you can search or use the table below and filter the columns to narrow your choices.

Related

Get Connected