Template:Official website/doc

The purpose of this template is to provide a standard format for labeling links to the official website of an article's main topic.

Basic usage
This template can be used without specifying any parameters, if the "official website" Property (P856) is set in the respective article's Wikidata record. Just add to the article's External links section. If on Wikidata more than one official website is given, the entry tagged with the language being English is automatically preferred.

Advanced usage
Two parameters are available:
 * or  or   is used to specify the URL. If this parameter is omitted, the value of "official website" Property (P856) on Wikidata is used.
 * NOTE: If this parameter is specified and doesn't match "official website" Property (P856) on Wikidata, the page is added to Category:Official website different in Wikidata and Wikipedia for maintenance.
 * If this parameter is specified but the "official website" Property (P856) on Wikidata has not been set, the page is added to Category:Official website not in Wikidata for maintenance.
 * If this parameter is not specified and there is no official website available on Wikidata, the page is added to Category:Official website missing URL.
 * or  is used to reformat the title if "Official website" is not suitable.
 * NOTE: This name should succinctly and accurately describe the external link in relation to the subject. In particular, it should not include the article subject's name as the reader reasonably expects that all external links pertain to the subject.

Some URLs that contain special characters, such as  or , will break the template. The solution is to prepend the URL with

URL in template
To the right of each example is the displayed output. Below each example is the actual output including tags.

URL in Wikidata
Usage in the article Amazon (company):
 * → OOjs UI icon edit-ltr-progressive.svg   Official website  OOjs UI icon edit-ltr-progressive.svg

Note: If Wikidata holds two or more values in different languages, websites in English will be preferred. The module also prefers websites with a "preferred" Wikidata rank. If multiple websites are otherwise equally ranked in the module's criteria, the module will choose the website listed first.

No URL in template or Wikidata
Usage on any page without a URL in Wikidata property :

TemplateData
{	"description": "This template provides a standard format for labeling links to official websites, stating \"Official website\" with the website linked. If no parameters are set in this template, the template will use the official website entered into Wikidata, if available.", "params": { "1": {			"label": "URL", "aliases": [ "url", "URL" ],			"description": "Leave this blank if using a URL entered into Wikidata. If there is no Wikidata URL or to override the Wikidata URL, entering a URL in this field will cause the template to link to this entered field. ", "type": "url", "required": false, "default": "Wikidata property P856", "example": "https://example.com" },		"name": { "label": "Display text", "description": "If left blank, the template text will display the words \"Official website\" with the URL linked to it. This field should usually be left blank. If there another webpage that could reasonably understood as the official website and needs to be distinguished from the link in this template, replacement text can displayed by entering it into this field.  ", "type": "string", "required": false, "example": "Publisher's website", "default": "Official website", "aliases": [ "2"			]		}	},	"paramOrder": [ "1",		"name" ] }

Tracking categories
One of the following categories may be added to articles using this template (via Module:Official website):

Handling dead links
It's possible that a URL no longer references hosted content, or ends up hosting different content than intended. In this case, the should be replaced with an invocation of  with a   parameter of "Official website". For example:. Such an invocation appears as: