Template:BLP sources/doc

{{BLP refimprove}}

This is a documentation subpage for Template:BLP sources.
It may contain usage information, categories and other content that is not part of the original template page.

This template is used on approximately 101,000 pages.
To avoid major disruption and server load, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Consider discussing changes on the talk page before implementing them.

File:Police man Twinkle Head.svg

If you plan to make breaking changes to this template, move it, or nominate it for deletion, please notify Twinkle's users and maintainers at OODA WIKI talk:Twinkle as a courtesy, as the standard installation of Twinkle adds and removes this template. Thank you!

File:AWB logo draft.svg

This template is used by the standard installation of AutoWikiBrowser (AWB). If you are planning to make any major changes to this template, how it should be used, or nominate it for deletion, please notify AWB's user base and maintainers beforehand at OODA WIKI talk:AWB as a courtesy.

Contentious material that is unsourced or poorly sourced must be removed immediately, especially if potentially libelous or harmful.

Alternatives:

In BLP articles that have no sources at all, the This is a documentation subpage for Template:BLP sources.
It may contain usage information, categories and other content that is not part of the original template page.

This template is used on approximately 101,000 pages.
To avoid major disruption and server load, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Consider discussing changes on the talk page before implementing them.

Shortcut

{{prod blp}}

This template uses Lua:

Module:Template link general

This template, often abbreviated as {{}}, is used to provide stylized formatting to template displays without actually using the template itself. The code generated will be displayed inline. For a multi-line output, see {{tj}}.

Parameters

With the exception of alttext, the named parameters are toggles that are either omitted (default in most cases) or activated (by being assigned a value such as "on", "yes", "true", "include", etc.). They may be included in any order (see Examples below). Certain templates have the parameter "on" by default; see the main table for all alternate options.

Parameter	Action	Use with {{example}}	Default active
	Default (without accessory parameters)	{{example}}
brace	Include braces as part of the template link	{{example}}	{{tlw}}/{{tn}}
braceinside	Include innermost braces as part of the template link	{{example}}
bold	Renders the template link/name in bold	{{example}}	{{tlb}}, {{tlxb}}
code	Display output using HTML `‎<code>...‎</code>` tags (monospaced font)	`{{example}}`	{{tlc}}, {{Template link expanded}}, etc.
italic	Display any parameters accompanying the template link/name in italics	{{example\|param}}	{{tlxi}}
kbd	Display output using HTML `‎<kbd>...‎</kbd>` tags (monospaced font)	`{{example}}`
nolink	Don't render the template name as a link	{{example}}	{{tlf}}, {{tnull}}
nowrap	Prevent the insertion of line breaks (word wrap) in the output	{{example}}
nowrapname	Prevent word wrapping in the output of template name/link (parameters will wrap if needed)	{{example}}
plaincode	Uses `‎<code style="border:none; background:transparent;">...‎</code>`	`{{example}}`	{{tltss}}
subst	Include a subst: prefix before the template link/name	{{subst:example}}	{{tls}}, {{tlxs}}, etc
alttext=`[text]`	Replace `[text]` with the actual label to be displayed for the template link	{{Other}}	{{tla}}
_show_result	Will also display the result of the template	`{{Min\|7\|-5}}` → -5
_expand	Will add a link to the expanded template page	`{{Min\|7\|-5}}` [1]

Unnamed (Positional)

This template can take any number of unnamed parameters as parameters accompanying the template link (or name); see Examples below.

Examples

