Template:Table cell templates/doc

The templates in this series are designed to be used in atableto make a cell with text in that cell, with an appropriately colored background. They are commonly used incomparison tables.Most of these templates should not be used simply to produce a background color, use them according to their meaning.

For example,{{yes}}makes a cell with a green background. The text in the cell is taken from thefirst parameter;{{yes|Sure}}would output "Sure" otherwise it defaults to "Yes". Most templates allow authors to override the default text in this way, some require text put after the template call and some also need a vertical bar in between:{{table cell template}}textor{{table cell template}}| text.This information, the colors and default texts are found in the table below.

Important:If you want to use other attributes for the table cells,e.g.colspan,rowspan,orstyle,they need to be put before the template call, and there must beno vertical bar (aka pipe)|in-between them:

Yes	No	—
Yes/No

...
!{{Yes}}||{{No}}||rowspan=2{{n/a}}
|-
|colspan=2 style= "border:solid 3px Maroon"{{Yes-No}}
...

Templates

Table cell templates

Class	Default		Customized
	Syntax	Preview	Syntax	Preview
table-rh	{{rh}}| Row header	Row header	{{rh|align=right}}| Row header	Row header
	{{rh2}}| Row header	Row header	{{rh2|align=center}}| Row header	Row header
table-yes	{{yes}}	Yes	{{yes|customized [[Plain text|text]]}}	customizedtext
	{{yes C}}	Yes	{{yes C|customized [[Plain text|text]]}}	customizedtext
	{{yes O}}	Yes	{{yes O|customized [[Plain text|text]]}}	customizedtext
	{{yes N}}	Yes	{{yes N|customized [[Plain text|text]]}}	customizedtext
table-maybe	{{maybe}}	Maybe	{{maybe|customized [[Plain text|text]]}}	customizedtext
table-no	{{no}}	No	{{no|customized [[Plain text|text]]}}	customizedtext
	{{no O}}	No	{{no O|customized [[Plain text|text]]}}	customizedtext
	{{no X}}	No	{{no X|customized [[Plain text|text]]}}	customizedtext
	{{eliminated}}	Eliminated	{{eliminated|dropped out}}	dropped out
	{{lost}}	Lost	{{lost|missing}}	missing
	{{active fire}}	Active()	{{active fire|12%}}	Active(12%)
	{{safe}}	Safe	{{safe|protected}}	protected
	{{no Y}}	No	{{no Y|customized [[plain text|text]]}}	customizedtext
table-active	{{active}}	Active	{{active|live}}	live
table-siteactive	{{site active}}	Active	{{site active|up}}	up
	{{coming soon}}	Coming soon	{{coming soon|second half of the year}}	second half of the year
table-siteinactive	{{site inactive}}	Inactive	{{site inactive|down}}	down
table-success	{{success}}	Success	{{success|mission complete}}	mission complete
	{{operational}}	Operational	{{operational|returning data}}	returning data
table-failure	{{failure}}	Failure	{{failure|wrong orbit}}	wrong orbit
table-yes2	{{yes2}}		{{yes2|text}}	text
	{{good}}	Good	{{good|A}}	A
	{{ya}}		{{ya|text=ya}}	ya
	{{ya|Ya}}		{{ya|text|link=WP:ALT}}
	{{yan}}		{{yan|text=ya}}	ya
	{{won}}	Won	{{won|text=white|color=darkblue|winner}}	winner
	{{won|place=1}}	1	{{won|place=gold}}	gold
	{{won|place=2}}	2	{{won|place=silver}}	silver
	{{won|place=3}}	3	{{won|place=bronze}}	bronze
	{{WinDL}}	W	{{WinDL|win}}	win
	{{WinDL|res=D}}	D	{{WinDL|res=draw}}	draw
	{{WinDL|res=L}}	L	{{WinDL|res=loss}}	loss
table-no2	{{no2}}		{{no2|text}}	text
	{{na}}		{{na|text=na}}	na
	{{na|Na}}		{{na|text|link=WP:ALT}}
	{{nan}}		{{nan|text=na}}	na
	{{nom}}	Nominated	{{nom|5}}	5
	{{notnom}}	Not nominated	{{notnom|not selected}}	not selected
	{{shortlisted}}	Shortlisted	{{shortlisted|proposed}}	proposed
	{{longlisted}}	Longlisted	{{longlisted|rejected}}	rejected
	{{TBA}}	TBA	{{TBA|to be announced}}	to be announced
