Skip to main content

Table of Contents

  • Author:
  • Updated date:

Creating a Table of Contents in your Hub

I'll probably write this and then the powers-that-be will create a Capsule to do in a few seconds what may take a while to create.

Which is fine by me! I wish there was such a capsule!

But in the meantime you can do it the way I've done it.

Why have a Table of Contents?

If you go to my hub on HubScore, and after what I call the Introduction Capsule, you'll notice that I have a capsule titled Table of Contents.

I figured that I have a long hub, and there's information there that people might want to go back to as a quick reference. Rather have them scroll through the entire hub they can browse through the Table of Contents list, click, and jump straight to the bit that they need.

To be quite honest I've put it there to make it easier for ME to find the information.

I used the Links Capsule to pull it off.

You could probably use the Text Capsule to do it too.

It's important to note that while you're in edit mode the Table of Contents won't work properly. It won't jump you down on the same browser window. It'll open a new browser window. So keep that in mind.

Step 1.

Open up your hub. In the view that the general public sees (ie: not in edit mode).

Copy and paste your capsule titles into a Notepad text document (or whatever you feel like using) EXACTLY as they are. Make a list of the ones you want in your table of contents.

This is what it looks like when you right click in FireFox.

This is what it looks like when you right click in FireFox.

Step 2.

You now have to enter the alien world of HTML.

To do this you have to view the Page Source of your hub.

A reminder: make sure you're in the normal view of your hub, not in edit mode.

In Firefox you Right click and select View Page Source. In Internet Explorer you Right click and select View Source. It will open up a new page, like a Notepad text document.

Next you want to FIND each of the titles that you've copied and pasted. One at a time.

Now lets say you have a Capsule that you've titled "Café Royale", you want to search for that IN the source code.

The CTRL F keys should bring up the ability to do a search. Copy and paste Café Royale in and find it.

Scroll to Continue

You'll find something like this:

<div id="mod_487697" class="module moduleImage"><h2>Café Royale2</h2>

If it's wrapped in the h2 tags, then that's more than likely our target! If it's not, then keep lookin (because you may have used the word more than once).

What you do next is "grab" the div id. In this illustration it is mod_487697.

Copy and paste that underneath the corresponding title in your Notepad doc. You'll be using it later.

Go through and find every div id for each of your titles. Copy and paste each one.

Step 3.

Now lets say your hub is what you do next is add a # to the end of that and copy and paste to the start of each of your div id's that you have in your list.

So it would look like this:

What you have now is a link that goes STRAIGHT to that module. Each of those "module ID's" are unique. Try it out with one of your own in the address field of your browser window.

BOOM. Straight there.


Step 4.

Now go into Edit Mode on your hub and add a Links Capsule. Move it to near the top. I position mine AFTER an introduction. I don't want people and particularly Search Engines to see it straight away. It being in second position seems like a good place to put it.

Now go through your Notepad list. Copy and paste each in Link URL/Link Title and Add Link. No need to add a Link Description. But that's up to you.

Keep doing that until it's all done.

Then of course save it.

And publish it.

And then try it.

How'd you go?

Hopefully it worked for you. It should. If it didn't then you've probably made an itty bitty mistake somewhere. HTML is unforgiving. You leave anything out or accidentally put anything in (even a space), and it won't work.

If you're unfamiliar with HTML it can be a bit daunting but if you've got a keen eye and a sense of adventure then keep at it and you'll get it right eventually.

Learn more about Hubpages


em_saenz on April 25, 2019:

Thank you so much for this tutorial. It was great fun to do. I love adding to my knowledge of how the web works

Natalie Frank from Chicago, IL on July 18, 2018:

What a wealth of information! A quick questions. Is it really worth it to use a table of contents for long articles with subheadings? I went to look at the source code and it just seems like it would take quite some time to do and I don't know if it would actually help in terms of ranking or traffic.Thanks for a stellar article!

Dexter Whinfield from Saint Vincent and the Grenadines on June 25, 2018:

I was looking for this. Thank you!

Lissa Clason from Fayetteville, NC on June 17, 2018:

Thank you for writing this hub, I just made a 4600 word game guide hub with 17 different subsections and having a table of contents will help people navigate exactly to what they need without getting lost. Your instructions were very clear and helped me learn how to do this easily. I never realized there was so much HTML code on one hub!

Eric Seidel from Baltimore Maryland on October 10, 2014:

