# Linking to the index page for a section

**URL:** <https://discourse.gohugo.io/t/linking-to-the-index-page-for-a-section/10427>\
**Category:** support\
**Created:** [February 7, 2018, 10:53pm UTC](https://discourse.gohugo.io/t/linking-to-the-index-page-for-a-section/10427 "2018-02-07T22:53:39Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![jemostrom](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/jemostrom/32/3331_2.png) [@jemostrom](https://discourse.gohugo.io/u/jemostrom)\
**Post date:** [February 7, 2018, 10:53pm UTC](https://discourse.gohugo.io/t/linking-to-the-index-page-for-a-section/10427/1 "2018-02-07T22:53:39Z")

</div>

I have the following folder structure

```auto
content
  |
  +--- sectionA
  | |
  | + _index.md
  | + page1.md
  | + page2.md
  +--- sectionB
         |
         + _index.md
         + page1.md

```

On the page `sectionA/_index.md` I want to link to the page `sectionB/_index.md`. After looking in the docs I tried `{{< relref "sectionB/_index.md" >}}` which doesn’t work, I also tried `{{< relref "sectionB/" >}}` which doesn’t work either. However, `{{< relref "sectionB/page1.md" >}}` works. How should I link to the index page?

---

<div class="post-metadata">

**Author:** ![Leo\_Merkel](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/leo_merkel/32/3321_2.png) [@Leo\_Merkel](https://discourse.gohugo.io/u/Leo_Merkel)\
**Post date:** [February 7, 2018, 11:05pm UTC](https://discourse.gohugo.io/t/linking-to-the-index-page-for-a-section/10427/2 "2018-02-07T23:05:25Z")

</div>

Important to understand is the difference between `_index.md` and `index.md` with regards to page bundles. Please read the docs: [http://gohugo.io/about/new-in-032/](http://gohugo.io/about/new-in-032/)

---

<div class="post-metadata">

**Author:** ![kaushalmodi](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/kaushalmodi/32/2567_2.png) [@kaushalmodi](https://discourse.gohugo.io/u/kaushalmodi)\
**Post date:** [February 7, 2018, 11:17pm UTC](https://discourse.gohugo.io/t/linking-to-the-index-page-for-a-section/10427/3 "2018-02-07T23:17:09Z")

</div>

`ref` and `relref` shortcodes can be used to link to only regular pages. The pages created by `_index.md` are section pages or list pages, and those cannot be referenced using those shortcodes.

---

<div class="post-metadata">

**Author:** ![jemostrom](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/jemostrom/32/3331_2.png) [@jemostrom](https://discourse.gohugo.io/u/jemostrom)\
**Post date:** [February 8, 2018, 7:26am UTC](https://discourse.gohugo.io/t/linking-to-the-index-page-for-a-section/10427/4 "2018-02-08T07:26:21Z")

</div>

I’m quite confused at the moment, I’ve tried to understand how linking works with page bundles and sections but I’m missing something. In my example above `sectionA` and `sectionB` are sections, parts of the site that will contain pages about the same subject (my way of understanding page bundles are that they are one page with supporting files).

On `sectionA/page1.md` I want to refer to `sectionB` as a whole (the index page for that section) or a specific page in that section, for example `sectionB/page1.md`. Unfortunately, even after reading the pages about “ref/relref”, “new-in-032”, “shortcodes”, and “sections” I’m failing to understand how to link to `sectionB`.

What am I missing?

---

<div class="post-metadata">

**Author:** ![Joerg](https://avatars.discourse-cdn.com/v4/letter/j/49beb7/32.png) [@Joerg](https://discourse.gohugo.io/u/Joerg)\
**Post date:** [February 8, 2018, 10:04am UTC](https://discourse.gohugo.io/t/linking-to-the-index-page-for-a-section/10427/5 "2018-02-08T10:04:39Z")

</div>

I have the same question. I have in content/handbook/index.md. In the theme/name/layouts/\_defaults/list.html I have a {{ .Content }} The page is empty. What I do made wrong?

```
{{ partial "header.html" . }}

<div class="grid">
  {{ .Content }}
</div>

{{ partial "footer.html" . }}

```

content/handbook/index.md

```
---
title: "Index"
date: 2018-01-03T18:48:05+01:00
draft: false
menu:
  main:
     name: Handbook
     url: /handbook/
     weight: 2
---
```

---

<div class="post-metadata">

**Author:** ![kaushalmodi](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/kaushalmodi/32/2567_2.png) [@kaushalmodi](https://discourse.gohugo.io/u/kaushalmodi)\
**Post date:** [February 8, 2018, 10:39am UTC](https://discourse.gohugo.io/t/linking-to-the-index-page-for-a-section/10427/6 "2018-02-08T10:39:27Z")

</div>

> [@jemostrom](#):
>
> I’m failing to understand how to link to sectionB.

I’d just the plain old way: `[Section B](/sectionB)`.