Code	Output	Remarks
{{prod blp\|Banner}}	Template:Prod blp	Template:Banner does not exist. (Non-existent template is redlinked.)
{{prod blp\|Abc}}	Template:Prod blp	Template:Abc exists.
{{prod blp\|abC}}	Template:Prod blp	Template names are case-sensitive
{{prod blp\|abc}}	Template:Prod blp	(but the first letter is case-insensitive).
{{prod blp\|x0}}	Template:Prod blp	no parameters
{{prod blp\|x1\|one}}	Template:Prod blp	one parameter
{{prod blp\|x2\|one\|two}}	Template:Prod blp	two parameters
{{prod blp\|x3\|1\|2\|3\|4\|5\|6\|7\|8\|9\|10}}	Template:Prod blp	ten parameters
`{{tlg\|convert\|<nowiki>14\|m\|ftin\|abbr=out\|sp=us</nowiki>}}`	Template:Prod blp	Unlimited parameters, as one `‎<nowiki>...‎</nowiki>` string.
{{prod blp\|x2\|\|two\|\|}}	Template:Prod blp	Empty parameters are discarded.
{{prod blp\|x0\|code=on}}	Template:Prod blp	<code> style
{{prod blp\|x0\|plaincode=on}}	Template:Prod blp	plaincode style
{{prod blp\|x0\|kbd=on}}	Template:Prod blp	<kbd> style
{{prod blp\|x0\|bold=on}}	Template:Prod blp	bold link/name
{{prod blp\|x1\|one\|italic=on}}	Template:Prod blp	parameter(s) in italics
{{prod blp\|x0\|nolink=on}}	Template:Prod blp
{{prod blp\|x0\|subst=on}}	Template:Prod blp
{{prod blp\|x0\|brace=on}}	Template:Prod blp	all braces in link
{{prod blp\|x0\|braceinside=on}}	Template:Prod blp	inside braces in link
{{prod blp\|x0\|alttext=x0 link}}	Template:Prod blp
{{prod blp\|x0\|bold=on\|code=on\|brace=on}}	Template:Prod blp	Combine multiple parameter settings.
`{{tlg\|x1\|{{spaces}}one{{spaces}}}}`	Template:Prod blp	Using {{spaces}} before and after a parameter.
{{prod blp\|x2\|bold=on\|code=on\|one\|two}}	Template:Prod blp	Can combine named and anonymous parameters ...
{{prod blp\|x2\|one\|two\|bold=on\|code=on}}	Template:Prod blp	... in any order ...
{{prod blp\|x2\|one\|code=on\|two\|bold=on\|three}}	Template:Prod blp	... even intermixed ...
{{prod blp\|x2\|one\|code=on\|two\|bold=on\|three\|italic=on}}	Template:Prod blp	... with many configurations.
`{{tlg\|x1\|x=u}}`	Template:Prod blp	= won't work
`{{tlg\|x1\|x=u}}`	Template:Prod blp	`=` is okay
`{{tlg\|x1\|x{{=}}u}}`	Template:Prod blp	`{{=}}` is okay (see Template:=)
`{{tlg\|x1\|x<nowiki>=</nowiki>u}}`	Template:Prod blp	Sticky nowiki is okay.
{{prod blp\|x2\|3=two\|2=one}}	Template:Prod blp	Right-to-left is okay
{{prod blp}}	prod blp	With no arguments, it emits the current page name without braces.
{{prod blp\|x2\|3=one\|4=two}}	Template:Prod blp	Null parameter stops parsing.

Wrapping of long names (default)
Code	Output
{{prod blp\|long template name that would wrap to new line\|this is a long value for the 1st parameter that would wrap}}	Template:Prod blp

Wrapping of long names (`nowrap=on`)
Code	Output
{{prod blp\|nowrap=on\|long template name that would wrap to new line\|long value for the 1st parameter that would wrap}}	Template:Prod blp

Wrapping of long names (`nowrapname=on`)
Code	Output
{{prod blp\|nowrapname=on\|long template name that would wrap to new line\|long value for the 1st parameter that would wrap}}	Template:Prod blp

