Template:BillboardURLbyName/doc

This is a documentation subpage for Template:BillboardURLbyName.
It may contain usage information, categories and other content that is not part of the original template page.

This template is used on approximately 9,400 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 returns a billboard.com URL for an artist's history on a particular chart.

Examples

Code	Output	Comments
`{{BillboardURLbyName\|artist=Carly Rae Jepsen\|chart=hsi}}`	https://www.billboard.com/artist/carly-rae-jepsen/chart-history/hsi	Links to the Billboard Hot 100 chart
`{{BillboardURLbyName\|artist=Carly Rae Jepsen\|chart=tsl}}`	https://www.billboard.com/artist/carly-rae-jepsen/chart-history/tsl	Links to the Top Album Sales chart
`{{BillboardURLbyName\|artist=carly rae jepsen\|chart=TSL}}`	https://www.billboard.com/artist/carly-rae-jepsen/chart-history/tsl	Equivalent to above. Artist and chart are case insensitive.
`{{BillboardURLbyName\|artist=Carly Rae Jepsen\|chart=all}}`	https://www.billboard.com/artist/carly-rae-jepsen/chart-history/	`\|chart=all` links to Billboard's "main" chart for the given artist (in this case, the Hot 100).
`{{BillboardURLbyName\|artist=Carly Rae Jepsen}}`	https://www.billboard.com/artist/carly-rae-jepsen	Billboard's landing page for this artist, including their chart history, and recent news and videos relating to the artist. Content at this URL is liable to drift over time. Not recommended.

Usage

This template is normally used within citations, e.g.

Markup

Renders as

It reached no. 32 on the ''Billboard'' Mainstream Rock Airplay chart.<ref>{{cite web | url={{BillboardURLbyName|artist=the breeders|chart=rtt }} | title=The Breeders Chart History |access-date=2007-07-31 | work=[[Billboard (magazine)|Billboard]]}}</ref>

It reached no. 32 on the Billboard Mainstream Rock Airplay chart.^[1]

^ "The Breeders Chart History". Billboard. Retrieved 2007-07-31.

Notes

For the URL to work correctly the chart name needs to be the three letter code of the chart. For example, hsi is the Hot 100 chart.
The artist name used by Billboard may not match Wikipedia's naming. Be especially mindful of artists whose names contain special characters. For example, an article about a song by P!nk needs to use {{BillboardURLbyName|artist=pnk|chart=hsi}} to match Billboard's url scheme. Billboard is also inconsistent about the use of a leading "The" in a band's name. For this reason, it's usually a good idea to test any urls generated by this template before adding them to an article.

TemplateData

Generates billboard.com URLs for the chart history of a given artist.

Template parameters
Parameter		Description	Type	Status
Artist name	`artist`	The name of the artist, as it appears in billboard.com URLs Example The White Stripes	String	required
Chart name	`chart`	Three letter code for the Billboard chart Example hsi	String	suggested
bio	`bio`	Deprecated. No effect.	String	deprecated

[1] "The Breeders Chart History". Billboard. Retrieved 2007-07-31.

[1]