PrestaShop Guides

PrestaShop 8 & 9: Why Disabling 'Display Brands' Causes 404 Errors and How to Fix It

Navigating the intricacies of a new PrestaShop version, especially after a significant migration, can present a myriad of unexpected challenges. At Migrate My Shop, we frequently encounter merchants grappling with post-upgrade quirks that can impact everything from storefront display to critical SEO rankings.

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. This scenario is a prime example of how a seemingly simple configuration change can have profound, unintended consequences.

PrestaShop ManufacturerController logic diagram showing 'Display Brands' setting causing 404
PrestaShop ManufacturerController logic diagram showing 'Display Brands' setting causing 404

The Problem: Disabling 'Display Brands' Leads to Site-Wide 404s

The user, Twista, reported that after migrating their shop to PrestaShop 8, they attempted to turn off the "Display Brands" setting within the PrestaShop back office (found under Shop Parameters > General). Their intention was likely to remove brand links or sections from their storefront, perhaps to streamline navigation or de-emphasize manufacturers. 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, a nightmare for any e-commerce business.

Initially, like many merchants in a similar situation, the user suspected the migration module (in this case, Migration Pro by Prestahero) might be at fault. It's a common and understandable assumption when issues arise immediately 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. This means the controller effectively goes "offline" for brand-related requests.

// Simplified representation of ManufacturerController::initContent() logic
if (Configuration::get('PS_DISPLAY_MANUFACTURERS')) {
// Logic to fetch and display brand list and individual brand pages
// ...
} else {
// If 'Display Brands' is OFF, the controller sets a 404 error
$this->redirect_after = '404';
}

This design choice means that flipping the 'Display Brands' switch to OFF doesn't just remove links from your navigation; it completely disables the underlying pages, making them inaccessible and causing a 404 error for any direct access or search engine crawl attempt. This behavior is consistent across PrestaShop 8 and 9.x versions.

The Immediate Impact on SEO and User Experience

The consequences of this behavior are severe for SEO. When search engine crawlers encounter 404 errors for pages that were previously indexed, it signals to them that the content no longer exists. This can lead to:

  • De-indexing: Your brand pages will be removed from search results.
  • Ranking Drops: Loss of organic visibility and traffic for brand-related keywords.
  • Crawl Budget Waste: Search engines waste valuable crawl budget on non-existent pages.
  • Poor User Experience: Visitors clicking on old links or bookmarks will land on a dead page, leading to frustration and increased bounce rates.

The Immediate Solution: Turn It Back On!

The good news is that nothing is permanently lost. The brand data (manufacturers, their descriptions, associated products, and URLs) remains intact in your database. The moment you re-enable the 'Display Brands' setting in Shop Parameters > General, all your brand pages will immediately return to their normal, accessible state.

The *Correct* Way to Hide Brands Without Causing 404s

If your goal is to remove brand links from your storefront navigation or specific modules without disabling the underlying pages (which is crucial for SEO), you must approach it differently. The solution lies in theme and module customization, not in the core 'Display Brands' setting.

1. Unhooking the Brand List Module

PrestaShop typically displays brand lists using a module, often named ps_brandlist (or similar). You can control where this module appears without affecting the core pages:

  • Navigate to Design > Positions in your PrestaShop back office.
  • Search for the ps_brandlist module.
  • You can either unhook it from specific display positions (e.g., displayLeftColumn, displayFooter, displayHome) or configure the module itself if it has options to hide the list.
  • This method removes the visual links while keeping the brand pages live and indexable.

2. Theme Customization

For more advanced control, or if your theme has hardcoded brand links, you might need to edit your theme's Smarty template files (.tpl). This requires a good understanding of PrestaShop theme development:

  • Identify the specific .tpl files responsible for rendering brand links (e.g., in your header, footer, or product pages).
  • Comment out or remove the Smarty code that generates these links.
  • Always make a backup of your theme files before making direct edits. Consider using a child theme to ensure your changes are not overwritten during theme updates.

3. CSS Hiding (Temporary/Last Resort)

While not ideal for accessibility or long-term SEO, you could use CSS to visually hide brand elements. This should only be a temporary measure:

  • Inspect the brand links or sections on your storefront to identify their CSS classes or IDs.
  • Add display: none; to these elements in your theme's custom CSS file.
  • Caution: Search engines can sometimes detect hidden content, and it doesn't prevent the content from being loaded, just displayed.

Post-Resolution SEO Actions

Once you've re-enabled 'Display Brands' and confirmed your pages are live again, it's crucial to take proactive SEO steps:

  • Request Reindexing in Google Search Console: Go to Google Search Console, use the URL Inspection tool for a few of your brand pages, and request reindexing. This tells Google to recrawl and update its index faster than waiting for its natural crawl schedule.
  • Monitor Crawl Stats: Keep an eye on your crawl stats in Search Console to ensure Google is now successfully accessing your brand pages.
  • Check for Broken Links: Use an SEO audit tool to scan your site for any remaining internal broken links that might have occurred during the 404 period.

Why This Matters for Migrations

This incident underscores a critical aspect of e-commerce migrations: understanding the core behaviors of your new platform version. While migration modules like Migration Pro by Prestahero are excellent for transferring data, they cannot alter the fundamental logic of the PrestaShop core. Issues like this highlight the importance of:

  • Thorough Post-Migration Testing: Always test all functionalities, not just data integrity.
  • Understanding Core Settings: Familiarize yourself with how key settings operate in the new version.
  • Expert Guidance: When in doubt, consult with PrestaShop experts who understand the platform's nuances.

At Migrate My Shop, we specialize in ensuring smooth PrestaShop migrations and providing the expertise to navigate these complex scenarios. Don't let a simple setting derail your SEO efforts. Understand your platform, and if you need assistance, our team is always ready to help.

Share:

Start with the tools

Explore migration tools

See options, compare methods, and pick the path that fits your store.

Explore migration tools