Template:R from emoji/doc

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

This template is used on approximately 2,700 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.

This is a redirect from an emoji (whether or not it is in the Unicode chart emojis).

This template should not be substituted nor used to tag soft redirects.

Template:R from emoji is used to categorize emoji redirects and populates Category:Redirects from emoji when used.

Usage

This template can be used in combination with {{Redirect category shell}} or without. This is in accord with instructions found at Wikipedia:REDCAT.

Use this template on any redirect from a title that is an emoji, whether or not it is included in the Unicode chart single emoji (i.e. ♥ uses this template).
For emoji that are a single Unicode character, it should be paired with {{R from Unicode character}}.
- This does not include emoji with skin-tone modifiers, or country flags, which consist of multiple characters. 👩🏿‍🤝‍👨🏼, for example, is rendered as one character in most web browsers, but is composed of seven (this can be seen in the percent-encoded title of its article: https://en.wikipedia.org/w/index.php?title=👩🏿‍🤝‍👨🏼).
For emoji which are a subset of another emoji (such as skin tone variations), use {{R avoided double redirect}} with the value being the base emoji.

When using Template:Redirect category shell

{{Redirect category shell}} may be used to add as many appropriate redirect categories as needed to a redirect. Add this redirect category to a redirect in the following manner:

#REDIRECT [[(target page name)]]

{{Redirect category shell|
{{R from emoji}}
}}

When used individually

#REDIRECT [[(target page name)]]

{{R from emoji}}

Optional parameters

Emoji name

The name of the emoji should be added using the |1= parameter. This helps identify the emoji and also sort it by its name.

{{R from emoji|(name)}}
{{R from emoji|1=(name)}}

The |name= comes from the CLDR and can be found in places such as: https://www.unicode.org/cldr/charts/44/annotations/americas.html

Flags

If the emoji is a flag, |flag= should be set.

{{R from emoji|(name)|flag=yes}}
{{R from emoji|1=(name)|flag=yes}}

Examples

#REDIRECT [[(target page name)]]

{{Redirect category shell|
{{R from emoji|Flag: Wales|flag=yes}}
}}

#REDIRECT [[(target page name)]]

{{Redirect category shell|
{{R from emoji|Person: Light Skin Tone}}
{{R avoided double redirect|🧑}}
}}

TemplateData

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

TemplateData for R from emoji

No description.

Template parameters
This template prefers inline formatting of parameters.
Parameter		Description	Type	Status
Name	`1`	The official CLDR emoji name. Example red exclamation mark	Line	suggested
Flag	`flag`	Set to "yes" if the emoji is that of a flag.	Line	optional