A page with <ref> tags but no reference list markup used to display an error, except on talk and user pages. In recent versions of Wikipedia, the error no longer appears; instead an automatically generated reference list (AGRL) is displayed at the bottom of the page.

Compared to the reference lists on properly formatted pages, an AGRL can be confusing to both readers and editors. But it is easily corrected by adding the proper reference list markup.

When is an AGRL displayed?[edit]

An AGRL is displayed whenever a page contains "reference markup" but no "reference list markup".

As shown in the following table, "reference markup" includes <ref>...</ref> tags and templates containing information meant to be displayed in a reference list (footnote section) near the bottom of the page.
"Reference list markup" is either a <references /> tag or a ((reflist)) template, both of which indicate the position on the page where the reference list should be displayed.

Reference markup Reference list markup
Tags  <ref>...</ref>

Templates
((harv)), ((harvnb)),
((sfn)), ((sfnb)), etc.

Tag  <references />

Template
((reflist))

If there is no reference list markup to indicate where the reference list should appear, an AGRL is generated and appears at the very bottom of the page.

Disadvantages of AGRLs[edit]

In former versions of the Wikipedia software, an error message was displayed if a page contained reference markup but no reference list markup. AGRLs are arguably an improvement, because footnotes are at least displayed somewhere on the page. However, compared to properly formatted pages, AGRLs suffer from a number of disadvantages.

For these reasons, it is recommended that the AGRL not be relied on. Proper reference list markup should always be added.

What to do if an AGRL is displayed[edit]

In most cases, it is sufficient to add reference list markup such as the following. This will display a header and the reference list at the position where it should appear.

==References==
((reflist))

On talk pages, the ((reflist-talk)) template can be used to add a reference list to a specific discussion.

The template should be added at the end of the section that contains the reference markup which is causing the AGRL to be displayed. The reference list will be displayed within a bordered box.

==Section 1==

((reflist-talk))
==Section 2==

Bugs[edit]

AGRLs were introduced on Wikipedia with the deployment of MediaWiki 1.24wmf12 on July 10, 2014. Since then, the following bugs have been identified. They are a further reason why proper reference list markup should always be included.

See also[edit]