Comparison of template-linking templates according to the styles of generated text and link produced
Text style ↓	`{{tlg}}` options^{[note 1]} to achieve text style	Link style
Text style ↓	`{{tlg}}` options^{[note 1]} to achieve text style	Linked	Unlinked	Linked with subst	Unlinked with subst	Linked including braces	Linked with alternative text
`{{tlg}}` options^{[note 1]} to achieve link style	—	DEFAULT	`nolink=yes`	`subst=yes`	`nolink=yes\|subst=yes`	`braceinside=yes`	`alttext=Foo` `2=Foo`
normal	DEFAULT	{{tlg}}^{[note 1]} {{tl}} {{tlp\|1\|2\|...}}^{[note 2]} {{Template:tlu}}^{[note 3]}	{{tlf}}^{[note 2]} ^{<template link>}	Template loop detected: Template:Tls {{subst:Template:tlsu}}^{[note 3]}	{{subst:tlsf}}^{[note 2]} ^{<template link>}	{{tn}}	{{tla}}
`code`	`code=yes`	`{{tl2}}` `{{tlx}}` `{{Template:tlxu}}`^{[note 3]}	`{{tlc}}`^{[note 2]} ^{<template link>} `{{tnull}}`^{<template link>}	`{{subst:tlxs}}`	`{{subst:tlsc}}`^{[note 2]} ^{<template link>}	—
monospace	`plaincode=yes`^{[note 4]}	—		{{subst:tltss}}^{[note 5]}	—
`kbd`	`kbd=yes`^{[note 5]}	—		{{subst:tltss}}^{[note 5]}	—
bold	`bold=yes`	{{tlb}}	—
`bold+code`	`bold=yes\|code=yes`	`{{tlxb}}`
`italic+code`	`italic=yes\|code=yes`	`{{tlxi}}`

↑ ^1.0 ^1.1 ^1.2 {{tlg}} is the most general template, allowing any combination of text style and/or link style options.
↑ ^2.0 ^2.1 ^2.2 ^2.3 ^2.4 Prevents wrapping of text by placing it inside ‎<span class="nowrap">...‎</span> tags.
↑ ^3.0 ^3.1 ^3.2 Allows links to templates in any namespace.
↑ {{tlg|plaincode=yes}} uses ‎<code style="border:none; background-color:transparent;">...‎</code>.
↑ ^5.0 ^5.1 Displays monospaced font using ‎<span style="font-family:monospace;">...‎</span>.

Other formatting templates