table-partial	{{partial}}	Partial	{{partial|almost done}}	almost done
	{{Regional}}	Regional	{{Regional|Uyghur}}	Uyghur
	{{MaybeCheck}}		{{MaybeCheck|text=possibly}}	possibly
	{{MaybeCheck|possibly}}		{{MaybeCheck|text|link=WP:ALT}}
	{{partial success}}	Partial success	{{partial success| reached orbit and returned pictures}}	reached orbit and returned pictures
	{{partial failure}}	Partial failure	{{partial failure|[[Cubesat]] not deployed}}	Cubesatnot deployed
	{{okay}}	Neutral	{{okay|C}}	C
	{{Yes-No}}	Yes/No	{{Yes-No|yes with an if; no with a but}}	yes with an if; no with a but
	{{some}}	Some	{{some|many}}	many
	{{pending}}	Pending	{{pending|awaiting}}	awaiting
	{{sometimes}}	Sometimes	{{sometimes|occasionally}}	occasionally
	{{rarely}}	Rarely	{{rarely|seldom}}	seldom
	{{usually}}	Usually	{{usually|commonly}}	commonly
	{{unofficial}}	Unofficial	{{unofficial|''de facto''}}	de facto
	{{unofficial2}}	Unofficial	{{unofficial2|''de facto''}}	de facto
	{{nonpartisan}}	Nonpartisan	{{nonpartisan|impartial}}	impartial
table-any	{{any}}	Any	{{any|anyone}}	anyone
table-automatic	{{perhaps}}	Perhaps	{{perhaps|maybe}}	maybe
table-draw	{{draw}}		{{draw|1:1}}	1:1
table-noAttempt	{{No attempt}}	No attempt	{{No attempt|No landing attempted}}	No landing attempted
table-na	{{n/a}}	—	{{n/a|unavailable}}	unavailable
	{{varies}}	Varies	{{varies|differs}}	differs
	{{non-album single}}	Non-album single	{{non-album single|EP}}	Non-album single
	{{unreleased}}	Unreleased	{{unreleased|shelved}}	shelved
	{{BLACK}}	N/A	{{BLACK|banned}}	banned
	{{sdash}}	—	{{sdash}}	—
	{{vacant}}	Vac­ant	{{vacant|missing}}	missing
table-unknown	{{unknown}}	Un­known	{{unknown|?}}	?
	{{dunno}}	?	{{dunno|not sure}}	not sure
table-included	{{included}}	Included	{{included|incorporated}}	incorporated
noresult	{{no result}}	No result	{{no result|NR}}	NR
table-planned	{{planned}}	Planned	{{planned|July 2028}}	July 2028
table-scheduled	{{scheduled}}	Scheduled	{{scheduled|3 March 2027}}	3 March 2027
table-software	{{beta}}	Beta	{{beta|preview}}	preview
	{{table-experimental}}	Experimental	{{table-experimental|lab}}	lab
	{{nightly}}	Nightly build	{{nightly|dev}}	dev
	{{release-candidate}}	Release candidate	{{release-candidate|RC}}	RC
	{{open source}}	Open source	{{open source|software libre}}	software libre
	{{free}}	Free	{{free|empty}}	empty
	{{proprietary}}	Proprietary	{{proprietary|custom extension}}	custom extension
	{{nonfree}}	Non-free	{{nonfree|paid}}	paid
	{{needs}}	Needs	{{needs|req.}}	req.
table-depends	{{depends}}	Depends	{{depends|vendor-defined}}	vendor-defined
table-dropped	{{dropped}}	Dropped	{{dropped|discontinued}}	discontinued
	{{terminated}}	Terminated	{{terminated|fired}}	fired
incorrect	{{incorrect}}	Incorrect	{{incorrect|wrong}}	wrong
table-debate	{{D-P}}	P	{{D-P|present}}	present
	{{D-A}}	A	{{D-A|absent}}	absent
	{{D-I}}	I	{{D-I|invited}}	invited
	{{D-O}}	O	{{D-O|other debate}}	other debate
	{{D-N}}	N	{{D-N|not invited}}	not invited
	{{D-Nv}}	NV	{{D-Nv|not voting}}	not voting
	{{D-W}}	W	{{D-W|withdrawn}}	withdrawn
	{{D-Out}}	Out	{{D-Out|out of race}}	out of race
table-cast	{{CMain}}	Main	{{CMain|text}}	text
	{{CAlso starring}}	Also starring	{{CAlso starring|costar}}	costar
	{{CRecurring}}	Recurring	{{CRecurring|regular guest}}	regular guest
	{{CGuest}}	Guest	{{CGuest|victim}}	victim
	{{COther}}	Does not appear	{{COther|ensemble}}	ensemble
	{{CNone}}	Does not appear	{{CNone|cast}}	cast
	{{CRemoved}}	removed	{{CRemoved|edited}}	edited
	{{CFinalist}}	Finalist	{{CFinalist|contender}}	contender
	{{CFinalist|place=3rd Place}}	3rd Place	{{CFinalist|place=third place}}	third place
	{{exempt}}	exempt	{{exempt|exe}}	exe
	{{Black Exempt}}	B.Exempt	{{Black Exempt|lack}}	lack
	{{nocontest}}		{{nocontest|rescheduled}}	rescheduled
	{{Runner-up}}	Runner-up	{{Runner-up|2nd Place}}	2nd Place
	{{Quit}}	Quit	{{Quit|left}}	left
