Template:External media/doc

When to use
If an image, 3D model, audio or video clip:


 * 1) is currently available online,
 * 2) cannot be uploaded to Wikipedia, even under non-free use rules,  and
 * 3) readers will expect this type of media in the article,

then it may be appropriate to use external media to provide a direct link to the media file along with a description of the media.

The external media template should be removed as soon as a replacement of adequate quality and accuracy is available in WP:COMMONS. At that time, the link included in this template may be considered for inclusion as a regular WP:External link in the ==External links== section.

Copyright
According to WP:ELNEVER and WP:COPYLINK, editors must never link to content that violates copyright or is otherwise illegal. If you are uncertain of the copyright status (for example, with links to YouTube), ask for help at Media copyright questions. If you're certain that the copyright status is acceptable, but others might wonder later, make it clear in the template or in the reference that you link to material from a rightful distributor (examples can be found at grindcore).

Where to use
This template is normally placed in the main body of the article, in the same place that you would normally have placed the image, 3D model, audio, or video clip if it had been available on Wikimedia Commons.

When placing links in the ==External links== section, please use the normal formatting for external links, as explained at WP:External links and WP:External links, rather than this template.

Usage
Paste this into your article, removing the parameters that are left blank:

The external media template can be used multiple times in an article, and each instance can be used to link to more than one file.

Parameters

 * float: Valid options are "left" or "right". The template defaults to displaying on the right-hand-side. (Note: This template's documentation previously, and erroneously, listed align as a valid parameter, but it was not valid. Instances of align, if found, should usually be replaced with float.)
 * width: This should be a complete width measurement including units. Examples:,  ,  . The template defaults to 258px wide.
 * topic: Optional text field that will appear above the media links.
 * title: Optional text to replace the automatically calculated title.
 * headerimage: Optional image to display at the top of the template. Use full image syntax, for example example.png.
 * caption: Optional caption text to put underneath the header image.
 * media links: Each file to be linked should specify its type and have a different number, starting from 1. For example, a template containing four images and one video would label them as,  ,  ,   and  . The attribute has a free format, so any amount of detail may be added. The first part of the entry should be formatted as a normal external link, i.e. Image description for Image description. After that, any additional detail can be given on the same line. See the examples for details.
 * Note: when adding a link to an external media source like this, it is essential that the source page be linked too with the date of retrieval, both to satisfy Wikipedia's sourcing criteria for the statement about the presented media and to ensure that the link can quickly be corrected should the source URL be changed. Reference tags can be used for this purpose.

{	"params": { "width": { "description": "Width of the box", "example": "300px, 22em, 30%", "default": "258px" },		"float": { "type": "string", "suggestedvalues": [ "left", "right", "center" ],			"description": "Alignment of the box on the page", "suggested": true, "default": "right" },		"title": { "description": "Optional text to replace the automatically calculated title" },		"image1": {}, "audio1": {}, "video1": {}, "model1": {}, "image2": {}, "model2": {}, "topic": { "description": "Optional text field that will appear above the media links" },		"headerimage": { "description": "Optional image to display at the top of the template. Use full image syntax, for example .", "type": "unbalanced-wikitext" },		"caption": { "description": "Optional caption text to put underneath the header image" },		"image3": {}, "image4": {}, "image5": {}, "image6": {}, "image7": {}, "image8": {}, "image9": {}, "image10": {}, "image11": {}, "image12": {}, "image13": {}, "image14": {}, "image15": {}, "image16": {}, "image17": {}, "image18": {}, "image19": {}, "image20": {}, "audio2": {}, "audio3": {}, "audio4": {}, "audio5": {}, "audio6": {}, "audio7": {}, "audio8": {}, "audio9": {}, "audio10": {}, "audio11": {}, "audio12": {}, "audio13": {}, "audio14": {}, "audio15": {}, "audio16": {}, "audio17": {}, "audio18": {}, "audio19": {}, "audio20": {}, "video2": {}, "video3": {}, "video4": {}, "video5": {}, "video6": {}, "video7": {}, "video8": {}, "video9": {}, "video10": {}, "video11": {}, "video12": {}, "video13": {}, "video14": {}, "video15": {}, "video16": {}, "video17": {}, "video18": {}, "video19": {}, "video20": {}, "model3": {}, "model4": {}, "model5": {}, "model6": {}, "model7": {}, "model8": {}, "model9": {}, "model10": {}, "model11": {}, "model12": {}, "model13": {}, "model14": {}, "model15": {}, "model16": {}, "model17": {}, "model18": {}, "model19": {}, "model20": {} },	"description": "Provides a box with a direct link to media hosted off of Wikipedia", "paramOrder": [ "title", "topic", "caption", "image1", "audio1", "video1", "model1", "width", "float", "headerimage", "image2", "model2", "image3", "image4", "image5", "image6", "image7", "image8", "image9", "image10", "image11", "image12", "image13", "image14", "image15", "image16", "image17", "image18", "image19", "image20", "audio2", "audio3", "audio4", "audio5", "audio6", "audio7", "audio8", "audio9", "audio10", "audio11", "audio12", "audio13", "audio14", "audio15", "audio16", "audio17", "audio18", "audio19", "audio20", "video2", "video3", "video4", "video5", "video6", "video7", "video8", "video9", "video10", "video11", "video12", "video13", "video14", "video15", "video16", "video17", "video18", "video19", "video20", "model3", "model4", "model5", "model6", "model7", "model8", "model9", "model10", "model11", "model12", "model13", "model14", "model15", "model16", "model17", "model18", "model19", "model20" ] }

Just an image
Image taken from the War against Nabis Featured Article. This example gives full contextual information along with references.