Wikipedia:Manual of Style/Layout
 | Thisguidelineis a part of the English Wikipedia'sManual of Style. It is a generally accepted standard that editors should attempt to follow, thoughoccasional exceptionsmay apply. Anysubstantiveedit to this page should reflectconsensus.When in doubt, discuss first on thetalk page. |
| Manual of Style (MoS) |
|---|
This guide presents the typicallayoutof Wikipedia articles, including the sections an article usually has, ordering of sections, and formatting styles for various elements of an article. For advice on the use of wikimarkup,seeHelp:Editing;for guidance on writing style, seeManual of Style.
Order of article elements
Asimple articleshould have, at least, (a) a lead section and (b) references. The following list includes additional standardized sections in an article. A complete article need not have all, or even most, of these elements.
- Before the article content
- Short description[1]
- {{DISPLAYTITLE}},{{Lowercase title}},{{Italic title}}[2](some of these may also be placed before the infobox[3]or after the infobox[4])
- Hatnotes
- {{Featured list}},{{Featured article}}and{{Good article}}(where appropriate for article status)
- Deletion / protection tags (CSD,PROD,AFD,PPnotices)
- Maintenance,cleanup,anddisputetags
- Templates relating toEnglish varietyanddate format[5][a]
- Infoboxes[b]
- Language maintenance templates
- Images
- Navigation header templates(sidebar templates)
- Article content
- Lead section(also called the introduction)
- Table of contents
- Body(seebelowfor specialized layout)
- Appendices[6][c]
- Works or publications(for biographies only)
- See also
- Notes and references(this can be two sections in some citation systems)
- Further reading
- External links[d]
- End matter
- Succession boxesand geography boxes
- Othernavigation footer templates(navboxes)[7]
- {{Portal bar}}[e](or{{Subject bar}})
- {{Taxonbar}}
- Authority controltemplates
- Geographical coordinates(if not in the infobox) or{{coord missing}}
- Defaultsort
- Categories[f]
- {{Improve categories}}or{{Uncategorized}}(These can alternatively be placed with other maintenance templates before the article content)
- Stub templates(followWP:STUBSPACING)
Body sections
Articles longer than astubare generally divided into sections, and sections over a certain length are generally divided into paragraphs: these divisions enhance the readability of the article. Recommended names and orders of section headings mayvary by subject matter,although articles should still follow good organizational and writing principles regarding sections and paragraphs.
Headings and sections
Headings introduce sections and subsections, clarify articles by breaking up text, organize content, and populate thetable of contents.Very short sections and subsections clutter an article with headings and inhibit the flow of the prose. Short paragraphs and single sentences generally do not warrant their own subheadings.
Headings follow a six-level hierarchy, starting at 1 and ending at 6. The level of the heading is defined by the number of equals signs on each side of the title. Heading 1 (= Heading 1 =) is automatically generated as the title of the article, and is never appropriate within the body of an article. Sections start at the second level (== Heading 2 ==), with subsections at the third level (=== Heading 3 ===), and additional levels of subsections at the fourth level (==== Heading 4 ====), fifth level, and sixth level. Sections should be consecutive, such that they do not skip levels from sections to sub-subsections; the exact methodology is part of theAccessibilityguideline.[g]Between sections, there should be asingleblank line: multiple blank lines in the edit window create too much white space in the article. There is no need to include a blank line between a heading and sub-heading. When changing or removing a heading, consider adding ananchor templatewith the original heading name to provide forincoming external linksandwikilinks(preferably using{{subst:anchor}}rather than using{{anchor}}directly—seeMOS:RENAMESECTION).
Section order
Because of the diversity of subjects it covers, Wikipedia has no general standard or guideline regarding the order of section headings within the body of an article. The usual practice is to order body sections based on the precedent of similar articles. For exceptions, seeSpecialized layoutbelow.
Section templates and summary style
When a section is asummaryof another article that provides a full exposition of the section, a link to the other article should appear immediately under the section heading. You can use the{{Main}}template to generate a "Main article" link, in Wikipedia's"hatnote"style.
If one or more articles provide further information or additional details (rather than a full exposition, see above), links to such articles may be placed immediately after the section heading for that section, provided this does not duplicate a wikilink in the text. These additional links should be grouped along with the{{Main}}template (if there is one), or at the foot of the section that introduces the material for which these templates provide additional information. You can use one of the following templates to generate these links:
For example, to generate a "See also" link to the article onWikipedia:How to edit a page,type{{See also|Wikipedia:How to edit a page}},which will generate:
Paragraphs
Sections usually consist of paragraphs of running prose, each dealing with a particular point or idea. Between paragraphs—as between sections—there should be only asingleblank line. First lines arenotindented.
Bullet pointsshould not be used in the lead of an article, and should be used in the body only to break up a mass of text, particularly if the topic requires significant effort to comprehend. However, bulleted lists are typical in the reference, further reading, and external links sections towards the end of the article. Bullet points are usually not separated by blank lines, as that causes an accessibility issue (seeMOS:LISTGAPfor ways to create multiple paragraphs within list items that do not cause this issue).
The number of single-sentence paragraphs should be minimized, since they can inhibit the flow of the text; by the same token, paragraphs that exceed a certain length become hard to read. Short paragraphs and single sentences generally do not warrant their own subheadings; in such circumstances, it may be preferable to use bullet points instead.
Standard appendices and footers
Headings
When appendix sections are used, they should appear at the bottom of an article, with==level 2 headings==,[h]followed by the various footers. When it is useful to sub-divide these sections (for example, to separate a list of magazine articles from a list of books), this should be done using level 3 headings (===Books===) instead ofdefinition list headings(;Books), as explained in theaccessibility guidelines.
Works or publications
Contents:A bulleted list, usually ordered chronologically, of the works created by the subject of the article.
Heading names:Many different headings are used, depending on the subject matter. "Works" is preferred when the list includes items that are not written publications (e.g. music, films, paintings, choreography, or architectural designs), or if multiple types of works are included. "Publications", "Discography" or "Filmography" are occasionally used where appropriate; however, "Bibliography" is discouraged because it is not clear whether it is limited to the works of the subject of the article.[8][i]"Works" or "Publications" should be plural, even if it lists only a single item.[j]
"See also" section
A "See also" section is a useful way to organizeinternal linksto related or comparable articles andbuild the web.However, the section itself is not required; many high-quality and comprehensive articles do not have one.
The section should be a bulleted list, sorted either logically (for example, by subject matter), chronologically, or Alpha betically. Consider using{{Columns-list}}or{{Div col}}if the list is lengthy.
Contents:Links in this section should be relevant and limited to a reasonable number. Whether a link belongs in the "See also" section is ultimately a matter of editorial judgment andcommon sense.One purpose of "See also" links is to enable readers to explore tangentially related topics; however, articles linked should be related to the topic of the article or be in the same defining category. For example, the article onJesusmight include a link toList of people claimed to be Jesusbecause it is related to the subject but not otherwise linked in the article. The article onTacosmight includeFajitaas another example of Mexican cuisine.
The "See also" section shouldnotincludered links,links todisambiguation pages(unless used in a disambiguation page forfurther disambiguation), orexternal links(including links to pages withinWikimedia sister projects). As a general rule, the "See also" section shouldnotrepeat links that appear in the article's body.[9]
Editors should provide a brief annotation when a link's relevance is not immediately apparent, when the meaning of the term may not be generally known, or when the term is ambiguous. For example:
If the linked article has ashort descriptionthen you can use{{annotated link}}to automatically generate an annotation. For example,{{annotated link|Winston Churchill}}will produce:
- Winston Churchill– British statesman and author (1874–1965)
Other internal links:{{Portal}}links are usually placed in this section. As an alternative,{{Portal bar}}may be placed with the end matter navigation templates. See relevant template documentation for correct placement.
Heading name:The standardized name for this section is "See also".
Notes and references
Contents:This section, or series of sections, may contain any or all of the following:
- Explanatory footnotesthat give information which is too detailed or awkward to be in the body of the article
- Citation footnotes(either short citations or full citations) that connect specific material in the article with specific sources
- Full citations to sources, ifshort citationsare used in the footnotes
- General references(full bibliographic citations to sources that were consulted in writing the article but that are not explicitly connected to any specific material in the article)
Editors may use any citation method they choose,but it should be consistent within an article.
If there are both citation footnotes and explanatory footnotes, then they may be combined in a single section, or separated using thegrouped footnotesfunction. General references and other full citations may similarly be either combined or separated (e.g. "References" and "General references" ). There may therefore be one, two, three or four sections in all.
It is most common for only citation footnotes to be used, and therefore it is most common for only one section ( "References" ) to be needed. Usually, if the sections are separated, then explanatory footnotes are listed first, short citations or other footnoted citations are next, and any full citations or general references are listed last.
Heading names:Editors may use any reasonable section and subsection names that they choose.[k]The most frequent choice is "References". Other options, in diminishing order of popularity, are "Notes", "Footnotes" or "Works cited", although these are more often used to distinguish between multiple end-matter sections or subsections.
Several alternate titles ( "Sources", "Citations", "Bibliography" ) may also be used, although each is questionable in some contexts: "Sources" may be confused withsource codein computer-related articles, product purchase locations, river origins,journalism sourcing,etc.; "Citations" may be confused with official awards, or a summons to court; "Bibliography" may be confused with the complete list of printed works by the subject of a biography ( "Works" or "Publications" ).
If multiple sections are wanted, then some possibilities include:
- For a list of explanatory footnotes or shortened citation footnotes: "Notes", "Endnotes" or "Footnotes"
- For a list of full citations or general references: "References" or "Works cited"
With the exception of "Bibliography", the heading should be plural even if it lists only a single item.[j]
Further reading
Contents:An optional bulleted list, usually Alpha betized, of a reasonable number of publications that would help interested readers learn more about the article subject. Editors may include brief annotations. Publications listed infurther readingare formatted in the samecitation styleused by the rest of the article. The Further reading section should not duplicate the content of the External links section, and should normally not duplicate the content of the References section, unless the References section is too long for a reader to use as part of a general reading list. This section is not intended as a repository forgeneral referencesor full citations that were used to create the article content. Any links to external websites included under "Further reading" are subject to the guidelines described atWikipedia:External links.
External links
Contents:A bulleted list of recommendedrelevant websites,each accompanied by a short description. These hyperlinks should not appear in the article's body text, nor should links used as references normally be duplicated in this section. "External links" should be plural, even if it lists only a single item.[j]Depending on the nature of the link contents, this section may be accompanied or replaced by a"Further reading"section.
Links to sister projects
Links toWikimedia sister projectsand{{Spoken Wikipedia}}should generally appear in "External links", not under "See also". If the article has no "External links" section, then place the sister link(s) in a new "External links" section using inline templates. If there is more than one sister link, a combination of box-type and "inline" templates can be used, as long as the section containsat least one"inline" template.
- Box-type templates (such as
{{Commons category}},shown at right) have to be put at the beginning of the "External links" section of the article so that boxes will appear next to, rather than below, the list items. (Donotmake a section whose sole content is box-type templates.) - "Inline" templates are used when box-type templates are not good, either because they result in a long sequence of right-aligned boxes hanging off the bottom of the article, or because there are no external links except sister project ones. "Inline" templates, such as
{{Commons category-inline}},create links to sister projects that appear as list items, like this:
Media related toWikimedia Foundationat Wikimedia Commons
If an external link is added and/or exists in the "External links" section, the "inline" templates linking to sister projects can be replaced with their respective box-type templates.
Navigation templates
An article may end withNavigation templatesand footer navboxes, such assuccession boxesand geography boxes (for example,{{Geographic location}}). Most navboxes do not appear in printed versions of Wikipedia articles.[l]
Specialized layout
Stand-alone listsandtalk pageshave their own layout designs.
Certain topics have Manual of Style pages that provide layout advice, including:
- Chemistry
- Film
- Medicine,for articles on treatments, procedures, medical products, fields of medicine, and other concepts
- Television
- Video games
Some WikiProjects haveadvice pagesthat include layout recommendations. You can find those pages atCategory:WikiProject style advice.
Formatting
Images
Each image should ideally be located in the section to which it is most relevant, and most should carry an explanatorycaption.An image that would otherwise overwhelm the text space available within a1024×768 windowshould generally be formatted as described in relevant formatting guidelines (e.g.WP:IMAGESIZE,MOS:IMGSIZE,Help:Pictures § Panoramas). Try to harmonize the sizes of images on a given page in order to maintain visual coherence.
If "stacked" images in one section spill over into the next section at 1024×768 screen resolution, there may be too many images in that section. If an article overall has so many images that they lengthen the page beyond the length of the text itself, you can use agallery;or you can create a page or category combining all of them atWikimedia Commonsand use a relevant template ({{Commons}},{{Commons category}},{{Commons-inline}}or{{Commons category-inline}}) to link to it instead, so that further images are readily available when the article is expanded. SeeWikipedia:Image use policy § Image galleriesfor further information on galleries.
Use|upright=scaling factorto adjust the size of images; for example,|upright=1.3displays an image 30% larger than the default, and|upright=0.60displays it 40% smaller. Lead images should usually be no larger than|upright=1.35.
Avoid article text referring to images as being to the left, right, above or below, because image placement varies with platform (especially mobile platforms) and screen size, and is meaningless to people using screen readers; instead, use captions to identify images.
Horizontal rule
Horizontal rulesare sometimes used in some special circumstances, such as inside{{sidebar}}template derivatives, but not in regular article prose.
Collapsible content
As explained atMOS:COLLAPSE,limit the use of{{Collapse top}}/{{Collapse bottom}}and similar templates in articles. That said, they can beuseful in talk pages.
See also
- Help:Section
- Wikipedia:Talk page guidelines– shows how to use headings on talk pages
Notes
- ^These templates (seeCategory:Use English templates) can also be placed at the end of an article.
- ^It is important that hatnotes and maintenance/dispute tags appear on the first page of the article. On the mobile site, the first paragraph of the lead section is moved above the infobox for the sake of readability. Since the infobox is generally more than one page long, putting hatnotes, etc., after it will result in them being placed after the first page, making them less effective.
- ^The original rationale for the ordering of the appendices is that, with the exception of "Works", sections which contain material outside Wikipedia (including "Further reading" and "External links" ) should come after sections that contain Wikipedia material (including "See also" ) to help keep the distinction clear. The sections containing notes and references often contain both kinds of material and, consequently, appear after the "See also" section (if any) and before the "Further reading" section (if any). Whatever the merits of the original rationale, there is now the additional factor that readers have come to expect the appendices to appear in this order.
- ^There are several reasons why this section should appear as the last appendix section. So many articles have the "External links" section at the end that many people expect this to be the case. Some "External links" and "References" (or "Footnotes", etc.) sections are quite long and, when the name of the section is not visible on the screen, it could cause problems if someone meant to delete an external link but deleted a reference citation instead. Keeping the "External links" last is also helpful to editors who patrol external links.
- ^This template is primarily used whenTemplate:Portalwould cause formatting problems.
- ^While categories are entered on the editing page ahead of stub templates, they appear on the visual page in a separate box after the stub templates. One of the reasons this happens is that every stub template generates a stub category, and those stub categories appear after the "main" categories. Another is that certain bots and scripts are set up to expect the categories, stubs andinterlanguage linksto appear in that order, and will reposition them if they don't. Therefore, any manual attempt to change the order is futile unless the bots and scripts are also altered.
- ^For example, skipping heading levels, such as jumping from
== Heading 2 ==to==== Heading 4 ====without=== Heading 3 ===in the middle, violatesWikipedia:Accessibilityas it reduces usability for users of screen readers who use heading levels to navigate pages. - ^Syntax:
==See also== *[[Wikipedia:How to edit a page]] *[[Wikipedia:Manual of Style]]
Which produces:
See also - ^Find all examplesof "Bibliography" and "Selected bibliography"
- ^abcFor further information, seeWikipedia:External links § External links section.
- ^One reason this guideline does not standardize section headings for citations and explanatory notes is that Wikipedia draws editors from many disciplines (history, English, science, etc.), each with its own note and reference section-naming convention (or conventions). For more, seeWikipedia:Perennial proposals § Changes to standard appendices,§ Establish a house citation style,andTemplate:Cnote2/example.
- ^Therationalefor not printing navigation boxes is that these templates mostly consist ofwikilinksthat are of no use to print readers. There are two problems with this rationale: first, other wikilink content does print, for example"See also" sectionsandsuccession boxes;second, some navigation boxes contain useful information regarding the relationship of the article to the subjects of related articles.
References
- ^Discussed in2018and2019.
- ^Per the template documentation atTemplate:Italic title/doc § Location on page
- ^Per the RFC atWikipedia talk:Manual of Style/Layout/Archive 14 § DISPLAYTITLE
- ^Per the template documentation atTemplate:DISPLAYTITLE § Instructions
- ^The matter was discussed in2012,2014,and2015.
- ^This sequence has been in place since at leastDecember 2003(when "See also" was called "Related topics" ). See, for example,Wikipedia:Perennial proposals § Changes to standard appendices.
- ^Rationale for placing navboxes at the end of the article.
- ^Rationale for discouraging the use of "Bibliography."
- ^The community has rejected past proposals to do away with this guidance. See, for example,this RfC.
