• Home
  • Random
  • Nearby
  • Log in
  • Settings
Donate Now If Wikipedia is useful to you, please give today.
  • About Wikipedia
  • Disclaimers
Beta Wikipedia

Template:TOC limit

  • Template
  • Discussion
  • Language
  • Watch
  • Edit

Contents

  • 1 Usage
  • 2 TOC levels versus wikitext header levels
  • 3 Conflicts
Template documentation[view] [edit] [history] [purge]

This template inserts a Table of Contents which omits subheadings beyond a certain depth. The table obeys the same layout rules as the __TOC__ magic word. Omitted sections still have section edit links in the article body; the main use for this template is situations where you want section edit links for ease of editing but don't want to clutter the table of contents.

Usage

edit

{{TOC limit}}

The template defaults to including only the first- and second-level headings, i.e. those numbered "1" and "1.1" in the TOC.

You can specify a different limit by adding a header level:

{{TOC limit|4}}

4 allows for third-level headings, i.e. "1.1.1", but omits any subheadings below that from the TOC.

The template works by hiding the lower levels with CSS. See MediaWiki:Common.css.

A suggested alternative is {{TOChidden}}.

TOC levels versus wikitext header levels

edit

The heading levels in the TOC normally correspond to the header levels in the wikitext, so a "== Level-2 header ==" will normally generate the first-level ("1") TOC headings, a "=== Level-3 header ===" will normally generate the second-level ("1.1") TOC headings, and so on. This correspondence does not hold if the page contains "= Level-1 headers =" or skips header levels. For example, wikitext like this:

 == Level-2 heading (A) ==
 === Level-3 heading (B) ===
 == Level-2 heading (C) ==
 ====== Level-6 heading (D) ======
 = Level-1 heading (E) =
 == Level-2 heading (F) ==
 === Level-3 heading (G) ===

will generate a TOC like this:

Contents
  • 1 Level-2 heading (A)
    • 1.1 Level-3 heading (B)
  • 2 Level-2 heading (C)
    • 2.1 Level-6 heading (D)
  • 3 Level-1 heading (E)
    • 3.1 Level-2 heading (F)
      • 3.1.1 Level-3 heading (G)

Using {{TOC limit}} on this page would not hide header D, because even though it is a level-6 heading it is shown at the second level in the TOC. And it would hide header G even though it is a level-3 heading just like header B, because header G is shown at the third level in the TOC while header B is shown at the second level.

Conflicts

edit

This template does not interact well with the {{TOC right}}, {{TOC left}}, {{TOC center}} templates. To achieve the correct effect, use those with a limit parameter. For example, {{TOC right|limit=2}} has the effect that {{TOC right}} and {{TOC limit|2}} would have—if they worked together. bg:قالب:TOC limit it:Template:TOClimit ms:Templat:TOC limit

The above documentation is transcluded from Template:TOC limit/doc. (edit | history)
Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages.
Add categories to the /doc subpage. Subpages of this template.
Retrieved from "https://en.wikipedia.beta.wmflabs.org/w/index.php?title=Template:TOC_limit&oldid=653882"
Last edited on 6 June 2025, at 14:46

Languages

    • العربية
    • Español
    • Esperanto
    • Français
    • 한국어
    • 日本語
    • Simple English
    • 中文
    Beta Wikipedia
    • Wikimedia Foundation
    • Powered by MediaWiki
    • This page was last edited 14:46, 6 June 2025 by Beta Wikipedia user Dom walden. Based on work by Beta Wikipedia users CX Zoom Beta and JustBerry and Beta Wikipedia anonymous users wikipedia:en>TheDJ, imported>Mr. Stradivarius and imported>WOSlinker.
    • Content is available under CC BY-SA 4.0 unless otherwise noted.
    • Privacy policy
    • About Wikipedia
    • Disclaimers
    • Contact Wikipedia
    • Code of Conduct
    • Developers
    • Statistics
    • Cookie statement
    • Terms of use
    • Desktop