Thank you so much for this! Definitely cleans up a long Hub well. I now a new-found respect for people that actually make HTML code. I have to admit it was daunting at first, but your instructions were spot on and very helpful.

Shamim Rajabali from Texas on October 06, 2014:

Thanks for sharing this. I miss the TOC in Squidoo, it was so easy.

CruiseReady from East Central Florida on October 05, 2014:

Many thanks for the wonderful instructions. Well done! A TofC is something I have managed to make on another site, but had no idea how to do it here.

JanieceTobey on September 20, 2014:

Thanks so much for this info on how to create a Table of Contents on Hubpages. I made them all the time on Squidoo....but the technique was just a little different because of differences in the two platforms. I'm excited to give it a try on Hubpages as well!

Adele Jeunette on September 17, 2014:

It's nice that you've given instructions for this. I wonder of the gurus at Hub Pages can give us a way to generate this automatically. It was a really great feature we had in Squidoo. How about it, guys?

Jeanette from Australia on September 17, 2014:

Ahhh. Perfect. Just what I was looking for. Thanks!

MacPharlain on September 09, 2014:

The hacks are strong in this one.

Thanks for the info, glad to see some of the old workarounds from the other site work here, too.

Deb Bryan from Chico California on September 09, 2014:

Brilliant! Thank you! I have a tutorial which needs to have links to sections because each person will be at a different step when they arrive. This is perfect! I had module links there when the lens transferred into a hub, but, no idea how to revise it. Thanks again! Deb

Karen from U.S. on September 09, 2014:

This is very helpful -- thanks! It does sound a little tedious to create, but there are a couple of ex-Squidoo lenses now hubs which will be more useful if they do have a TOC.

Susan300 on September 06, 2014:

Bookmarking!!!! :)

Rhys Baker from Peterborough, UK on April 05, 2014:

Outstanding. Really easy to follow. I am adding this technique to my latest hub. Thanks for sharing such great advice

Nathan Bernardo from California, United States of America on March 25, 2014:

Very good, easy to follow instructions. Thanks for sharing.

SpaceShanty from United Kingdom on March 04, 2014:

Thank you sooo much! The only issue I had is that it puts them in reverse order, so you should start by adding the last link (bottom capsule) first. Apart from that it works like a dream!

Frank Sturm from Massachusetts on January 22, 2014:

Awesome article! Took me two seconds to figure this out, when I thought it'd take me forever. Definitely helps organize my longer hubs. Question: Does having a Table of Contents hurt your ranking with Google or Hub Pages because you are linking multiple times to your site? Not sure if that even makes sense.....

Evan Smiley on January 18, 2014:

This was so helpful!!! I'm new to making hubs, and I've been trying to find ways to make them easily-accessible and professional! This is great for my information dense hubs! Thank you so much! The foreign world of HTML is a little less scary!

Ronald E Franklin from Mechanicsburg, PA on January 03, 2014:

I'm impressed with the way you presented your info - step-by-step with examples. I don't see how anyone could go wrong in following the process. Good job!

Ceres Schwarz on April 19, 2013:

This is really very useful. I agree that it would be great for long hubs to have a table of contents so that the readers can easily skip to and find what they're looking for. Your hub explained how to have a table of contents in a simple and concise manner. I'll be sure to try this on any hub that might need a table of contents.

sarahshuihan on December 19, 2012:

super awesome! I might have to try this when I write a long hub. I am definitely sharing this :)

seanorjohn on December 19, 2012:

Will try to set this up. Great work. Voted up

Rajan Singh Jolly from From Mumbai, presently in Jalandhar, INDIA. on December 19, 2012:

darkside, got it right the first time. Though it an extra bit of time and work it adds to the value of the hub I believe. I always wondered how to go about getting the internal linking done and this hub is just the answer.

Thanks for this very useful and apt tutorial. Voting this up useful, awesome and interesting. Sharing it over so that others may benefit.

Nancy Yager from Hamburg, New York on September 14, 2012:

Thank you so much. This is awesome. You are right though, the capsule in Squidoo is much easier. Voted up and Shared.

Rosa Marchisella from Canada on July 08, 2012:

OMG!!! That freaking AWESOME!!! THANK YOU!!! Must share with all my followers!

John Crowley from Sheffield on June 27, 2012:

Just used this. Works a dream. Thanks again!

Lisa from Northeast U.S. on June 19, 2012:

