Template:Cite Instagram/sandbox

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

Template documentation[view] [edit] [history] [purge]

This template is a Citation Style 1 wrapper template based on {{Cite web}}. For centralised Citation Style 1 discussions, see Help talk:Citation Style 1.

Redirect

{{Cite instagram}}

This template is used on approximately 3,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.

Preview message: Transclusion count updated automatically (see documentation).

A template for citing content posted on Instagram.

Usage

Copy a blank version to use. Almost all parameter names are supported only in lower case (some initialisms, such as |isbn= have upper-case aliases like |ISBN=, which are acceptable for use). Use the "|" (pipe) character between each parameter. Unused parameters may be deleted to avoid clutter in the edit window. Some samples on this documentation page may include the current date. If the date is not current, then purge the page.

Required parameters only, in horizontal format
`{{Cite Instagram \|user= \|postid= \|title= \|date=}}`

Full parameter set in horizontal format
`{{Cite Instagram \|author= (or \|last= and \|first=) \|author-link= \|user= \|postid= \|date= \|title= \|script-title= \|trans-title= \|language= \|location= \|access-date= \|link= \|url-status= \|archive-url= \|archive-date= \|ref=}}`

Note: When known, the author's real name should be specified in the |author= parameter (or |last= and |first=). If their real name is not known, then the post is probably not an acceptable usage of a self-published source.

Examples

{{Cite Instagram |user=instagram |postid=CHDzGgCs568 |date=2 November 2020 |title=Happy Halloween |access-date=9 November 2020}}

@instagram (2 November 2020). "Happy Halloween". Retrieved 9 November 2020 – via Instagram.

Error detection

The parameters |user=, |postid=, |title=, |date= are required. If omitted or left blank, errors will be reported. For example:
{{Cite Instagram |title=I'm an incomplete citation!}}
"I'm an incomplete citation!" – via Instagram. {{Cite Instagram}}: Missing or empty |user= (help); {{Cite Instagram}}: Missing or empty |postid= (help); {{Cite Instagram}}: Missing or empty |date= (help)
The post URL depends on |postid=; if it is missing, the URL defaults to https://www.instagram.com/
Templates are checked for |ref=harv, which is an error. The |ref= parameter must use {{harvid}} in the value.
The template also checks for parameters that are unsupported (e.g. misspellings of parameter names).
Errors are tracked in Category:Cite instagram templates with errors

TemplateData

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

TemplateData for Cite Instagram

A template for citing content posted on Instagram

Template parameters[Edit template data]
This template has custom formatting.
Parameter		Description	Type	Status
postid	`postid`	Alpha-numeric ID of the post	String	required
username	`user`	Instagram account name, without the @	String	required
post	`title`	Partial or entire content of the post, optionally including hashtags (#), at signs (@), and links. Note: double quote marks (") should be replaced with single quote marks (') because the entire title will display surrounded by double quotes.	String	required
First name	`first`	The first name of the author.	String	suggested
Last name	`last`	The last name of the author.	String	suggested
author	`author`	Author's real name, if known. If not known, then the post is probably not an acceptable usage of a self-published source (see [[WP:SPS]])	Unknown	suggested
author's article	`author-link` `authorlink`	Title of existing Wikipedia article about the author	Unknown	optional
date	`date`	date of the post; do not wikilink; do not include time.	Unknown	required
access date	`access-date` `accessdate`	The full date when the post was accessed; do not wikilink	Unknown	optional
language	`language`	The language in which the post is written, if not in English. Example fr	String	optional
location	`location`	The location from which a post was sent. Example London	String	optional
archive URL	`archive-url` `archiveurl`	The URL of an archived copy of a web page, if or in case the URL becomes unavailable; requires 'archive-date'	String	optional
archive date	`archive-date` `archivedate`	Date when the original URL was archived; do not wikilink	String	optional
URL status	`url-status`	If set to 'live', the title displays as the live link; if set to dead, the title displays as the archive link	String	optional
script post	`script-title`	For post in languages that do not use a Latin-based alphabet (Arabic, Chinese, Cyrillic, Greek, Hebrew, Japanese, Korean, Vietnamese, etc). Prefix with two-character ISO639-1 language code followed by a colon, e.g. for Japanese use: ja:... Example ja:東京タワー	Unknown	optional
translated post	`trans-title`	An English language translation, if the post cited is in a foreign language; use of 'language' parameter is recommended	Unknown	optional
Link to Instagram article?	`link`	Set to "no" to not link to the Wikipedia article for Instagram. Useful for preventing overlinking when more than one post is cited.	Unknown	optional
Date format	`df`	Valid values: dmy, dmy-all, mdy, mdy-all	Unknown	optional