# Discourse Doc Categories links not rendering

**URL:** https://meta.discourse.org/t/discourse-doc-categories-links-not-rendering/348135
**Category:** Bug
**Tags:** doc-categories
**Created:** [January 21, 2025, 7:30am UTC](https://meta.discourse.org/t/discourse-doc-categories-links-not-rendering/348135 "2025-01-21T07:30:23Z")
**Posts on this page:** 9
**Page:** 1

<div class="post-metadata">

### Author: ![MachineScholar](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/machinescholar/32/424719_2.png) [@MachineScholar](https://meta.discourse.org/u/MachineScholar)
#### Post date: [January 21, 2025, 7:30am UTC](https://meta.discourse.org/t/discourse-doc-categories-links-not-rendering/348135/1 "2025-01-21T07:30:23Z")

</div>

For some reason at some point the topics which I have copy/pasted into the index topic have stopped rendering. Seemingly randomly because nothing else has been changed and there is nothing in the error logs.

 ![Screenshot 2025-01-21 at 08.21.50](https://global.discourse-cdn.com/meta/original/4X/d/9/6/d9687f72be4cd859be39ad863f2303a27e85b15f.png)

---

<div class="post-metadata">

### Author: ![MarcP](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/marcp/32/160184_2.png) [@MarcP](https://meta.discourse.org/u/MarcP)
#### Post date: [January 21, 2025, 6:27pm UTC](https://meta.discourse.org/t/discourse-doc-categories-links-not-rendering/348135/2 "2025-01-21T18:27:48Z")

</div>

This is not the right format.

It’s:

# Header

- Title: https://..

---

<div class="post-metadata">

### Author: ![MachineScholar](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/machinescholar/32/424719_2.png) [@MachineScholar](https://meta.discourse.org/u/MachineScholar)
#### Post date: [January 21, 2025, 7:16pm UTC](https://meta.discourse.org/t/discourse-doc-categories-links-not-rendering/348135/3 "2025-01-21T19:16:36Z")

</div>

That’s what I thought too, but this is acceptable formatting according to the documentation:

> [@Discourse Doc Categories](https://meta.discourse.org/t/discourse-doc-categories/322376/1):
>
> Here’s an example of an index topic to get you started:
> 
> ```plaintext
> You can start with an optional brief description of the category.
> 
> ## First section
> * https://discourse.example.com/t/topic-title/12
> * https://discourse.example.com/t/another-topic-title/34
> * Short title: https://discourse.example.com/t/topic-with-a-long-title/56
> * Another title: https://discourse.example.com/t/another-topic-with-a-long-title/78
> 
> ## Second section
> * Topic title: https://discourse.example.com/t/documentation-topic/98
> * https://discourse.example.com/t/new-topic/76
> 
> ```

---

<div class="post-metadata">

### Author: ![MarcP](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/marcp/32/160184_2.png) [@MarcP](https://meta.discourse.org/u/MarcP)
#### Post date: [January 21, 2025, 7:50pm UTC](https://meta.discourse.org/t/discourse-doc-categories-links-not-rendering/348135/4 "2025-01-21T19:50:59Z")

</div>

I didn’t know that, I used `title: link `since the start and thought it was the only way, sorry about that!

---

<div class="post-metadata">

### Author: ![sam](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/sam/32/102149_2.png) [@sam](https://meta.discourse.org/u/sam)
#### Post date: [January 21, 2025, 11:18pm UTC](https://meta.discourse.org/t/discourse-doc-categories-links-not-rendering/348135/5 "2025-01-21T23:18:52Z")

</div>

@hugh / @saquetim any ideas here?

---

<div class="post-metadata">

### Author: ![MachineScholar](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/machinescholar/32/424719_2.png) [@MachineScholar](https://meta.discourse.org/u/MachineScholar)
#### Post date: [January 29, 2025, 12:33pm UTC](https://meta.discourse.org/t/discourse-doc-categories-links-not-rendering/348135/6 "2025-01-29T12:33:57Z")

</div>

Just updating that the issue is persisting. Fully updated and have rebuilt the app.

---

<div class="post-metadata">

### Author: ![david](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/david/32/157490_2.png) [@david](https://meta.discourse.org/u/david)
#### Post date: [January 29, 2025, 2:13pm UTC](https://meta.discourse.org/t/discourse-doc-categories-links-not-rendering/348135/7 "2025-01-29T14:13:47Z")

</div>

How many links do you have in this index topic?

I think if you don’t specify the title manually, then it relies on the “inline onebox” feature of Discourse to fetch the title. In your screenshot, that doesn’t seem to have happened.

So I’d suggest either adding the title manually with the `title: link` syntax, or increasing the “Max oneboxes per post” site setting (defaults to 50).

---

<div class="post-metadata">

### Author: ![MachineScholar](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/machinescholar/32/424719_2.png) [@MachineScholar](https://meta.discourse.org/u/MachineScholar)
#### Post date: [January 29, 2025, 2:29pm UTC](https://meta.discourse.org/t/discourse-doc-categories-links-not-rendering/348135/8 "2025-01-29T14:29:13Z")

</div>

> [@david](#):
>
> increasing the “Max oneboxes per post”

Omg that did the trick. I never would’ve connected those dots lol. Thanks!

---

<div class="post-metadata">

### Author: ![david](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/david/32/157490_2.png) [@david](https://meta.discourse.org/u/david)
#### Post date: [January 29, 2025, 2:30pm UTC](https://meta.discourse.org/t/discourse-doc-categories-links-not-rendering/348135/9 "2025-01-29T14:30:03Z")

</div>