Love this - voted up!

Blurter of Indiscretions from Clinton CT on June 19, 2012:

Fantastic! Voted up and shared!

Rajan Singh Jolly from From Mumbai, presently in Jalandhar, INDIA. on June 19, 2012:

Awesome hub. Bookmarked to reread later as I'm not good with html stuff.

Thanks for sharing.

Voted up, useful and shared.

Ghostwolfe on April 09, 2012:

This is awesome, just tried it on one of my hubs and it is easy to do and doesn't take up a lot of time. Thank you for the information and for taking the time to write this hub. Voted Up.

Robie Benve from Ohio on April 04, 2012:

Excellent information, very clearly explained. Thanks! :)

dragnhaze on March 26, 2012:

Great information, I had read a hub from a different hubber who had explained how to put the anchor link in the text, but it did not work properly when I tried. I will have to give this a try for sure. Thanks for SHARING voted up and useful, interesting and awesome.

Joanna McKenna from Central Oklahoma on March 26, 2012:

This is so cool! Years ago when I built web pages from scratch, I knew the code for "jump to" links, but had NO idea there was a way to do this in Hubpages!

I don't have many hubs long enough to use this tip appropriately or effectively, but do have at least one that could use a TOC.

Thanks! Voted UP and useful! ;D

wayseeker from Colorado on February 20, 2012:

Such wonderful information. You have a number of hubs that are just invaluable. Nice work and thank you!


Brandon Lobo on February 06, 2012:

Oh I'm back 2 months later. I bookmarked the hub for future reference and I'm going to use it on my next hub :)

Mike from New Hampshire on January 07, 2012:

Thank you! Thank you! Thank you!

What a helpful and well put together hub.

Hopefully hubpages adds tables of contents as an option one day, but in the meantime this will do :)

Brandon Lobo on December 03, 2011:

Voted up, useful awesome and interesting. Thanks for this wonderful hub. Will try it out on my next hubs

smilingjimdickson from Too close to the moon on November 15, 2011:

Hey Darkside, you've just stopped me scratching my head, the neighbours will think the fleas are cured. Seriously, I've been thinking about that all week and you've just answered it. Thanks!!!

Brittany Kennedy from Kailua-Kona, Hawaii on November 14, 2011:

I just posted a forum about this! Thank you for posting; it really is an evergreen hub!

Rosie Rose from Toronto, Canada on October 04, 2011:

Wow! I always wanted to do this but didn't know how. Thank you so much, Darkside!

Have a nice day,


Sharilee Swaity from Canada on August 31, 2011:

Thank you so very much! I just found this from someone mentioning in the forums and it is excellent information! I just added a table of contents to one of my hubs and it is so much better! I think it might help with sales, too. Thank you again!

Shelly on August 19, 2011:

Unbelievably useful. I mean, just EXACTLY what I was seeking! Thanks so much for taking the time to put this up. I write a few rather long hubs and even *I* get weary of scrolling through them.

Ugh. Can't emphasize just how useful this is!

Sophie on July 15, 2011:

This is so useful. I have struggled with internal linking for so long, I am book marking this for future reference.

Bruce Chamoff from New York on June 20, 2011:

This works perfectly, Darkside, and I have linked to this hub for my followers to read. I am also following you now.

Bruce Chamoff from New York on June 20, 2011:

Darkside, this works perfectly. Thanks. I have linked to this from my hubs and am now following you.

Liz Elias from Oakley, CA on April 22, 2011:

Oh, wow! I was referred to this hub by lronher, after a suggestion I made in the forums.

Super cool! Bookmarked & voted up & useful! Thanks for this info! It will be a bit tricky for me, as I'm not a techie-type, but you've explained it clearly and with examples, so I should be able to manage!

Thank you!

Sue B. on April 03, 2011:

Thank you! I found this very helpful! For some reason internet explorer would not show me the source information on hubpages yet I could review the source on other pages. Googlechrome worked so if that happens to anyone else- just try another browser.

saintodd from Suffolk, VA on February 24, 2011:

BANG! I've been doing the table of contents without linking it on my hubs up to this point, its just how I like to organize my articles. Thanks for the tutorial - I'll be using it now until that capsule is made. Thanks. Voted up and ranked!

Howard S. from Dallas, Texas, and Asia on February 20, 2011:

