Customising the template
This section is for advanced users — lead authors and content tool developers who set up or adapt the documentation portal for a customer.
Use it when you need to change branding, the home page, in-topic navigation and TOC, hub pages, colour mode, or search beyond day-to-day topic authoring.
Docusaurus is a powerful tool built on React, which means your customisation options are more advanced than these covered in this section.
When customising a new portal, we recommend referring to the official Docusaurus documentation, and using an LLM assistant in your code editor.
Using this hub page type
Only use this type of landing page if absolutely necessary. 3di’s default in the information models this template is suitable for is to avoid section landing pages (use expanding nodes in the TOC instead)
Topics in this section
Branding the portal
Change logos, favicon, social card, brand colours, and footer text for a customer portal.
Customising the home page
Change the home page hero, tiles, and quick links.
Customising topic controls
Change or hide the On this page label, feedback and print buttons, and re-enable previous/next pagination on doc pages.
Customising hub pages
Choose how a sidebar category behaves — no landing page, an autogenerated card index, or a hand-written hub with DocCardList.
Customising dark theme
How this template handles light and dark mode, how to turn dark theme off, and where to adapt graphics for both themes.
Customising the search
Change, restyle, or replace the local search plugin used in this template.