How to create internal links to a section on the same page in HTML


You can create a link to a specific section or element on a the same webpage in two steps:

  1. Assign the section/ element an id. <p id="section-1">The link jumps to this paragraph</p>
  2. Add the id value to the link. <a href="#section-1">Jump to section 1</a>
  3. Linking to a section on different webpage.
  4. Create link to element of a different website.

You can try it out by clicking on any of the links above.

  • On long articles: If you have a really long articles, its makes it easy for your users to navigate your website.
  • A specific call to action on a webpage: Jump links are perfect you want your readers to subscribe, or contact or any other action located lower in the page.
  • One page website: If you own a one page website, you know that your users can easily go to the different sections of your webpage just by clicking the navigation links at the top.


In HTML, you use an id attribute to identify one specific element on a webpage. Just like each person has an unique Identification number, the id value you create and assign to your HTML element should be unique on that specific webpage.

Rules for creating ids

  • Each of your ids must be unique on that one web page.
  • Each of your ids must not have spaces in the name. If you want to seperate words and numbers, use hyphens and underscores instead of spaces.

in my case, I want to be able to jump to my subheadings so this is how my id’s will look like:

<h2 id="assign-id">Create same page internal links: Assign an id to the section/ Element</h2>
<h2 id="add-link">Create same page internal links: Add the id value to the link</h2>

If you are using markdown, headings are automatically converted to their lowercase id equivalent seperated by hyphen with no special characters. If you inspect my headings, this is what you will see. See what I mean. screenshot of my heading's id

Normally, you use links to point to different webpages and website. To make your link to point to the current webpage, you use a href="/" or the full url of the current webpage href=""

To point to a specific part of a web page, you add a pound sign followed by the id name at the end of the url ie. href="/#assign-id" or href=""

If you click on the navigation items at the top, you will be able to jump to specific parts of the web page.

For you to add a link to a different page, you will need the url of that page and the id value of that section you want to link to. You will then use the full url of the web page and then add the id value at the end of the url. Example:

I want to link to the books section a different page on this website. The url is and the heading is books. I can create a link as follows:


<a href="">HTML and CSS books</a>

Result: HTML and CSS books

If you are linking to a different website, you will have to find out if the website has assigned ids to the section you want to link to. You can do this by:

  • Inspect Q element.
  • Use the select tool.
  • Check the html code for id value.

If the element does not have an id value, you cannot link to that section. If it does then you can just add the pound sign and id to the url of the website and you are good to go.


<a href="">Which insects do people eat</a>

Result: Which insects do people eat

  • Choose the top most part of your website. Which is the logo.
  • Get it id value.
  • For me its the website’s logo with the id “logo”.

So the link to go to the top will become:

Code: <a href="">Top</a>

Result: Top

  • Choose the bottom most part of your website.
  • Get it id value.
  • For me its the footer with the id “footer-style”
  • So the link to go to the bottom will become:

Code: <a href="">Go to bottom</a>

Result: Go to bottom

author's bio photo

Hi there! I am Avic Ndugu.

I have published 100+ blog posts on HTML, CSS, Javascript, React and other related topics. When I am not writing, I enjoy reading, hiking and listening to podcasts.