How URLs in Publii works?

Publii URLs are fully translatable; with the available options, you have full control over the URL content.

For Asian languages, Publii uses transliteration to generate slugs of post titles, tag names, and author names.

Below, we can see some examples of URLs for specific page types:

Homepage

https://example.com - URL to the main page of your website.
https://example.com/page/1/ - URL to the n-th page of the homepage post listing.

Post page

https://example.com/post-slug/ - URL to the post when pretty URLs are enabled.
https://example.com/post-slug.html - URL to the post when pretty URLs are disabled.

Page URLs

https://example.com/page-slug/ - The URL to an individual page.
https://example.com/parent-page/child-page/ - The URL to a nested (child) page when hierarchical structures are in use.

Tag page

https://example.com/tag-slug/ - URL to the tag page when the tags prefix is empty.
https://example.com/tags/tag-slug/ - URL to the tag page when the tags prefix is "tags".
https://example.com/tag-slug/page/1/ - URL to the n-th page of the tag page post listing.

Tags page

https://example.com/tags/ - URL to the tags page when the tags prefix is "tags".

Author page

https://example.com/authors/author-slug/ - URL to the author page when the author's prefix is set to the default value ("authors").
https://example.com/team/author-slug/ - URL to the author page when the author prefix is set to the "team" value.
https://example.com/authors/author-slug/page/1/ - URL to the n-th page of the author page post listing.

Error page

https://example.com/404.html - default URL to the 404 error page (if the theme supports error pages).

Search page

https://example.com/search.html - default URL to the search page (if the theme supports search pages).

Custom Homepage

If you set a Page as the homepage, its URL becomes https://example.com, and any post listing (previously at the main URL) can be moved to a subdirectory, like "blog." In this case, the post listing URLs would appear as https://example.com/blog/page/1/.

Post Prefix and Tag URLs

If you configure a prefix for posts, such as "blog," it will appear in the post URLs as https://example.com/blog/post-slug/. For tags within this structure, URLs adjust to include both the post and tag prefixes, such as https://example.com/blog/tags/tag-slug/.