Template:Succession box/doc

This template creates a standard line for succession boxes.

Mostly deprecated, the succession box template ought to be used only for the simplest succession lines. These are single succession lines showing nothing more than a succession of three people holding exactly the same title. For succession lines sharing cells with other lines, for new or expired titles, for incumbencies or vacancies, for titular rulers or pretenders, for titles which change their name before or after the subject, and for lines requiring other additional information, the specialised templates of the {{s-start}} series should be used instead of this one.

Syntax

Basic usage:

{{S-start}}
{{Succession box
 | title  = 
 | years  = 
 | with   =
 | before = 
 | after  = 
}}
{{S-end}}

Full usage:

{{S-start}}
{{Succession box
 | title   = 
 | years   = 
 | with    =
 | with    =
 | with2   =
 | with3   =
 | with4   =
 | with5   =
 | with6   =
 | with7   =
 | with8   =
 | with9   =
 | with10  =
 | before  = 
 | before2 = 
 | before3 = 
 | before4 = 
 | before5 = 
 | after   = 
 | after2  = 
 | after3  = 
 | after4  = 
 | after5  = 
}}
{{S-end}}

Usage

A succession box may start with a single {{S-start}} and end with one {{S-end}}. Alternatively, the old versions may be used, namely {{Start box}} as the initial template and {{End box}} as the finishing one; the two formats are compatible with each other.

Within each succession box, one or more lines may be created. One {{Succession box}} is used for each line, and parameters are used to insert data into the template: "before" for the predecessor of the subject, "title" for the subject's title, "years" for the time period during which they held the title, and "after" for the name of their successor.

Parameters

Years

Mandatory; a value is required. The value may be years or full dates. A range is not required, such as if a term of office was one year.

Usage with multiple office-holders

Where a post was held by more than one person at a time, extra parameters should be used to include them.

Predecessors

• For multiple predecessors use "before", "before2", "before3", etc (max 5)

Successors

• For multiple successors use "after", "after2", "after3", etc (max 5)

Concurrent office-holders

• For concurrent office-holders use "with", "with2", "with3", etc (max 25)

Examples

Example with single office-holder

From the article Winston Churchill:

{{S-start}}
{{Succession box
| before = [[Clement Attlee]]
| title  = [[Prime Minister of the United Kingdom]]
| years  = 26 October 1951 – 7 April 1955
| after  = [[Anthony Eden|Sir Anthony Eden]]
}}
{{Succession box
| before = [[Emanuel Shinwell]]
| title  = [[Minister of Defence (UK)|Minister of Defence]]
| years  = 1951–1952
| after  = [[Harold Alexander, 1st Earl Alexander of Tunis|The Earl Alexander of Tunis]]
}}
{{S-end}}

Preceded by Clement Attlee	Prime Minister of the United Kingdom 26 October 1951 – 7 April 1955	Succeeded by Sir Anthony Eden
Preceded by Emanuel Shinwell	Minister of Defence 1951–1952	Succeeded by The Earl Alexander of Tunis

Example with multiple office-holders

From the article Richard Temple-Grenville, 2nd Duke of Buckingham and Chandos:

{{s-start}}
{{s-par|gb}}
{{succession box
 | title   = [[Member of Parliament]] for [[Buckinghamshire (UK Parliament constituency)|Buckinghamshire]]
 | with    = [[William Selby Lowndes]] 1818–1820
 | with2   = [[Robert Carrington, 2nd Baron Carrington|Robert Smith]] 1820–1831
 | with3   = [[John Smith (Wendover MP)|John Smith]] 1831–1835
 | with4   = [[Sir George Dashwood, 5th Baronet|Sir George Dashwood, Bt]] 1832–1835
 | with5   = [[Sir William Young, 4th Baronet|Sir William Young, Bt]] 1835–1839
 | with6   = [[George Simon Harcourt]] 1835–1839
 | years   = 1818–1839
 | before  = [[William Selby Lowndes]]
 | before2 = [[Thomas Grenville]]
 | after   = [[Sir William Young, 4th Baronet|Sir William Young, Bt]]
 | after2  = [[George Simon Harcourt]]
 | after3  = [[Caledon Du Pre]]
}}
{{s-end}}

Parliament of Great Britain
Preceded by William Selby Lowndes Thomas Grenville	Member of Parliament for Buckinghamshire 1818–1839 With: William Selby Lowndes 1818–1820 Robert Smith 1820–1831 John Smith 1831–1835 Sir George Dashwood, Bt 1832–1835 Sir William Young, Bt 1835–1839 George Simon Harcourt 1835–1839	Succeeded by Sir William Young, Bt George Simon Harcourt Caledon Du Pre

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Succession box in articles based on its TemplateData.

TemplateData for Succession box

This template creates a standard line for succession boxes. It is normally preceded by {{S-start}} and followed by {{S-end}}

Template parameters

Parameter		Description	Type	Status
years	years	The years the office held, value may be years or full dates, a range is not require if the post was only held for a year	String	required
title	title	Title of the office e.g. [[Prime Minister of the United Kingdom]]	String	optional
rows	rows		String	optional
before	before	First predecessor	String	optional
before2	before2	Second predecessor.	String	optional
before3	before3	Third predecessor.	String	optional
before4	before4	Forth predecessor.	String	optional
before5	before5	Fifth predecessor.	String	optional
after	after	First successors.	String	optional
after2	after2	Second successors.	String	optional
after3	after3	Third successors.	String	optional
after4	after4	Forth successors.	String	optional
after5	after5	Fifth successors.	String	optional
alongside	alongside	Used when they 'Served alongside' another person.	String	optional
with	with	Concurrent office-holders, upto 25 people	String	optional
with2	with2		String	optional
with3	with3		String	optional
with4	with4		String	optional
with5	with5		String	optional
with6	with6		String	optional
with7	with7		String	optional
with8	with8		String	optional
with9	with9		String	optional
with10	with10		String	optional
with11	with11		String	optional
with12	with12		String	optional
with13	with13		String	optional
with14	with14		String	optional
with15	with15		String	optional
with16	with16		String	optional
with17	with17		String	optional
with18	with18		String	optional
with19	with19		String	optional
with20	with20		String	optional
with21	with21		String	optional
with22	with22		String	optional
with23	with23		String	optional
with24	with24		String	optional
with25	with25		String	optional

See also

• Documentation for creating more complex succession boxes can be found at Template:S-start.
• A quick overview of the various templates and parameters of the s-start series can be found at the Cheatsheet.