Mastering PrestaShop CMS Pages: How to Display Your Category Tree Module
PrestaShop's robust modular architecture offers unparalleled flexibility for e-commerce merchants. However, this very flexibility can sometimes lead to head-scratching moments, especially when a seemingly straightforward task, like displaying a core module on a specific content page, doesn't behave as expected. This is a common scenario we encounter at Migrate My Shop, and it was recently highlighted in a PrestaShop forum discussion (Thread #1110684) regarding the 'Category tree links' module (ps_categorytree) on CMS pages.
For PrestaShop 8.2.7 users and beyond, integrating the category tree module into a custom CMS page can be a crucial step for enhancing navigation and SEO. Let's dive into why this module might not appear by default and, more importantly, how to fix it.
The Core Challenge: Why Isn't My Category Tree Showing on CMS Pages?
The original query from YannT perfectly encapsulates a frequent pain point: a custom CMS page is created, but the essential category tree module, usually found in a sidebar, is conspicuously absent. The user's intuition about 'hooks' being involved is spot on, as PrestaShop's entire front-office display relies on these specific attachment points.
The absence of the ps_categorytree module on CMS pages typically boils down to two primary factors:
- Module Hooking and Exceptions: Modules are designed to attach to specific 'hooks' (display positions) within your theme. Crucially, modules can also be configured with 'exceptions' – rules that prevent them from appearing on certain page types, including CMS pages.
- Theme Layout Configuration: The layout chosen for your CMS pages (e.g., full-width, with left column, with right column) directly dictates which column-specific hooks are rendered by your theme's template files. A full-width layout, for instance, often omits the left and right column hooks entirely.
Understanding PrestaShop Hooks and Module Positioning
In PrestaShop, 'hooks' are predefined positions in your theme's template files where modules can inject their content. Common hooks include displayLeftColumn, displayRightColumn, displayNav, displayTop, and displayFooter. CMS pages in PrestaShop 8.x generally support these same front-office hooks, allowing for consistent layout across your store.
For instance, the ps_categorytree module is typically hooked to displayLeftColumn or displayRightColumn. If your CMS page template doesn't render these columns, the module won't appear, regardless of its hook assignment.
The Role of Theme Layouts in CMS Pages
Many PrestaShop themes, including the default 'Classic' theme, often set CMS pages to a 'full-width' layout by default. While this provides ample space for content, it usually means that the template files for these pages (e.g., page-cms.tpl) do not include the code to render the left or right columns, and thus, their associated hooks.
Step-by-Step Solutions to Integrate Your Category Tree
Let's explore the actionable steps to ensure your category tree module appears exactly where you want it on your PrestaShop CMS pages.
Solution 1: Verify Module Exceptions in Design > Positions
This is often the first place to check, as modules can be explicitly prevented from displaying on certain page types.
- Navigate to your PrestaShop back office: Design > Positions.
- Locate the 'Category tree links' module (
ps_categorytree). You might need to use the search filter. - Click on the 'Edit' button (pencil icon) next to the module's position (e.g.,
displayLeftColumn). - In the module configuration screen, look for the 'Exceptions' section. This lists page types where the module should NOT be displayed.
- Crucially, ensure that 'CMS pages' is NOT checked as an exception. If it is, uncheck it and save your changes.
This step ensures that the module is allowed to appear on CMS pages if the underlying theme layout supports the hook.

Solution 2: Adjust CMS Page Layout in Theme & Logo
This is frequently the simplest and most overlooked solution, especially if you're using the 'Classic' theme or a theme derived from it.
- Go to Appearance > Theme and logo in your back office.
- Click on the 'Choose layouts' tab (or similar, depending on your PrestaShop version).
- You'll see a list of page types. Find 'CMS pages'.
- From the dropdown menu next to 'CMS pages', select a layout that includes the column where your category tree is hooked (e.g., 'Left column', 'Right column', or 'Two columns').
- Save your changes.
By changing the layout, you instruct your theme to render the necessary column hooks on your CMS pages, allowing the ps_categorytree module to appear automatically.

Solution 3 (Advanced): Manually Add Hooks to Your CMS Template (for Custom Themes)
If you're using a heavily customized theme or a child theme where the CMS page template (typically themes/your_theme/templates/cms/page.tpl or themes/your_theme/templates/page-cms.tpl) has been modified to a full-width layout, and Solution 2 doesn't apply or isn't sufficient, you might need to manually insert the hook.
Important: Always use a child theme for any template modifications. Never edit core theme files directly, as your changes will be lost during theme updates.
- Access your theme's files via FTP or your hosting panel's file manager.
- Navigate to your child theme's template directory, specifically the CMS page template (e.g.,
themes/your_child_theme/templates/cms/page.tpl). If it doesn't exist, copy the originalpage.tplfrom your parent theme into your child theme's corresponding directory. - Open the
page.tplfile for editing. - Locate the section where you want the column to appear. For a left column, you might place it before the main content block.
- Insert the following Smarty code for the desired hook:
{widget hook='displayLeftColumn'}- Save the file and clear your PrestaShop cache (Advanced Parameters > Performance > Clear cache).
This method directly tells the template to render the specified hook, ensuring any modules attached to it will display.
Best Practices for PrestaShop Customization and Migration
As e-commerce migration experts at Migrate My Shop, we always emphasize best practices:
- Always Use a Child Theme: This protects your customizations during theme updates and simplifies future migrations.
- Backup Your Store: Before making any significant changes to your theme or module configurations, always perform a full backup of your database and files.
- Test Thoroughly: After implementing any solution, clear your cache and test the changes on various devices and browsers to ensure everything functions correctly.
- Consider UX and SEO: Strategically placing your category tree enhances user experience by providing clear navigation and can significantly benefit your store's SEO by improving internal linking.
Integrating your category tree module into PrestaShop CMS pages is a straightforward process once you understand the interplay between hooks, module exceptions, and theme layouts. By following these steps, you can ensure your customers always have access to your product categories, no matter which page they're browsing.
If you're planning a PrestaShop migration or need expert assistance with complex customizations, don't hesitate to reach out to the team at Migrate My Shop. We're here to ensure your e-commerce platform is optimized for success.