Template:doi
 | This template is used on approximately 28,000 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 template uses Lua: |
 | The link in this template goes to a redirect page instead of to the article that is the target of the redirect. This redirect link is intentional so that links using the template are distinguishable from links to the article on the Special:WhatLinksHere/Digital object identifier page. |
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 valuefree; 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 valueno; for use when it is the 'doi:' prefix in the rendering should not be linked|plainlink=– accepts a single valueyes; 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 2025– for{{doi}}templates marked with|doi-broken-daten=August 2025 - 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:PMID
- Wikipedia:ISSN
- {{bibcode}}
- {{PII}}
- {{SSRN}}
This template produces a simple, standardized link to a digital object identifier (DOI).
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| DOI name | 1 | no description
| Unknown | required |
| id | id | no description | Unknown | optional |