Oh, yes! I knew this should be possible, and there is a series of hubs I want to do that is hopeless without it. I finally saw it in someone else's hub and she pointed me here. Thanks!

Krys W from Abertawe, Cymru on December 06, 2010:

Oh thank you, thank you!!! This is exactly what I needed in a hub I finished today.

dannylardon164 on November 06, 2010:

Thanks a lot, DarkSide. I have an immensely long Hub on astrobiology that needed a navigation section.

WoodsmensPost from Arizona on October 12, 2010:

How cool is that. I just tried it on one of my hubs fantastic!!!! Bookmarked Voted Up Awesome!!!

dubturbo on July 30, 2010:

Thanks Darkside for the informative method. I will try it on my first hub as I just became a hubber. Too bad HupPages does not offer a capsule to do this automatically.

Glen (author) from Australia on July 29, 2010:

Glad to be of service Josh. But no donations required.

Josh2008 from London on July 28, 2010:

Thank you for this one DarkSide.

Not remotely surprised that this one's come from you.

Love the HubScore post as well.

Got a donate button somewhere?

Bhagwad Jal Park from Chennai, India on July 21, 2010:

Just used this for my own hub - thanks a whole lot

Bhagwad Jal Park from Chennai, India on July 21, 2010:

I just wish they had a capsule for this! Squidoo does it automatically for you and I miss that functionality!

ss sneh from the Incredible India! on June 01, 2010:

Hi! Very useful info. In fact I made a table of content on one of my site with texts but would have made with links had I read this hub before...Now I can --Thanks for the Info!

FindYourSearch from Las Vegas, NV on May 27, 2010:

Great information; exactly what I was looking for. I put a table of contents on my intro to SEO hub. Thank you!

Glen (author) from Australia on April 02, 2010:

It depends on how much information and how well you need it organised.

I've used it on hubs that have me coming back to quickly find the right spot to share with others, that way I can also do a Copy Location and post the URL into a forum post. If it makes it easier for me to navigate through the hub, then it'll be easier for others. But I wouldn't use it on every single hub I've made, in fact I've probably only got it on half a dozen.

N. Ramius on April 02, 2010:

When do you think you should use the Table of Contents? How long of a hub?

Eileen Hughes from Northam Western Australia on February 20, 2010:

Darkside, thanks for the confidence from one grandma to another. I will have to try it now wont I

Tony Casey from Manchester U.K. on February 18, 2010:

Just found this, done it, love it, works great.

Explained really well, how can I repay you;

If you need to know how to run a guest house i'm your man.


sunforged from on February 18, 2010:

The Firebug add-on for firefox would allow you to simply point the cursor at whatever page elements you would like to inspect, its worth a view if you haven't seen it before.

DevinG from Redlands on February 06, 2010:

I would like to thank you very much for this hub. It has helped me immensely with my Mousehunt guide hubs. Again, thanks a lot and this is great to know. *thumbs upped*

Sufidreamer from Sparti, Greece on January 25, 2010:

Top notch, Darkside - worked a treat :)

Appletreedeals from Salisbury, Maryland USA on January 14, 2010:

oops. forgot the ps.

ps. bookmarked it for a backlink


Appletreedeals from Salisbury, Maryland USA on January 14, 2010:

OK, people fuss that short "great hub" comments aren't really contributory, but ... anything else, here, would just be filler, thanks for the info, and effort, of course I will use this. I will shamelessly pick anybody's brain, and I never leave a good idea un-copied. Rated hub "up"


Oliver Whitham from Austin, Texas (From York, England!) on January 11, 2010:

Great hub, I was tearing my hair out trying to figure out how to make these links for my Hub!

Glen (author) from Australia on January 10, 2010:

It takes a little fiddling Lou, but once you're done, you're done!

lou16 on January 10, 2010:

Oh wow, thank you Glen. Now I can go back to a couple of my hubs and make a few changes and I can also make a few hubs that I thought might be too long - awesome!

mel22 from , on December 14, 2009:

Wow, this is one of the mosat valuable and well written hubs I have seen yet! Wish we were able to rank the hubs on a score of 1-100. I'd give this one 110!

MistHaven on October 17, 2009:

Thanks, man. Now I finally know how to add a table of contents to my Hubs.

Tim Blackstone on September 10, 2009:

This is a great explanation of how to do it and really useful thanks.

guidebaba from India on August 19, 2009:

Fantastic. You solved my problem. Thumbs Up for you.

