How can I redesign Magento toplinks?

How can I redesign Magento toplinks?

October 14, 2026 · Illustrated author avatarBy Stefan Bogdanescu
How can I redesign Magento toplinks?

Designing Toplinks for Your Magento Store: A Step-by-Step Guide

As a senior developer, I often receive inquiries about customizing various aspects of e-commerce platforms like Magento. One common request is to redesign the default toplinks that appear at the top of every storefront.

Understanding the Default Magento Toplink Layout

The default Magento setup includes several built-in links in the header area, such as “Home”, “About Us”, “Contact Us”, etc. These are usually displayed as a dropdown menu in the top right corner of your website.

To locate these links and their associated files, you can navigate to the following path in your Magento installation:

app/design/frontend/<your_theme>/Magento_Theme/templates/html/toplinks.phtml

This is where the core logic for rendering the toplinks resides. However, modifying this file directly is not recommended, as it may cause issues with future updates.

Creating a Custom Toplink Module

For a more robust and sustainable solution, we should create a custom module to override the default behavior. This allows us to maintain our changes even if Magento’s core files are updated in the future.

Here’s an outline of the steps involved:

  1. Create a new module: In your Magento installation, navigate to app/code folder and create a new directory with a unique name (e.g., Company_Toplinks).

  2. Define the module configuration: Create a registration.php file inside the newly created module:

<?php

\Magento\Framework\Component\ComponentRegistrar::register(
    \Magento\Framework\Component\ComponentRegistrar::MODULE,
    'Company_Toplinks',
    __DIR__
);
  1. Override the default top links: To spread the links across the full width of the top area and assign icons to each link, you’ll need to override the topinks.phtml template.

    • Create a new folder structure: app/design/frontend/<your_theme>/Magento_Theme/templates/html/toplinks.phtml
    • Copy the original toplinks.phtml file from Magento’s core theme (usually located at vendor/magento/theme-frontend-blank/Magento_Theme/templates/html/topinks.phtml) and paste it into your custom folder.
  2. Add a new block to display the top links: In the topinks.phtml file, you can add a new container element to hold your custom top links:

<div class="custom-toplinks">
    <!-- Your custom HTML code goes here -->
</div>
  1. Create a custom block class: To generate dynamic content for your custom top links, create a new block class in your module:

    • Create a new file app/code/Company/Toplinks/Block/Custom.php
    • Implement the necessary functionality to fetch and display the link data (you can use Magento’s layout XML or a custom data provider)
  2. Assign the custom top links block to the main container: Update your theme’s layout XML file (your_theme/Magento_Theme/layout/default.xml) to assign your new block to the main content area:

<referenceContainer name="header.container" htmlTag="div" htmlClass="page-header">
    <block class="Company\Toplinks\Block\Custom"
           template="html/custom_toplinks.phtml"
           name="custom.toplinks"
           before="-"/>
</referenceContainer>

Additional Customization Options

To further customize the appearance of your top links, you can:

  • Update the CSS styles for the custom-toplinks container.
  • Modify the templates and block logic to include icons (you can use font-based icon sets like Font Awesome).
  • Create additional layout XML files to organize your custom elements.

Conclusion

Redesigning Magento’s default toplinks requires a combination of module development, template overriding, and layout configuration. By following this approach, you can create a sustainable solution that maintains compatibility with future Magento updates.

Remember to backup your existing theme before making any changes, and always test your modifications thoroughly in a development environment before deploying them to a live site.

For more detailed guides on Magento customization and module development, consider exploring the resources available at Laravel Company.

Extensions Themes Configuration Errors

Our network