Template:Redacted content/sandbox

████████

This is the template sandbox page for Template:Redacted content (diff).
See also the companion subpage for test cases.

Template documentationview edit history purge

{{redacted content}} stylistically renders text that has been censored (see redact in Wiktionary). This template will commonly be used when citing formerly-classified documents that have been released via a Freedom of Information Act request or similar.

Usage

{{redacted content}} → ████████

{{redacted content|5}} → █████

{{redacted content|color=cyan}} → ████████

Parameters

Parameter	Default	Explanation
length	8	The length of the redaction and thus the number of blocks to use.
color	#000	The color of the redacted text. This can be either an HTML color name (eg "black" or "white"), or a RGB hexadecimal representation of a color (eg "#000" for black, "#ff0000" for red).
replacement		If present, a tooltip will display this text when hovering over the redacted area with the heading "replacement = ".
text	█	If present, the text will be rendered on the "redacted" area. Note that this text will always be rendered in black; to be visible, utilize the `color=` parameter to adjust the color of the redaction.
foia-exceptions		If present, a tooltip will display this text while hovering over the redacted area with the heading "FOIA Request Exceptions:". This is intended to be used to list exemptions to the Freedom of Information Act.

Examples

Full width

Set the width= parameter to full to get a full width redaction:

{{redacted content|full}} and {{redacted content|width=full}} render as:

Redaction colour

To redact in another colour then utilise the parameter color=, eg. color = white. This can be useful when the redaction still shows the original text.

{{redacted content|color=white}} renders as: ████████

Text content

If the redacted text is still visible, you can add the text with the text= parameter. Note you probably need to change the colour to something other than black for it to be visible.

{{redacted content|color=grey|text=This was redacted}} renders as: This was redacted

Remarks (Tooltip)

By default, when hovering over a redaction, a tooltip will show that reads "redacted text". If the replacement= parameter is used, this value will be added to the tooltip. Hover your mouse over the examples below.

NOTE: this functionality makes use of "hovering" a mouse. It is therefore not available to users on mobile devices, tablets, touch screens, visually impaired users with text readers, and so on. Use sparingly.

A regular redaction with no replacement= parameter: {{redacted content}} → ████████

A redaction with a replacement= parameter: {{redacted content|replacement=Example Text.}} → ████████

Freedom of Information Act Request Exceptions (Tooltip)

The US Freedom of Information Act, which forces the US government to release documents, includes a number of listed exceptions. When a document is released, these exceptions may cause information to be redacted. If present and documented, this exception can be included in a tooltip on the redacted area using the foia-exceptions= parameter.

This parameter may be used in conjunction with the remarks= parameter.

The following redaction includes an FOIA request exception: {{redacted content|foia-exceptions=(b)(6), (b)(7)(c)}} → ████████