Template:doi/doc

This template produces a simple, standardized link to a source from the source's digital object identifier (DOI). The DOI is rendered using much of the same code that renders |doi= in Citation Style 1 and Citation Style 2 templates except that this template can be used to render multiple DOIs.

Usage

This template accepts these parameters:

|idn= – a DOI identifier; the |idn= parameter name is not required but is recommended for clarity when the template has multiple DOIs

|doi-broken-daten= – for use when the doi specified with |idn= does not link to the identified source; enumerators required for second and subsequent DOI identifiers

|doi-accessn= – accepts a single value free; for use when the doi at |idn= is free-to-read; enumerators required for second and subsequent DOI identifiers; DOI identified sources are assumed to be paywall protected

|link= – accepts a single value no; for use when it is the 'doi:' prefix in the rendering should not be linked

|plainlink= – accepts a single value yes; suppresses the 'doi:' prefix in the rendering

|leadout= – defines the conjunction between the last two identifiers in the rendered list; defaults to ,

The basic form is:

{{doi|id=10.1016/j.coi.2004.08.001}} → doi:10.1016/j.coi.2004.08.001

For multiple DOIs:

{{doi|10.1038/380707a0|10.1038/36382}} → doi:10.1038/380707a0, 10.1038/36382

When the DOI is freely-accessible, tag it as free with |doi-access=free

{{doi|10.1080/00295450.2017.1384269|doi-access=free}} → doi:10.1080/00295450.2017.1384269

To unlink the prefix:

{{doi|id=10.1016/j.coi.2004.08.001|link=no}} → doi:10.1016/j.coi.2004.08.001

To suppress the prefix:

{{doi|id=10.1016/j.coi.2004.08.001|plainlink=yes}} → 10.1016/j.coi.2004.08.001

To use and between the last two identifiers in the rendered list:

{{doi|10.1038/380707a0|10.1038/36382|leadout=and}} → doi:10.1038/380707a0 and 10.1038/36382

When this template emits an error message for a valid (working) DOI, use the accept-as-written markup ((..)) to suppress the error message.

For instructions on how to use Wikipedia to automatically expand a DOI into a full reference complete with article title, author(s), date, journal name, volume, issue, page numbers, etc., please see User:Citation bot/use.

Tracking categories

• Category:DOI inactive – maintenance category for subcategories named in the form Category:DOI inactive as of August 2026 – for {{doi}} templates marked with |doi-broken-daten=August 2026
• Category:Ignored DOI errors – maintenance category for {{doi}} templates using the accept-as-written markup ((..)) to suppress an error message
• Category:Unflagged free DOI – maintenance category for {{doi}} templates that should be marked with |doi-accessn=free
• Category:Pages with DOI errors – error category for {{doi}} templates that show an error message

Because this template uses the same code as cs1|2 templates, error and maintenance visibility is controlled the same way. See Help:CS1 errors § Controlling error message display.

See also

• {{doi-inline}}
• {{hdl}}
• Wikipedia:Digital Object Identifier
• Wikipedia:ISBN
• Wikipedia:ISSN
• Wikipedia:PMID
• {{bibcode}}
• {{SSRN}}

This template produces a simple, standardized link to a digital object identifier (DOI).

Template parameters

Parameter		Description	Type	Status
DOI name	1	no description Example 10.1000/xyz123	Unknown	required
id	id	no description	Unknown	optional