Type Attribute

Type of archive to retrieve. The following values are accepted by the type attribute:

• daily
• weekly
• monthly
• yearly (default)
• decade
• postbypost
• alpha

Daily

[archives type="daily"/]

Weekly

[archives type="weekly"/]

Monthly

[archives type="monthly"/]

Yearly (default)

[archives type="yearly"/]

Post By Post

[archives type="postbypost"/]

Alpha

[archives type="alpha"/]

Alpha vs Post-by-Post

The alpha and postbypost archive types both display a list of post titles instead of dates. The difference between alpha and postbypost is that alpha orders the archive by post title and postbypost orders by post date.

Limit Attribute

The limit attribute controls the number of results displayed.

Example

[archives limit="2"/]

Order Attribute

The order attribute controls the sort order of all post types except alpha and postbypost. Valid values are DESC and ASC. Descending (DESC) is the default value.

Example

[archives type="yearly" order="ASC"/]

Alpha Order Attribute

By default alpha lists are displayed A->Z ascending. To reverse the order of alpha archive type the alpha_order attributes must be set to DESC.

Examples

[archives type="alpha" limit="3"]

[archives type="alpha" alpha_order="DESC" limit="3"]

Post Order Attribute

By default postbypost archive types are displayed by date, newest to oldest descending. To change the order of an postbypost archive type the post_order attributes must be set to ASC.

Examples

[archives type="postbypost" limit="3"]

[archives type="postbypost" post_order="ASC" limit="3"]

Post Type Attribute

List archives by a custom post type. Default is ‘post’.

Example

[archives limit="3" post_type="monkey"/]

Format Attribute

The format to display the archive list. Default value is ‘html’. Valid values for the format attribute are:

• html – (default) display the archive as an unordered list using li tags
• option – display the archive as a select or drop-down form element
• link – display the archive as an unordered list using link tags
• custom – display a custom list using the before and after attributes

Example

[archives format="option"/]

See WordPress codex for more detail on format parameters.

Before Attribute

Text to place before the link when using html or custom format options. There is no default.

Example

[archives type="yearly" limit="3" before="archives for: "/]

After Attribute

Text to place after the link when using html or custom format options. There is no default.

Example

[archives type="yearly" limit="3" after=" was a good year"/]

Select Text Attribute

The select_text attribute is used to change the default text that is displayed as the default selected value when using the option format.

Example

[archives limit="5" format="option" select_text="Choose Wisely"/]

Showcount Attribute (depreciated)

This attribute has been depreciated, use the show_post_count attribute instead.

Show Post Count Attribute

Display the number of posts in an archive. For use with all archive types except ‘alpha’ and ‘postbypost’. Valid values are:

• 1 (true)
• 0 (false) – default

Examples

[archives limit="3" show_post_count="true"/]

[archives limit="3" show_post_count="1"/]

Tag Attribute

Controls the list type to be use in ‘html’ and ‘link’ type archives. Any valid HTML tag may be used.

• ol – ordered list
• ul – unordered list (default)
• div – useful for block-type archives

[archives limit="3" tag="ol"/]