Template:Infobox election

From Wikidata
Jump to navigation Jump to search
Documentation icon Template documentation[view · edit · history · purge ]
Wikidata Stamp Rec Light.svg


Infobox to show the aggregated final results of the elections. It also shows results of binary (Yes/No) or multiple choice referendums.

Syntax[edit]

{{infobox election}}

It does not require any parameters to work. 100% of the content is fetched from Wikidata (WD).

Instructions of what properties to use and how to fill them to get the desired result can be found in the following sections.

However, in #Configuration settings you will find some settings for making configuration changes.

Operation[edit]

The infobox election runs exclusively from WD information.

It can handle the following types of elections:


  • direct election: elections by direct voting to a candidate; the one with the most votes wins.
  • indirect election: the vote of the voters is equal to the direct election, but not to select just one final elected, but a set of representatives who will choose the president / maximum representative.
  • two-round system: It is a direct vote in which, if no candidate obtains an absolute majority, a second ballot is held in which only the two most voted candidates participate, and the winner of this second ballot are the final elected.


  • party-list proportional representation: Typical voting by parliamentary chambers where a political party or coalition is voted on a list. In this case, the application of a formula on the number of votes determines the number of seats or positions obtained by the party list. This list can be open or closed. This aspect is indifferent to the infobox, as it only shows the final results, but not the elected deputies.


  • Plurality-at-large or multi-vote : These are elections where each voter can vote for more than one candidate. In this modality there are as many votes as positions to be filled, and in the case of limited voting (Q3786779), fewer are available. In the multi-vote method, the infobox only works with the information from P991, ie after the election date, to avoid long lists of candidate (P726) that will not be elected. Although voting is by candidate and not by party lists, the infotable can present information of the elects aggregated by party (when the P991 contains number of seats in legislature (P1410)), showing the seats won. Another modality is to present the list of elected people, showing the votes obtained; in this case, the ratios shown represent the support received by voters, not the distribution rate, because the sum may be greater than 100%, as it is a multi-vote model. This double modality allows to manage the item with the global results and the items with the detailed results by constituency.


  • Double Elections: These are in fact two elections held on the same election day. They are usually two-chamber elections in bicameral systems, but there are also municipal elections that elect mayor and councilors separately, with two direct votes. The infobox only handle TWO elections with one office each.


  • referendum: are votes where, unlike elections, the vote is not a support for a political option , but for or against a question-shaped text. In very exceptional cases, referendums don't have a binary answer, but a "choice" between several possible answers. To address these cases, the information structure is analogous to that described for an election, with small differences.

In the following summary we see the properties used and the structures of WD corresponding to the examples of the documentation for each type of election:

Instructions and

WD data model >>

direct election / indirect election party-list proportional representation two-round system Plurality-at-large Double Elections Referendums
Election type >> direct indirect proportional election item round 1 round 2 item eleccions election item election 1 election 2





instance of (P31)



> > > > > > > qualifiers:
Election + type + jurisdiction, etc. NO year nor edition voting round (Q24097670) Election + type + jurisdiction, etc. NO year nor edition group of elections (Q76853179) + Election + type + jurisdiction, etc. NO year nor edition Election + type + jurisdiction, etc. NO year nor edition Mandatori.

Must be  = referendum (Q43109) or one of its subclasses.

follows (P155),
as qualifier of P31
mandatory mandatory
← 1st.round
mandatory mandatory mandatory
followed by (P156),
as qualifier of P31
mandatory mandatory
2nd.round →
mandatory mandatory mandatory
image (P18) optional, (Only when qualif.
depicts (P180) = ballot (Q905151))
optional, (Only when qualif.
depicts (P180) = ballot (Q905151))
optional, (Only when qualif.
depicts (P180) = ballot (Q905151))
country (P17) mandatory
applies to jurisdiction (P1001) mandatory
point in time (P585) mandatory. If it is multi-value and does not refer to the same call, it must be accompanied by P518 indicating the meaning of that date. mandatory. 2 values + P518 linked to each round mandatory. same rules as "direct election"
start time (P580) + end time (P582) Instead to P585 when ballot was not on specifics days, but in a period; same constraints
duration (P2047) + P518 = election campaign (Q11642595) optional optional optional
office contested (P541) mandatory

single-value constraint, may be together to a vice-president position, when both are a team option.
- - -
common qualifiers: electoral district (P768), parliamentary term (P2937), of (P642),

mandatory + common qualifiers + number of seats (P1342) same rules as "direct election" same rules as "proportional election" mandatory single-value constraint same qualifiers
voting system (P8196) mandatory mandatory mandatory mandatory
candidate (P726) mandatory

common qualifiers:member of political party (P102) o represents (P1268), party chief representative (P210), votes received (P1111), running mate (P6149),

qualifs. when candidate is a political party: short name (P1813), logo image (P154), sRGB color hex triplet (P465), logo image (P154),

mandatory only "elected candidates" in round 1 optional. Only the seats won by the elected candidates are listed in the aggregate item of the election Same conditions as the correspondance type of election for this case Only when multi-response. +votes received (P1111) + sRGB color hex triplet (P465)
successful candidate (P991) mandatory

