PrestaShop 8 Brands 404 Error: The Hidden SEO Trap of Disabling Manufacturers
Navigating the intricacies of a new PrestaShop version, especially after a migration, can present unexpected challenges. A recent discussion on the PrestaShop forum highlighted a critical issue faced by a merchant after upgrading to PrestaShop 8: disabling the 'Display Brands' option in the back office led directly to a site-wide 404 error for all brand-related pages, causing significant SEO damage.
The Problem: Disabling 'Display Brands' Leads to 404s
The user, Twista, reported that after migrating their shop to PrestaShop 8, likely with the help of a module like Migration Pro by Prestahero, they attempted to turn off the "Display Brands" setting within the PrestaShop back office. Their intention was likely to remove brand links or sections from their storefront. However, this seemingly innocuous action resulted in all brand pages, including the main brands index and individual manufacturer pages, returning a 404 "Not Found" error. This immediately triggered SEO concerns and ranking drops.
Initially, the user suspected the migration module might be at fault, a common assumption when issues arise post-migration. However, the root cause was far more fundamental to PrestaShop's core architecture.
The Technical Explanation: Core PrestaShop Behavior
A helpful reply from "Knowband Plugins" clarified that this behavior is not a bug introduced by any migration module, but rather a core design decision within PrestaShop 8 (and even 9.x). The issue stems from how PrestaShop's ManufacturerController handles the 'Display Brands' configuration.
Specifically, the entire logic within the initContent() method of the ManufacturerController is conditional. It checks the value of the PS_DISPLAY_MANUFACTURERS configuration setting. If this setting is turned off, the controller doesn't just hide the content; it actively sets a redirect to a 404 error page.
// Simplified representation of ManufacturerController::initContent() logic
if (Configuration::get('PS_DISPLAY_MANUFACTURERS')) {
// Display brand pages and content
} else {
// If 'PS_DISPLAY_MANUFACTURERS' is OFF, set 404
$this->redirect_after = '404';
}
This means that when you toggle off 'Display Brands' in Shop Parameters > General, you are effectively taking the entire manufacturer/brand controller offline, making all associated URLs inaccessible and returning a 404 status.
The Immediate Fix and Best Practice
The good news is that the fix is straightforward and immediate. Since the URLs and underlying brand data are not deleted but merely made inaccessible, turning the 'Display Brands' setting back on will instantly restore all brand pages. They will return without error, and their content will be available again.
For merchants who wish to remove brand entries from their shop's navigation or front-end display without deactivating the pages themselves (which is crucial for SEO), the recommended approach is to manage this at the theme or module level. Instead of using the global 'Display Brands' setting, you should:
- Unhook or Configure the Brand List Module: Most PrestaShop themes use a dedicated module (e.g.,
ps_brandlistor similar) to display brand links in sidebars, footers, or specific pages. You can unhook this module from its display positions (e.g.,displayLeftColumn,displayFooter) or configure its settings to hide the links. - Theme Customization: If the brand links are hardcoded or integrated within your theme's templates, you might need to edit the relevant Smarty template files (e.g.,
.tplfiles) to comment out or remove the code responsible for rendering brand lists.
By doing so, the brand pages remain live and indexable by search engines, preserving your SEO value, while their visibility on the storefront is controlled as desired.
Post-Resolution SEO Action
Given that the brand pages were returning 404 errors for a period, it is highly advisable to take proactive SEO steps once the issue is resolved:
- Request Reindexing: Use Google Search Console (or similar webmaster tools for other search engines) to request reindexing for the affected brand pages. This will prompt search engines to recrawl and update their index faster than waiting for their natural crawling cycle.
- Monitor Crawl Errors: Keep an eye on the "Crawl Errors" report in Search Console to ensure that the 404 errors for these pages have indeed disappeared and that they are being successfully crawled again.
This community insight underscores the importance of understanding PrestaShop's core configurations and their broader impact, especially on SEO. While a migration can sometimes introduce new challenges, knowing the platform's inherent behaviors is key to efficient troubleshooting and maintaining a healthy online store.