no class	{{not yet}}	Not yet	{{not yet|NY}}	NY
	{{optional}}	Optional	{{optional|non-mandatory}}	non-mandatory
	{{shade|100}}%	100%	{{shade|color=blue|100}}%	100%
	{{shade|75}}%	75%	{{shade|color=blue|75|73–78}}%	73–78%
	{{shade|25}}%	25%	{{shade|color=blue|25|{{val|25|2|u=%}}}}	25%±2%
	{{shade|0}}%	0%	{{shade|color=blue|0}}%	0%
	{{cell color|2|0|10}}	2	{{cell color|5|0|10|FF0000|0000FF}}	2
	{{CellCategory|1}}		{{CellCategory|1|Group A}}	Group A
	{{CellCategory|2}}		{{CellCategory|2|Group B|align=tc}}	Group B
	{{CellCategory|3}}		{{CellCategory|3|Group C|align=tr}}	Group C

Code

Common code to most if not all the templates in this series:

style= "background: #abcdef;color: black; vertical-align: middle; text-align: {{{align|center}}}; {{{style|text-transform: capitalize;}}} "class="automatictable-automatic"| {{{1|text}}}

Creating new templates

To make a new table cell template you can use:

{{subst:Table cell templates|text=default text|bg=background color|class=a class name without prefix|align=standard horizontal alignment}}

You should leave out thealignparameter and often theclassparameter is unnecessary, too.

Add the new template to the table in thecommon documentationafterwards. Please consider reusing one of the other templates and please choose the color sensibly.

If you find a table cell template that does not take a parameter and you want to be able to change the text in the cell,do notduplicate the template! Instead, edit the template and change the text to a default parameter substitution. For example, if a template's text isDropped,change that to{{{1|Dropped}}}.

style= "background: #abcdef; color: black; vertical-align: middle; text-align: {{{align|center}}}; {{{style|}}}" class= "automatic table-automatic" | {{{1|text}}}

Choosing a color

When changing or creating a new template, follow theuse of colour guidelinesand thecolor accessibility guidelineswhen choosing the background color and, sometimes, the text color. Many of these templates can be used with links to other articles or references, so the links should be clearly identifiable against the background color. You can check contrast level using theWebAIM contrast checkerby setting the foreground color to theblue linkcolor. Contrast should be at the minimum WCAG AA level and, whenever possible, at WCAG AAA level.Wikipedia:Manual of Style/Accessibility/Colorshas a set of colors that comply with WCAG AAA and WCAG AA for unvisited links and normal text.

Color subpage

All templates should either have a/bgcolorsubpage that contains nothing but a valid CSS color code, possibly wrapped innowikitags, e.g.#BFD,which can be included withbackground: {{/bgcolor}};in thestyleattribute, or they should reference another template's subpage, e.g.background: {{Template:Yes2/bgcolor}};.Alternatively, the/bgcolorsubpage may redirect to another color code subpage:#REDIRECT [[yes2/bgcolor]].

This way, pages that are using these templates may also use{{legend}}and similar templates which can reference the actual color:{{legend|{{yes2/bgcolor}}|supported}}

TemplateData

This is theTemplateDatafor this template used byTemplateWizard,VisualEditorand other tools.See a monthly parameter usage reportforTemplate:Table cell templatesin articles based on its TemplateData.

TemplateData for Table cell templates

One of several templates for styling individual table cells with standard contents and colors.

Template parameters

This template prefers inline formatting of parameters.

Parameter		Description	Type	Status
text	1	text to be displayed instead of the default; if this doesn't work put the text after the template, possibly with a vertical bar | in between Default (template dependent)	Content	optional
horizontal align	align	text alignment inside the cell, either 'left', 'right', 'center' or 'justified' Suggested values leftcenterrightjustified Default center	String	optional
style	style	a semicolon-separated list of additional CSS rules to be applied to the table cell Default (template dependent)	String	optional
background color	color	a valid CSS color value or name to override the standard cell background, only available with some templates Default (template dependent)	Line	optional

See also

• {{Change}}– calculates, displays and color-codes changes between two values
• {{Cell color}}- Shaded cell based on value in a range with automatic text visibility
• {{BSD-lic}}– specialized redirect for{{free}}
• {{GPL-lic}}– specialized redirect for{{free}}
• {{LGPL-lic}}– specialized redirect for{{free}}
• {{Active}}/{{No result}}/{{Eliminated}}forcomparison tables