Templates producing specialised formatting effects for given templates, modules or parameters
Code example	Effect	Notes
`{{Tj\|Hatnote\|Some text\|selfref: yes\|category: no\|lang: fr}}`	{{Hatnote \| Some text \| selfref = yes \| category = no \| lang = fr }}	Supports colors, placeholder texts, named and unnamed parameters
<syntaxhighlight lang="wikitext"> {{Hatnote \| Some text \| selfref = yes \| category = no \| lang = fr }} </syntaxhighlight>	{{Hatnote \| Some text \| selfref = yes \| category = no \| lang = fr }}	Same as above
`{{Tji\|Hatnote\|Some text\|selfref: yes\|category: no\|lang: fr}}`	{{Hatnote\|Some text\|selfref=yes\|category=no\|lang=fr}}	Supports colors, placeholder texts, named and unnamed parameters
`<syntaxhighlight lang="wikitext" inline>{{Hatnote\|Some text\|selfref=yes\|category=no\|lang=fr}}</syntaxhighlight>`	`{{Hatnote\|Some text\|selfref=yes\|category=no\|lang=fr}}`	Same as above
`{{tl2\|Hatnote\|lang=fr}}`	`{{hatnote}}`	Supports linking to sister projects (e.g., fr:Hatnote)
`{{demo\|<nowiki>{{Hatnote\|lang=fr\|Some text}}</nowiki>}}`	{{hatnote\|lang=fr\|Some text}} Some text	Shows code and example
`{{tln\|Hatnote}}`	Template:Hatnote	Produces a normal link to the template
`{{elc\|Template:Hatnote}}` `{{elc\|Template:Hatnote\|Hatnote}}`	`[[Template:Hatnote]]` `[[Template:Hatnote\|Hatnote]]`	Formats wikilink, with optional piped link text and blended suffix
`{{ml\|Example\|hello}}`	{{#invoke:Example\|hello}}	Counterpart to {{tl}} for linking to Lua modules
`{{mfl\|Example\|hello}}`	{{#invoke:Example\|hello}}	Similar to {{ml}}, but expects the function to be documented and creates a link to the corresponding section
`{{mlx\|Example\|hello}}`	`{{#invoke:Example\|hello}}`	Counterpart to {{tlx}} for linking to Lua modules
`{{ml-lua\|Module:Example\|hello}}`	`require('Module:Example')`	Link to Lua modules and built-in libraries, showing Lua code.
`{{para\|title\|<var>book title</var>}}`	`\|title=book title`	Formats template parameters for display, with or without values
`{{sclx\|LASTING}}`	`[[WP:LASTING]]`	Takes a shortcut suffix in project namespace and displays it with brackets and the WP: alias in a `‎<code>...‎</code>` tag.
`{{tag\|ref}}` `{{xtag\|templatedata}}`	`‎<ref>...‎</ref>` `<templatedata>`	Formats [X]HTML tags; can add content, choose opening, closing, or self-closing
`{{dtl\|Ping project}}`	{{d:Ping project}}	Wikidata counterpart to {{tl}}
`{{pf\|if}}` `{{pf\|if\|{{{1}}}\|true\|false}}`	{{#if}} {{#if:{{{1}}}\|true\|false}}	Parser function equivalent to {{tl}}
`{{magic word\|uc:}}`	{{uc:}}	Magic word links

With utility links

Templates producing utility links for a given template (Hatnote used here as example)
Code example	Effect
`{{lt\|Hatnote}}`	[[Template:]]
`{{lts\|Hatnote}}`	Template:Hatnote(edit talk links history)
`{{t links\|Hatnote}}`	{{Hatnote}} (edit talk history links # /subpages /doc /doc edit /sbox /sbox diff /test)
`{{tfd links\|Hatnote}}`	Template:Hatnote (talk · history · transclusions · logs · subpages)
`{{tetl\|Hatnote}}`	{{Hatnote}} links talk edit
`{{tsetl\|Hatnote}}`	{{subst:Hatnote}} links talk edit
`{{ti\|Hatnote}}`	{{Hatnote}}
`{{tic\|Hatnote}}`	Template:Hatnote (talk links edit)
`{{tim\|Hatnote}}`	m:Template:Hatnote (backlinks edit)
`{{tiw\|Hatnote}}`	Template:Hatnote (backlinks edit)
`{{tlt\|Hatnote}}`	{{Hatnote}} (talk)
`{{ttl\|Hatnote}}`	{{Hatnote}} (t/l)
`{{twlh\|Hatnote}}`	Template:Hatnote (links, talk)

template should be used. Otherwise, use {{BLP unsourced}}.

In non-BLP articles that require additional sources, the {{More citations needed}} template should be used instead.
Be bold! Consider searching for references and adding them to the article, instead of this template.
Consider not adding this template to extremely short articles.

This template uses Lua:

Usage

This template is intended to be placed at the top of articles about living persons that need additional references, and are therefore in need of immediate attention. If the article is not about a living or recently deceased subject, you may wish to use {{More citations needed}} instead.

Please add a date parameter. Adding a date parameter sorts the article into subcategories of Category:BLP articles lacking sources and out of the parent category, allowing the oldest problems to be identified and dealt with first.

Finally, if the article has a defaultsort, this is used for these categories as well. Otherwise, it is sorted on the first word (usually the first name).

Parameters

date = November 2024 - required parameter, will be added by bot
reason = text - optional parameter which appends advisory text

The following parameter is obsolete: |suffix= (simply use the first unnamed parameter).

Examples

Paste-ready example: {{BLP sources|date=November 2024}}

Example with reason: {{BLP sources|date=November 2024|reason=}}

This template can be used with a "section" parameter to tag specific sections: {{BLP sources|section|date=November 2024}}

Redirects

The following templates redirect here:

{{BLP+}}
{{BLP Improvereferences}}
{{BLP improvereferences}}
{{blp improvereferences}}
{{BLPImprovereferences}}
{{BLPimprovereferences}}
{{blpimprovereferences}}
{{BLPmoreref}}
{{BLP Refimprove}}
{{BLP refimprove}}
{{blp refimprove}}
{{BLPRefimprove}}
{{BLPrefimprove}}
{{blprefimprove}}
{{BLP Sources}}
{{blp sources}}
{{BLPSources}}
{{BLPsources}}
{{blpsources}}
{{BLP more sources}}
{{refimprove-BLP}}
{{BLP refimprove}}
{{BLP citations needed}}

Tracking categories

The template populates:

Category:Pages using BLP sources with unknown parameters (0) – when unrecognized parameters are invoked on the transcluding page.

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. Click here to see a monthly parameter usage report for this template in articles based on this TemplateData.

TemplateData for BLP sources

No description.

Template parameters
Parameter		Description	Type	Status
Section	`1`	Add "section" if the tag applies to a particular section	String	optional
Date	`date`	The month and year the template was added, in the form "July 2013" Example June 2016 Auto value `{{SUBST:CURRENTMONTHNAME}} {{SUBST:CURRENTYEAR}}`	String	required
Reason	`reason`	A reason for adding the tag	String	optional

v t e Citation and verifiability article maintenance templates
Sourcing	{{Circular}} {{Dubious}} {{Excessive citations}} {{Further reading cleanup}} {{More citations needed}} {{More citations needed section}} {{More footnotes needed}} {{No footnotes}} {{No significant coverage}} {{One source}} {{One source section}} {{Only primary sources}} {{NRIS only}} {{Primary sources}} {{Primary sources section}} {{Religious text primary}} {{Self-published}} {{Self-reference cleanup}} {{Self-sourcing examples}} {{Refexample section}} {{Sources exist}} {{Text-source}} {{Third-party}} {{Unreferenced}} {{Unreferenced section}} {{Unreferenced category}} {{Unreliable sources}} {{Unreliable sources section}} {{User-generated}}
BLP-specific	{{BLP unreferenced}} {{BLP unreferenced section}} {{BLP primary sources}} {{BLP self-published}} {{BLP sources}} {{BLP sources section}} {{BLP IMDb-only refimprove}} {{BLP IMDb refimprove}} {{BLP no footnotes}} {{BLP more footnotes needed}} {{BLP one source}}
Topic specific	{{Localist}} {{Media IMDb refimprove}} {{More medical citations needed}} {{More science citations needed}} {{Neologism}} {{Science review}} {{Unreferenced law}} {{Unreferenced-law section}} {{Unreferenced medical section}}
Dispute-related	{{Cite check}} {{Cite check section}} {{Content}} {{Disputed}} {{Dispute about}} {{Disputed section}} {{Disputed chem}} {{Disputed list}} {{Disputed map}} {{Expert needed}} {{Hoax}} {{Original research}} {{Original research section}} {{Speculation}} {{Speculation section}} {{Synthesis}} {{Verifiability}} {{Verify sources}}
Citation improvements	{{Citation style}} {{Citations broken}} {{Cleanup bare URLs}} {{Format footnotes}} {{Full citations needed}} {{Ibid}} {{Page numbers improve}} {{Page numbers needed}} {{Shallow references}}
General advice	Citing sources Reliable sources Maintenance template removal Citation needed Find sources Combining sources Referencing styles

Template:BLP sources/doc

Parameters

Unnamed (Positional)

Examples

See also

General-purpose formatting

Other formatting templates

With utility links

Usage

Parameters

Examples

Redirects

Tracking categories

TemplateData

See also