Simon from NJ, USA on August 17, 2009:

Yes this is exactly what I wanted! Thanks

Glen (author) from Australia on August 02, 2009:

The # seperates the URL from the module number. It is the anchor. It's telling it to go down to the module number that's in the source code.

sandra rinck on August 01, 2009:

I just wanted to say one thing because I can be a dingy sometimes...most of the time.

On the part where you put a #. Can you clarify? I spent like 20 minutes putting a number 1 in instead of a #. LOL. :D

But super, it works!

sandra rinck on August 01, 2009:

Thanks for seemingly having a hub for just about everything I need to know. You are aw....sssss.....oooommmmeeee! :D

Lily Rose from A Coast on July 30, 2009:

This is so cool - I would never had known how to do this without your hub. I followed your step by step instructions and just implemented a TOC on one of my longer hubs without a glitch. I'm a huge fan of yours right now - thanks!

Jerilee Wei from United States on June 09, 2009:

Glad I read this! This kind of article is the type I crave as it is very difficult when you are my age (60) to keep up with all of this without a guideline.

blondepoet from australia on June 09, 2009:

Thankyou so so much I never saw your reply for ages as they are going the opposite way up ROFL

Om Prakash Singh from India, Calcutta on June 03, 2009:

Oh that is a great help. I didn't know that each capsule is already given an id (e.g. mod_487697). All this while I was thinking how to make Hubpages do that. Good little research. Thanks man!

traceye from Australia on May 31, 2009:

wow great hub. Darkside I've just become a massive fan of you. Keep up the good work.


Glen (author) from Australia on May 30, 2009:

Blondepoet, that one is easier than what's required to make a Table of Contents. Just go to their profile page and copy the URL in the web address field of your browser, come back and highlight the Hubbers name in your Text Capsule and click on the chain icon in your editor. Or if it's a Links Capsule you just do it as you'd do any other links.

blondepoet from australia on May 30, 2009:

Maybe you can help me, how do I change the name of a hubber that I have mentioned in my Hub so that when the reader clicks on their name there profile page will open?

blondepoet from australia on May 30, 2009:

darkside maybe you can help me. In my Hub I mention quite a few Hubbers. How can I put their name in, well their name is already in for eg.

Tom Rubenoff

(paragraph about him) so that when you click on his name his profile page will come up, I see this getting done all the time

Susan Ng Yu on May 30, 2009:

Yes, I did it! :D Thanks, darkside. :)

Luna Fae from UK on May 05, 2009:

I've used this hub for reference so many times and I've never said thanks. So a belated thank you for such a useful hub :)

BristolBoy from Bristol on April 09, 2009:

This is a really useful hub. Thanks for writing it!

multimastery on February 13, 2009:

This is wayyy cool gotta try it ~ Thanks!

multimastery on October 31, 2008:

Hey darkside thanks for enlightening us...definitely gotta try it one of these days!

aidenofthetower on October 30, 2008:

It certainly sounds like a lot of work, but considering the advantage on a longer hub (which I tend to write) it is probably worth it! Thanks

Carolyn Augustine from Iowa on October 29, 2008:

Brilliant, Darkside. Thank you!

anime_nanet from Portugal on September 20, 2008:

Fantastic hub! I have at least one long hub where I will implement this!

Thanks to Shibashake as well. If I hadn't read is hub of the Do and Dont's maybe I never found this one!

sri krsna from Philippines on May 17, 2008:

Thanks for the graet info I will try do this one..,.

RUTHIE17 on April 26, 2008:

Darkside--Just found this Hub----thank you sooooo much!  I use HTML quite a bit on Squidoo and a few other sites and really miss it here at HubPages.  Wish they would include a simple HTML option for those who want it.  Maybe someday!!

Again, thanks!!

Eileen--trust me, if this Grandma can do it so can you. It's not that hard if you just take your time and be sure to do EVERY step as written. I knew NO HTML 3 months ago and was even scared of the letters,(lol) but I'm doing all sorts of things now! It's sort of like a giant puzzle you have to put together in the right order! You can do it, gal!

Eileen Hughes from Northam Western Australia on April 13, 2008:

Thanks darkside, I like it, but may be too much for this old biddie but will have to have a go just the same. Having fun in here. And like they say never to old to learn new tricks.

MyGenie on April 13, 2008:

I love the step-by-step with graphics, best way to learn.


Related Articles