qualifs. number of seats in legislature (P1410) in case of proportional elections

mandatory, single-value constraint mandatory

qualifs. number of seats in legislature (P1410), in case of aggregated item

same qualifiers optional
eligible voters (P1867) mandatory mandatory optional mandatory mandatory
ballots cast (P1868) mandatory mandatory optional mandatory mandatory
total valid votes (P1697) mandatory mandatory optional mandatory mandatory
number of spoilt votes (P5044) mandatory mandatory optional mandatory mandatory
number of blank votes (P5045) mandatory mandatory optional mandatory mandatory
has part(s) (P527) May point to items of partial results by constituency, which are not covered by this infobox. Point to the round items with series ordinal (P1545) qualifier May point to items of partial results by constituency, which are not covered by this infobox. Point to the round items with series ordinal (P1545) qualifier May point to items of partial results by constituency, which are not covered by this infobox.
part of (P361) it may indicate that it is part of some grouping, such as "elections to the European Parliament of the year xxxx". Point to the related election items with series ordinal (P1545) qualifier it may indicate that it is part of some grouping, such as "elections to the European Parliament of the year xxxx". it may indicate a kind of grouping, but avoid to confuse with P31 Point to the related election items with series ordinal (P1545) qualifier it may indicate that it is part of some grouping, such as "Referendums from independence preparation period".
distribution map (P1846) optional, (Only when qualif.
depicts (P180) = electoral result (Q19571328))
optional, (Only when qualif.
depicts (P180) = electoral result (Q19571328))
optional, (Only when qualif.
depicts (P180) = electoral result (Q19571328))
official website (P856) optional optional optional
hashtag (P2572) optional optional optional
immediate cause of (P1536) optional optional optional
title (P1476) mandatory
number of support votes (P8683) mandatory:P8683 + optional:sRGB color hex triplet (P465), of (P642)
number of negative votes (P8682) mandatory:P8682 + optional:sRGB color hex triplet (P465), of (P642)
Data get from higher level
term length of office (P2097) from office contested (P541)
subclass of (P279) from office contested (P541) generic name of seat positions
flag image (P41) from applies to jurisdiction (P1001)
instance of (P31) from candidate (P726) to determine if the election is person-oriented or party-oriented
image (P18) from candidate (P726) o de party chief representative (P210) candidate personal image in personal oriented elections; or lead candidate in case of proportional list elections
member of political party (P102) from candidate (P726)
short name (P1813) from candidate (P726) political party acronym, in case of proportional elections
logo image (P154) from candidate (P726) political party logo, in case of proportional elections
sRGB color hex triplet (P465) from candidate (P726) used to draw result bars with this colour.

Configuration settings[edit]

Any information displayed by this infobox is fetched from WD, as it is described in exemples and documentations sections.

In addition, the infobox has some manual parameters to make changes to his appearance or operation.

  • type_election: The infobox infers the election type or obtains it from voting system (P8196). If you want to select it manually, the accepted values are: direct, proportional, two_rounds, double.
  • election_name: Text to show as a title, above of the infobox. It may be useful to put more synthetic text. By default, the article name is used.
  • id_position1: In "double elections", the letter "A" is used by default to indicate the results of the first election. This parameter allows you to indicate which character you want to use instead.
  • id_position2: Similar to above, to swap the letter "B" for another digit.
  • roundcolor_1: In double and two-round elections, it allows you to change the color that identifies the first election or first round.
  • roundcolor_2: In double and two-round elections, it allows you to change the color that identifies the second election or second round.
  • yes_color: Bar color for the "Yes" option in a referendum. By default is  #2ca02c .
  • not_color: Bar color for the "No" option in a referendum. By default is  #d62728 .
  • threshold_list: All candidates are shown before the election date. After elections only: those who have won a seat (in the case of proportional elections) or who have obtained more than 2% of the votes are shown. This parameter allows you to alter this threshold. Only the figure must be informed (as 3.5 or 1.0, etc.)
  • item: Item Qid to use, when is different from the present article

Tech documentation[edit]

See: template:Infobox election/doctech/doc for schema and functionalities of involved sub-templates.

Examples[edit]

Infobox election samples
Wikidata Stamp Rec Light.svg
Basic samples: direct, proportional, two rounds Direct election: USA president, president elected from chamber deputies, etc.
Double election: two assembly chambers, etc. Double election: more samples, etc.
Series: Part of double + only aggregate + constituency level Series: Constituency level with "direct election" + 2 aggregate level:State & country
Series: Local elections Series: Supra-state. European Parliament elections
Referendums: Two-rounds, multi-option and basic yes-no referendum
Infobox electiondirect election / indirect election
2018 Finnish presidential election (Q1658720)
Point in timeJanuary 28, 2018 Edit the value on Wikidata
Typepresidential election in Finland Edit the value on Wikidata
Office contestedPresident of Finland. Term length of office: 6 year Edit the value on Wikidata
Voter turnout
Electorate4,498,004 Edit the value on Wikidata
Q189760 noun 84860 ccReJeanSoo vote.svg3,001,325
   66.73٪
