Categories: Magento News

Magento 2 Tutorial: How to Add Custom Header and Footer Links.

As you may know, header and footer are key elements of a website. Typically, they contain links to important pages on your site that potential customers will often want to visit before making a purchase or enquiry.

That’s not all!

Header is the first thing that people will see when they land on your site. It sets the tone for the whole site. You need to include enough information in the header to encourage customers to explore your site further. While footer of a website is just as important as the header, as it is the last chance for you to grab a customer’s attention and encourage them to complete an action, such as making a purchase or requesting information.

In this tutorial today, I will present you the way to Add Custom Header and Footer Links in magento 2.

I. How is Custom Header Links added in Magento 2?
Step 1: Create a custom module based on Magento 2 structure in the folder app/code.
Ex: Magento 2 root directory/app/code/Dckap/Newlink/
Step 2: Create module.xml file in the below path to define your Magento 2 extension.

Magento 2 root directory/app/code/Dckap/Newlink/etc/module.xml

<?xml version=“1.0”?>

<config xmlns:xsi=“http://www.w3.org/2001/XMLSchema-instance”xsi:noNamespaceSchemaLocation=“../../../../../lib/internal/Magento/Framework/Module/etc/module.xsd”>

<module name=“Dckap_Newlink” setup_version=“2.0.1”></module>

</config>

 Step 3: Create routes.xml in the below path for your custom link.
Magento 2 root directory/app/Dckap/Newlink/etc/frontend/routes.xml

<?xml version=“1.0”?>

<config xmlns:xsi=“http://www.w3.org/2001/XMLSchema-instance”xsi:noNamespaceSchemaLocation=“../../../../../../lib/internal/Magento/Framework/App/etc/routes.xsd”>

<router id=“standard”>

<route id=“newlink” frontName=“newlink”>

<module name=“Dckap_Newlink” />

</route>

</router>

</config>

Step 4: Create layout file in the below path for a custom header.
Magento2 root directory/app/Dckap/Newlink/view/frontend/layout/header.xml

<?xml version=“1.0”?>

<page xmlns:xsi=“http://www.w3.org/2001/XMLSchema-instance” layout=“1column”xsi:noNamespaceSchemaLocation=“../../../../../../../lib/internal/Magento/Framework/View/Layout/etc/page_configuration.xsd”>

<body>

<referenceBlock name=“header.links”>

<move element=“test-last” destination=“header.links”/>

<block class=“Dckap\Newlink\Block\Header” name=“test-link” after=“my-account-link”/>

</referenceBlock>

</body>

</page>

Step 5: Create block file that is referred in the layout file in the below path.

Magento2 root directory/app/Dckap/Newlink/Block/Header.php

<?php

namespace Dckap\Newlink\Block;

class Header extends \Magento\Framework\View\Element\Html\Link

{

protected $_template = ‘Dckap_Newlink::link.phtml’;

public function getHref()

{

return__( ‘testuser’);

}

public function getLabel()

{

return __(‘Test Link’);

}

}

?>

For third party URLs follow the above code.

Step 6: Create template file that is referred to the block file in the below path.

Magento2 root directory/app/Dckap/Newlink/frontend/templates/link.phtml

<li>

<a <?php echo $block->getLinkAttributes() ?>><?php echo $block->escapeHtml($block->getLabel())?>

<?php echo($block->getCounter()) ? ‘<span>‘ . $block->escapeHtml($block->getCounter()) . ‘</span>‘ : ”; ?>

</a>

</li>

 Step 7: After completing the above steps run the below Magento2 upgrade command in the command prompt:

php bin/magento setup:upgrade

 After running the above command, clear all the Magento cache and check whether the extension is installed successfully in the Magento 2 admin side.

II. The fast and smooth way to add Custom Footer Links in Magento 2:
Step 1: Now to add custom footer link follow the above first 3 steps and replace the layout file with the below code:

Magento2 root directory/app/Dckap/Newlink/view/frontend/layout/footer.xml

<?xml version=“1.0”?>

<page xmlns:xsi=“http://www.w3.org/2001/XMLSchema-instance” layout=“1column”xsi:noNamespaceSchemaLocation=“../../../../../../../lib/internal/Magento/Framework/View/Layout/etc/page_configuration.xsd”>

<page>

<referenceBlock name=“footer_links”>

<block class=“Magento\Framework\View\Element\Html\Link\Current” name=“2custom-link”>

<arguments>

<argument name=“label” xsi:type=“string”>Footer Link</argument>

<argument name=“path” xsi:type=“string”>testuser</argument>

</arguments>

</block>

</referenceBlock>

</page>

Step 2. There are 2 ways of getting the argument values:
1.By using block file. (used for header link)
2.By specifying argument values in the layout file.(used for footer link)

Step 3: Now follow the above step(step 7).

Check the browser to see your custom header and footer links.

Hopefully, this blog will be a help for you to add custom header and footer links in Magento 2 and make your site more attractive and clearer.

Related Blogposts You May be Interested In:

Phuong Pham

Recent Posts

Automation Tools for Developers in 2026: The Ultimate List for Smarter, Faster Development

The pace in the software development landscape has never been faster. The world, in turn,…

1 hour ago

How to Manage Development Teams in a Growing Magento Agency

Growing Magento development agencies face increasing operational and technical complexities as teams expand rapidly. Multiple…

3 days ago

How Modern Businesses Can Transform Supply Chain Communication at Scale

The way companies exchange data with their trading partners can make or break operational efficiency.…

1 week ago

How Developers Can Master Modern Website Protection Without Losing Momentum

Modern websites are built to be fast, dynamic, and secure. At the same time, developers,…

1 week ago

Top Blockchain Platforms Every Developer Should Know in 2026

The blockchain development landscape has exploded with opportunities. Whether you're building decentralized apps, smart contracts,…

1 week ago

Powerful Benefits of IoT Integrating in Software Applications

Imagine a device that notifies you about all-day activities, reminds you to take your pills,…

2 weeks ago