# Reader Mode

**URL:** https://meta.discourse.org/t/reader-mode/307916
**Category:** Theme component
**Tags:** official, desktop, reader-mode
**Created:** [May 14, 2024, 3:26pm UTC](https://meta.discourse.org/t/reader-mode/307916 "2024-05-14T15:26:23Z")
**Posts on this page:** 13
**Page:** 1

<div class="post-metadata">

### Author: ![Discourse](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/discourse/32/148734_2.png) [@Discourse](https://meta.discourse.org/u/Discourse)
#### Post date: [May 14, 2024, 3:26pm UTC](https://meta.discourse.org/t/reader-mode/307916/1 "2024-05-14T15:26:23Z")

</div>

| | | |
| --- | --- | --- |
| :discourse2: | **Summary** | **Reader Mode** enables a focused reader experience within Discourse topics |
| 👓 | **Preview** | [Preview on Discourse Theme Creator](https://discourse.theme-creator.io/theme/Discourse/reader-mode) |
| 🛠 | **Repository** | [https://github.com/discourse/reader-mode](https://github.com/discourse/reader-mode) |
| 📖 | **New to Discourse Themes?** | [Beginner’s guide to using Discourse Themes](https://meta.discourse.org/t/beginners-guide-to-using-discourse-themes/91966) |

Install this theme component

> [@](#):
>
> :discourse2: As this is an #official theme component maintained by the Discourse team, #Support, #Contribute > Bug, #Contribute > UX, and #Contribute > Feature requests can be made in the respective categories here on Meta, and tagged with the appropriate theme component tag. Click on a link below to get one started. 👍
> 
> [❓&nbsp; **Support**](https://meta.discourse.org/new-topic?category_id=6&tags=reader-mode "Ask for support on configuring and using Reader Mode") [🐛&nbsp; **Bug**](https://meta.discourse.org/new-topic?category_id=1&tags=reader-mode "A bug report means something is broken, preventing normal/typical use of the theme component") [👀&nbsp; **UX**](https://meta.discourse.org/new-topic?category_id=9&tags=reader-mode "Discussion about the user interface of Reader Mode, and how features are presented (including language and UI elements)") [💡&nbsp; **Feature**](https://meta.discourse.org/new-topic?category_id=2&tags=reader-mode "Discussion about how existing Reader Mode features can be improved or enhanced, and how proposed new features could work")

### Features

This theme component adds a “reader mode” button to the topic timeline. “Reader mode” places the emphasis on the written word and lets the other UI elements fade into the background for a more focused reading experience. Users also have the option to choose from various fonts, adjust text size and reading width, and change to their preferred background colour

 ![reader mode](https://global.discourse-cdn.com/meta/original/4X/b/f/b/bfb845d20738efc08036fc5e5faa2a7fdfd0bb0c.jpeg)

### Settings

| Name | Descriptions |
| --- | --- |
| svg icons | |

  

> :discourse2: **Hosted by us?** Theme components are available to use on our Standard, Business, and Enterprise plans.

> Last edited by @JammyDodger 2024-06-13T23:03:38Z
> 
> > **Check document**
> >
> > Perform check on document:

---

<div class="post-metadata">

### Author: ![Jagster](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jagster/32/192154_2.png) [@Jagster](https://meta.discourse.org/u/Jagster)
#### Post date: [May 14, 2024, 4:32pm UTC](https://meta.discourse.org/t/reader-mode/307916/2 "2024-05-14T16:32:33Z")

</div>

I really love option to change font size 🥰

Bummer that component is not for mobiles.

---

<div class="post-metadata">

### Author: ![Tris20](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/tris20/32/264639_2.png) [@Tris20](https://meta.discourse.org/u/Tris20)
#### Post date: [May 31, 2024, 11:01am UTC](https://meta.discourse.org/t/reader-mode/307916/4 "2024-05-31T11:01:38Z")

</div>

Happy to see this officially released 🙂 🎉

Is it possible to match the fonts in reader mode to the font-list of the platform? For example, we’re using Open Sans, but that’s not an option on the font dropdown for Reader Mode. Would be a nice touch to have the same list of fonts to choose from. 🙂

* * *

Edit: I’m also noticing that topics which use [Discourse TOC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143), but do not have a reply are not showing the Reader Mode Icon.

You can see an example here:

> [@Understanding Discourse release channels](https://meta.discourse.org/t/why-does-discourse-always-install-beta-versions-by-default/264400):
>
> bookmark This guide explains the different types of Discourse releases and how different channels are used for updates. person_raising_hand Required user level: All users Release channels Discourse has four primary release channels, each serving a different purpose: main, latest, release, and esr. The default channel used when installing a production version of Discourse is latest. Since November 2025, Discourse uses a date-based versioning scheme: YYYY.MM.PATCH (e.g., v2026.2.0). On …

However as soon as there is at least one reply, the Timeline, ToC and Reader Mode seem to appear as expected.

---

<div class="post-metadata">

### Author: ![putty](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/putty/32/370902_2.png) [@putty](https://meta.discourse.org/u/putty)
#### Post date: [June 5, 2024, 8:21pm UTC](https://meta.discourse.org/t/reader-mode/307916/5 "2024-06-05T20:21:47Z")

</div>

Am I crazy? I don’t see the icon that is included in the topics’s screenshot:

 ![CleanShot 2024-06-05 at 16.20.46](https://global.discourse-cdn.com/meta/original/4X/2/0/8/208f987665fdae583c2f07845509ae41ce48800c.jpeg)

---

<div class="post-metadata">

### Author: ![Moin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/moin/32/554653_2.png) [@Moin](https://meta.discourse.org/u/Moin)
#### Post date: [June 5, 2024, 8:25pm UTC](https://meta.discourse.org/t/reader-mode/307916/6 "2024-06-05T20:25:04Z")

</div>

> [@putty](#):
>
> Am I crazy

Probably not!

Just try a different theme (I would recommend default, meta branded or air)

---

<div class="post-metadata">

### Author: ![putty](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/putty/32/370902_2.png) [@putty](https://meta.discourse.org/u/putty)
#### Post date: [June 5, 2024, 8:26pm UTC](https://meta.discourse.org/t/reader-mode/307916/7 "2024-06-05T20:26:52Z")

</div>

Ah, yep, that solved it. Thank you 🙂

---

<div class="post-metadata">

### Author: ![JammyDodger](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jammydodger/32/254611_2.png) [@JammyDodger](https://meta.discourse.org/u/JammyDodger)
#### Post date: [June 5, 2024, 8:34pm UTC](https://meta.discourse.org/t/reader-mode/307916/8 "2024-06-05T20:34:44Z")

</div>

I’ve added it to all the themes now. 👍 Not sure if it was missed off some on purpose but I’ll wait for the complaints to roll in to find out. 🙂

---

<div class="post-metadata">

### Author: ![Arnold](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/arnold/32/389492_2.png) [@Arnold](https://meta.discourse.org/u/Arnold)
#### Post date: [June 26, 2024, 11:09pm UTC](https://meta.discourse.org/t/reader-mode/307916/11 "2024-06-26T23:09:03Z")

</div>

Could you add the function for guests too? Currently it’s only for registered and logged in Users.

An implementetion for mobile also would be great.

Thanks for this great component 🙂

---

<div class="post-metadata">

### Author: ![hoangphuctran93](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/hoangphuctran93/32/290976_2.png) [@hoangphuctran93](https://meta.discourse.org/u/hoangphuctran93)
#### Post date: [October 13, 2024, 6:44pm UTC](https://meta.discourse.org/t/reader-mode/307916/13 "2024-10-13T18:44:45Z")

</div>

Yes, I also hope that in the next updates this theme component will support user options on the phone.

---

<div class="post-metadata">

### Author: ![StefanoCecere](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/stefanocecere/32/158064_2.png) [@StefanoCecere](https://meta.discourse.org/u/StefanoCecere)
#### Post date: [January 28, 2025, 5:51am UTC](https://meta.discourse.org/t/reader-mode/307916/14 "2025-01-28T05:51:24Z")

</div>

Reader Mode conflics with Disco TOC

it seems we can’t have both the Table of Content (by [DiscoTOC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143), mandatory for big documents) and Reader Mode (also mandatory for big documents)

---

<div class="post-metadata">

### Author: ![Rhod](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/rhod/32/507923_2.png) [@Rhod](https://meta.discourse.org/u/Rhod)
#### Post date: [June 23, 2025, 11:32pm UTC](https://meta.discourse.org/t/reader-mode/307916/15 "2025-06-23T23:32:43Z")

</div>

Is it possible to translate this text?  
 ![Screenshot - 23_06_2025 , 09_26_26 a. m.](https://global.discourse-cdn.com/meta/original/4X/7/1/c/71cff09f5ea6a341dee0fdcfd4040c160e571e1b.png)

---

<div class="post-metadata">

### Author: ![Moin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/moin/32/554653_2.png) [@Moin](https://meta.discourse.org/u/Moin)
#### Post date: [April 14, 2026, 7:50pm UTC](https://meta.discourse.org/t/reader-mode/307916/16 "2026-04-14T19:50:48Z")

</div>

I suggested a change to make it translatable:

[https://github.com/discourse/reader-mode/pull/50](https://github.com/discourse/reader-mode/pull/50)

Edit: Merged 🎉 So once you update the component, you should be able to translate the button on its configuration page.

---

<div class="post-metadata">

### Author: ![Rhod](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/rhod/32/507923_2.png) [@Rhod](https://meta.discourse.org/u/Rhod)
#### Post date: [April 19, 2026, 2:56pm UTC](https://meta.discourse.org/t/reader-mode/307916/17 "2026-04-19T14:56:00Z")

</div>

![image](https://global.discourse-cdn.com/meta/original/4X/b/b/6/bb6876f9cb8e971bfb3139848d1d60285ad12308.png)

Perfect!!!  
Thank you so much!!!