Total valid votes2,991,529    Number of blank votes  ?    Number of spoilt votes 9,042
Electoral result Edit the value on Wikidata
 ← 2012 Edit the value on WikidataFinland Edit the value on Wikidata 2024 Edit the value on Wikidata  → 
Infobox electionparty-list proportional representation
2015 Catalan regional election (Q17082048)
Point in timeSeptember 27, 2015 Edit the value on Wikidata
Typeelection to the Parliament of Catalonia and snap election Edit the value on Wikidata
Office contested135 Member of the Parliament of Catalonia ≈ 11th Parliament of Catalonia. Term length of office: 4 year Edit the value on Wikidata
Election campaign15 day Edit the value on Wikidata
Voter turnout
Electorate5,310,103 Edit the value on Wikidata
Q189760 noun 84860 ccReJeanSoo vote.svg4,130,196
   77.78٪
Percentage point 10.02
Total valid votes4,114,244    Number of blank votes 21,895   Number of spoilt votes 15,952
Electoral result Edit the value on Wikidata
<1
2>
JxSí  — Raül Romeva
1,628,714   39.59٪
Deputy 62
<1
2>
Cs  — Inés Arrimadas
736,364   17.9٪
Percentage point 10.33
Deputy 9 → 25 Number of seats 16
<1
2>
PSC  — Miquel Iceta i Llorens
523,283   12.72٪
Percentage point 1.71
Deputy 20 → 14 Number of seats 6
<1
2>
CSQP  — Lluís Rabell
367,613   8.94٪
Deputy 11
<1
2>
PPC  — Xavier García Albiol
349,193   8.49٪
Percentage point 4.49
Deputy 19 → 11 Number of seats 8
<1
2>
CUP-CC  — Antonio Baños Boncompain
337,794   8.21٪
Deputy 10
Logo unio 2015.png Democratic Union of Catalonia
103,293   2.51٪
Deputy 0
Nuevo Logo PACMA.jpg PACMA  — Anaïs Arranz Mir
30,157   0.73٪
Percentage point 0.16
Deputy 0
Transparent flag waving on Infobox grey background.svg
Recortes Cero - Els Verds
14,444   0.35٪
Deputy 0
Logotip de Pirates de Catalunya.svg PIRATA.CAT
327   0.01٪
Percentage point 0.49
Deputy 0

Eleccions al parlament de Catalunya de 2015.png Edit the value on Wikidata
Presidential investiture in Catalonia, 2016
Puigdemont Government Edit the value on Wikidata
President of the Generalitat of Catalonia
Replaces:Elected person:
Artur MasCarles Puigdemont

Member of the Parliament of Catalonia
Replaces:Elected person:
Second Mas GovernmentJunts pel Sí Edit the value on Wikidata
Immediate cause of
January 10, 2016: Presidential investiture in Catalonia, 2016
January 12, 2016: Puigdemont Government Edit the value on Wikidata
 ← 2012 Edit the value on WikidataCatalonia Edit the value on Wikidata 2017 Edit the value on Wikidata  → 
Infobox electiontwo-round system
2017 French presidential election (Q7020999)
Point in timeApril 23, 2017, First round of French presidential election, 2017
May 7, 2017, Second round of French presidential election, 2017 Edit the value on Wikidata
Typepresidential election in France Edit the value on Wikidata
Office contestedPresident of the French Republic. Term length of office: 5 years old Edit the value on Wikidata
Election campaign14 day Edit the value on Wikidata
Voter turnout
First voting round Edit the value on Wikidata
Electorate47,582,183 Edit the value on Wikidata
Q189760 noun 84860 ccReJeanSoo vote.svg37,003,728
   77.77٪
Percentage point 1.65
Total valid votes36,054,394    Number of blank votes 659,997   Number of spoilt votes 289,337
Second voting round Edit the value on Wikidata
Electorate47,568,693 Edit the value on Wikidata
Q189760 noun 84860 ccReJeanSoo vote.svg35,467,327
   74.56٪
Percentage point 5.79
Total valid votes31,381,603    Number of blank votes 3,021,499   Number of spoilt votes 1,064,225
Electoral result Edit the value on Wikidata Edit the value on Wikidata

Élection présidentielle française de 2017 T1 carte départements & régions.svg
Leading candidate and vote share by department in the first round Élection présidentielle française de 2017 T2 carte départements & régions.svg
Leading candidate and vote share by department in the second round Edit the value on Wikidata
Investiture Emmanuel Macron
Presidency of Emmanuel Macron Edit the value on Wikidata
President of the French Republic
Replaces:Elected person:
François HollandeEmmanuel Macron

President of the French Republic
Replaces:Elected person:
Emmanuel Macron Edit the value on Wikidata
Immediate cause of
May 14, 2017: investiture
presidency of Emmanuel Macron Edit the value on Wikidata
 ← 2012 Edit the value on WikidataFrance Edit the value on Wikidata 2022 Edit the value on Wikidata  → 
}