Usage

edit

This template is mainly used in conjunction with {{Infobox historic site}}, which is of interest to WikiProject Historic sites. This template tells the infobox how to display designations by passing along either a color or some text, which are dependent on the designation. The template is set up, however, so that anyone can use it as a stand-alone template to create tables, lists, and other articles throughout Wikipedia. The following is an explanation of how to use this template as a stand-alone template:

Template syntax

{{Designation|<designation>|<identifier>}}

  • <designation> – tells the template which designation to use. (i.e. "NRHP", "World Heritage Site", "NYCL", etc.) This parameter is case-insensitive, so "world heritage site" will yield the same thing as "WoRlD HeRiTaGe SiTe". All supported designations are listed below.
  • <identifier> – can be either of the following values:
    • colour (or color) – will return a hex code for the official color of <designation>
    • text – will return a link to the article talking about <designation>
    • divbox - will generate a bordered div block element version, consisting of the link to the article talking about <designation> (this is useful in various templates that use the {{Infobox}}}

Examples:

  • {{Designation/colour|World Heritage Site}} yields " #FFE978"
  • {{Designation/text|Grade I}} yields "Listed Building – Grade I"
  • {{Designation/divbox|National Historic Site of Canada}} yields:

Supported designations

edit

Global designations

edit
Designation Bordered version Scope Count Valid <designation> values (Callnames)
UNESCO World Heritage Site Global 874 World Heritage Site; WHS
IUCN Category Ia (Strict Nature Reserve) Global ??? IUCN Category Ia; IUCN Ia; Category Ia; Nature Reserve
IUCN Category Ib (Wilderness Area)
IUCN Category Ib (Wilderness Area)
Global ??? IUCN Category Ib; IUCN Ib; Category Ib; Wilderness Area
IUCN Category II (National Park)
IUCN Category II (National Park)
Global ??? IUCN Category II; IUCN II; Category II; National Park
IUCN Category III (Natural Monument)
IUCN Category III (Natural Monument)
Global ??? IUCN Category III; IUCN III; Category III; Natural Monument
IUCN Category IV (Habitat/Species Management Area)
IUCN Category IV (Habitat/Species Management Area)
Global ??? IUCN Category IV; IUCN IV; Category IV; Habitat Management; Species Management
IUCN Category V (Protected Landscape/Seascape)
IUCN Category V (Protected Landscape/Seascape)
Global ??? IUCN Category V; IUCN V; Category V; Protected Landscape; Protected Seascape
IUCN Category VI (Managed Resource Protected Area)
IUCN Category VI (Managed Resource Protected Area)
Global ??? IUCN Category VI; IUCN VI; Category VI; Managed Resource Protected Area
Ramsar Wetland Global ??? Ramsar; Ramsar Wetland; Ramsar Wetland of International Importance
Historic Civil Engineering Landmark Global 263 Civil Engineering Landmark; Historic Civil Engineering Landmark; HCEL
Historic Mechanical Engineering Landmark Global 259 Mechanical Engineering Landmark; Historic Mechanical Engineering Landmark; HMEL

National/regional designations

edit
Designation Bordered version Scope Count Valid <designation> values (Callnames)
Cultural Monument of Albania Albania 201 Cultural Monument of Albania; Albanian Cultural Monument; Albania; Monument Kulture
National Historic Monument of Argentina Argentina ~400 National Historic Monument of Argentina; Argentina Historic Monument; Argentina; NHMA
Australian National Heritage List Australia ???? Australian national heritage list; Australia; ANHL
Commonwealth Heritage List Australia ???? Commonwealth heritage list; Australian Commonwealth heritage list; Commonwealth; CWLTHL
Register of the National Estate Australia ???? Register national estate; register of the national estate; Australian register of the national estate; RNE
List of Old Dhaka Heritage Sites Bangladesh ???? Old Dhaka Heritage Sites; Old Dhaka
KONS of Bosnia and Herzegovina Bosnia and Herzegovina 921 KONS
National Historic Heritage of Brazil Brazil 1,047 National Historic Heritage of Brazil; Brazilian Historic Heritage; IPHAN; Brazil; NHHB
National Historic Site of Canada Canada 958 National Historic Site of Canada; Canadian National Historic Site; Canada; National Historic Site; NHSC; NHS
Heritage Railway Station (Canada) Canada 163 Heritage Railway Station of Canada; Canadian Heritage Railway Station; HRSC
Major cultural heritage sites under national-level protection China 5058 Major Historic and Cultural Site Protected at the National Level (China)
Protected Natural Value of Croatia Croatia 461 Protected Natural Value of Croatia; Croatian Protected Natural Value; Protected area of Croatia; Croatian Protected area; Croatia Natural; Spomenik prirode
Cultural Good of Croatia Croatia ??? Cultural Good of Croatia; Croatian Cultural Good; Croatia Cultural; Spomenik kulture
National Cultural Monument of the Czech Republic Czech Republic 384 National Cultural Monument of the Czech Republic; Czech National Cultural Monument
Monument historique France >43,000 Monument historique; France; French
Cultural Heritage Monument of Georgia Georgia ??? Cultural Heritage Monument of Georgia; კულტურული მემკვიდრეობის ძეგლი
Immovable Cultural Monument of National Significance of Georgia Georgia ??? Immovable Cultural Monument of National Significance of Georgia; ეროვნული მნიშვნელობის კატეგორიის კულტურის უძრავი ძეგლი
Monument of National Importance India >3000 Monuments of National Importance (India); Monument of National Importance (India); Monuments of National Importance; Monument of National Importance; MANI
National monument of Ireland Ireland ~1,000 Irish National Monument; National Monument of Ireland; Ireland Monument in State Care; Irish Monument in State Care; Ireland; Irish
National Treasure of Japan Japan 1079 National Treasure of Japan; Japanese National Treasure; Japan
Rijksmonument Netherlands 55,000+ Rijksmonument; Dutch National Monument; Netherlands National Monument; National Monument of the Netherlands; Netherlands; Dutch
Heritage New Zealand – Category 1 New Zealand ??? Heritage New Zealand Category I; New Zealand Category I; NZ Category I
Heritage New Zealand – Category 2 New Zealand ??? Heritage New Zealand Category II; New Zealand Category II; NZ Category II
National Cultural Treasures Philippines 50> PHILIPPINES CULTURAL TREASURES; PHILIPPINES TREASURES; PNCT
National Historical Landmarks
National Historical Landmarks
Philippines 50> Philippines National Historic Landmarks; PNHL
Historic Monument of Poland Poland 129 Historic Monument of Poland
Portuguese National Monument Portugal 791 National Monument of Portugal; Portuguese National Monument; Monumento Nacional do Portugal; Portugal; IPPAR
Monument istoric Romania 29,540 National Register of Historic Monuments in Romania; Monument istoric; Romania; Romanian
Cultural Heritage of Serbia Serbia 2,391 Cultural Heritage of Serbia; Serbia; Serbian
Invalid designation
Invalid designation
Sierra Leone ??? List of National Monuments of Sierra Leone
National monument of Singapore Singapore ??? National Monument of Singapore; Singapore National Monument; Singapore
Historic Sites of South Korea South Korea ???? Historic Sites of South Korea; Historic Sites of the Republic of Korea; South Korea
Spanish Cultural Heritage Spain ~13,000 Spanish Property of Cultural Interest; Bien de Interés Cultural; BIC; Spain; Spanish
Natura 2000 site (SAC) European Union ??? Special Area of Conservation; SAC
Natura 2000 site (SPA) European Union ??? Special Protection Area; SPA
Natura 2000 site (SAC/SPA) European Union ??? Special Protection Area Special Area of Conservation; Special Area of Conservation Special Protection Area; SPA SAC; SAC SPA
Invalid designation
Invalid designation
Sri Lanka ??? Sri Lanka
Swiss Cultural Property of National Significance Switzerland ??? Swiss Cultural Property of National Significance; Swiss; Switzerland; Swiss Cultural Property
National monument of Taiwan Taiwan 106 National Monument of Taiwan; Taiwan National; TWN
National Historic Sites of Tanzania Tanzania ???? NATIONAL HISTORIC SITE OF TANZANIA; NATIONAL HISTORIC SITES OF TANZANIA; TANZANIAN NATIONAL MONUMENT; TANZANIAN CULTURAL HERITAGE; TANZANIAN HISTORIC LANDMARK; TANZANIA; NHST
National Monument of Zambia Zambia >3000 National Monument of Zambia; Zambian National Monument; Zambia
United Kingdom
edit
Designation Bordered version Scope Count Valid <designation> values (Callnames)
Scheduled monument United Kingdom 19,763 Scheduled Monument; Scheduled Ancient Monument; Ancient Monument; UK Scheduled Monument; UK Ancient Monument; Scheduled Historic Monument; UK Monument in State Care; UK Scheduled Ancient Monument; UK Scheduled Historic Monument
Listed Building United Kingdom >500,000 Listed Building; United Kingdom Listed Building; UK Listed Building
Listed Building – Grade I
Listed Building – Grade I
England & Wales 9,445 Grade I Listed Building; Grade I; United Kingdom Grade I; UK Grade I
Listed Building – Grade II*
Listed Building – Grade II*
England & Wales 22,164 Grade II* Listed Building; Grade II*; United Kingdom Grade II*; UK Grade II*
Listed Building – Grade II
Listed Building – Grade II
England & Wales 345,662 Grade II Listed Building; Grade II; United Kingdom Grade II; UK Grade II
Listed Building – Grade A
Listed Building – Grade A
Northern Ireland ??? Grade A Listed Building; Grade A; Northern Ireland Grade A
Listed Building – Grade B+
Listed Building – Grade B+
Northern Ireland ??? Grade B+ Listed Building; Grade B+; Northern Ireland Grade B+
Listed Building – Grade B1
Listed Building – Grade B1
Northern Ireland ??? Grade B1 Listed Building; Grade B1; Northern Ireland Grade B1
Listed Building – Grade B2
Listed Building – Grade B2
Northern Ireland ??? Grade B2 Listed Building; Grade B2; Northern Ireland Grade B2
Listed Building – Category A
Listed Building – Category A
Scotland ??? Category A Listed Building; Category A; Scotland Category A
Listed Building – Category B
Listed Building – Category B
Scotland ??? Category B Listed Building; Category B; Scotland Category B
Listed Building – Category C(S)
Listed Building – Category C(S)
Scotland ??? Category C Listed Building; Category C; Scotland Category C
Registered battlefield United Kingdom ??? NHLE Battlefields; UK Registered Battlefields
UK Protected Wreck United Kingdom >100 UK Protected Wreck; UK Maritime Military Grave; UK Historic Wreck; NHLE Wreck
UK Conservation Area England >10,000 England Conservation Area; English Conservation Area
Locally Listed Building United Kingdom >20,000 UK Locally Listed; Local Listed Site UK; Locally Listed Building
National Heritage List for England England >650,000 NHLE; NHLE List; NHLE Register; National Heritage List for England
National Register of Historic Parks and Gardens England 1600 Historic garden; register of historic parks and gardens; historic parks and gardens; England registered parks and gardens
Inventory of Gardens and Designed Landscapes in Scotland Scotland ~386 Inventory of Gardens and Designed Landscapes in Scotland; Gardens and Designed Landscapes in Scotland; Inventory of Gardens and Designed Landscapes
Cadw/ICOMOS Register of Parks and Gardens of Special Historic Interest in Wales Wales ~400 Cadw/ICOMOS Register of Parks and Gardens of Special Historic Interest in Wales; Registered historic parks and gardens in Wales
United States
edit
Designation Bordered version Scope Count Valid <designation> values (Callnames)
U.S. National Register of Historic Places United States >80,000 National Register of Historic Places; NRHP
U.S. National Historic Landmark United States ~2,450 National Historic Landmark; U.S. National Historic Landmark; US National Historic Landmark; NRHP-NHL; NHL
U.S. Historic district United States ??? United States Historic District; U.S. Historic District; US Historic District; Historic District; NRHP-HD; HD
U.S. Historic district
Contributing property
United States ??? United States Contributing Property; U.S. Contributing Property; US Contributing Property; Contributing Property; NRHP-CP; CP
U.S. National Historic Landmark District United States ~200 U.S. National Historic Landmark District; US National Historic Landmark District; National Historic Landmark District; NRHP-NHLD; NHLD
U.S. National Monument United States 93 U.S. National Monument; US National Monument; National Monument; NRHP-NMON; NMON
U.S. National Historic Site United States 89 U.S. National Historic Site; US National Historic Site; National Historic Site; NRHP-NHS; NHS
U.S. National Memorial United States 44 U.S. National Memorial; US National Memorial; National Memorial; NRHP-NMEM; NMEM
U.S. National Historical Park United States 42 U.S. National Historical Park; US National Historical Park; National Historical Park; NRHP-NHP; NHP
U.S. National Battlefield United States 11 U.S. National Battlefield; US National Battlefield; National Battlefield; NRHP-NB; NB
U.S. National Military Park United States 9 U.S. National Military Park
U.S. National Natural Landmark United States ??? U.S. National Natural Landmark; US National Natural Landmark; National Natural Landmark; NNL
National Wild and Scenic River United States ??? National Wild and Scenic Rivers System; NWSRS; National Wild and Scenic River; NWSR

State/provincial/local designations

edit
See wp:HSITESHELP for tips
In Australia
edit
Designation Bordered version Scope Count Valid <designation> values (Callnames)
Invalid designation
Invalid designation
Australia - Australian Capital Territory 415

Australian Capital Territory Heritage Register; Australian Capital Territory; ACTHR

New South Wales Heritage Register Australia - New South Wales 1,724 New South Wales state heritage register; NSW state heritage register; New South Wales heritage register; NSW heritage register; NSW; NSW shr
Invalid designation
Invalid designation
Australia - Northern Territory 675

Northern Territory Heritage Register; Northern Territory; NTHR

Queensland Heritage Register Australia - Queensland 1,692 Queensland Heritage Register; QHR
South Australian Heritage Register Australia - South Australia 2,326

South Australian heritage register; SA heritage register; South Australia; SAHR

Tasmanian Heritage Register Australia - Tasmania 11,970

Tasmanian heritage register; Tasmania; TASHR

Victorian Heritage Register Australia - Victoria ~2,300

Victorian heritage register; Victoria (state); VICHR

Western Australia Heritage Register Australia - Western Australia 2,367 Western Australia state register of heritage places; WA state register of heritage places; WASRHP; Western Australia
Designation Bordered version Scope Count Valid <designation> values (Callnames)
Brisbane Heritage Register Australia - Queensland - Brisbane 2,309 Brisbane heritage register; Brisbane (Australia); BHR
New South Wales Heritage Database
(Local Government Register)
New South Wales Heritage Database
(Local Government Register)
Australia - New South Wales 1,747 New South Wales Heritage Database; NSW Heritage Database; NSWHD; NSW HD
In Canada
edit
Designation Bordered version Scope Count Valid <designation> values (Callnames)
Alberta Historic Resources Act Canada - Alberta ??? Alberta Historic Resources Act; Alberta; AHRA
New Brunswick Heritage Conservation Act Canada - New Brunswick ??? New Brunswick Heritage Conservation Act; New Brunswick; NBHCA
Nova Scotia Heritage Property Act Canada - Nova Scotia ??? Nova Scotia Heritage Property Act; Nova Scotia; NSHPA
Ontario Heritage Act Canada - Ontario ??? Ontario Heritage Act; Ontario
Prince Edward Island Heritage Place Canada - Prince Edward Island ??? Prince Edward Island; PEI; Heritage Places Protection Act
Patrimoine culturel du Québec Canada - Quebec ??? Repertoire du Patrimoine Culturel du Quebec; Quebec; Cultural Heritage Register of Quebec
Saskatchewan Heritage Property Act Canada - Saskatchewan 800+ Saskatchewan Heritage Property Act; Saskatchewan; SHPA
In China - Hong Kong
edit
Designation Bordered version Scope Count Valid <designation> values (Callnames)
Declared Monument of Hong Kong ChinaHong Kong 92 Declared Monument of Hong Kong; Hong Kong Declared Monument; HK Declared Monument
Hong Kong Graded Building ChinaHong Kong 1,154 Hong Kong Graded Building; HK Graded Building; Graded Building
Hong Kong Graded BuildingGrade I China - Hong Kong 212 Hong Kong Grade I Historic Building; Hong Kong Grade I; HK Grade I
Hong Kong Graded BuildingGrade II China - Hong Kong 366 Hong Kong Grade II Historic Building; Hong Kong Grade II; HK Grade II
Hong Kong Graded BuildingGrade III China - Hong Kong 576 Hong Kong Grade III Historic Building; Hong Kong Grade III; HK Grade III
In the United States
edit
Designation Bordered version Scope Count Valid <designation> values (Callnames)
Alabama Register of Landmarks and Heritage United StatesAlabama 1,396 Alabama Register; Alabama Landmark; Alabama; USAL; ARLH
California Historical Landmark United StatesCalifornia >1,000 California Historical Landmark; California; CHISL
Colorado State Register of Historic Properties United States - Colorado >1700 Colorado State Register of Historic Properties; Colorado; CSRHP; USCO
D.C. Inventory of Historic Sites United StatesDistrict of Columbia ~750 District of Columbia Inventory of Historic Sites; D.C. Inventory of Historic Sites; DCIHS
Hawaiʻi Register of Historic Places United StatesHawaii 1,504 Hawaiʻi Register of Historic Places; Hawaii Register of Historic Places; Hawaiʻi; Hawaii; USHI
Indiana Register of Historic Sites United States - Indiana ~1900 Indiana Register of Historic Sites and Structures; Indiana; IRHSS; USIN
Michigan State Historic Site United StatesMichigan 2,730 Michigan State Historic Site; Michigan; MSHS
Mississippi Landmark United StatesMississippi 890 Mississippi Landmark; Mississippi; USMS
Nevada Historical Marker United States - Nevada 266 Nevada Historical Marker; Nevada Marker; Nevada; USNV
NH State Register of Historic Places United States - New Hampshire ~200 New Hampshire State Register of Historic Places; New Hampshire State Register; New Hampshire; NHSR; NHSRHP; USNH
New Jersey Register of Historic Places United States - New Jersey ??? New Jersey Register of Historic Places; New Jersey; NJRHP; USNJ
New York State Register of Historic Places United States - New York ??? New York State Register of Historic Places; New York; New York State; NYSRHP; USNY
NM State Register of Cultural Properties United States - New Mexico ~2,000 N.M. State Register of Cultural Properties; New Mexico State Register; New Mexico; NMSRCP; NMSR; USNM
Pennsylvania Historical Marker United StatesPennsylvania >2,000 Pennsylvania Historical Marker; Pennsylvania; PA Marker
Recorded Texas Historic Landmark United States - Texas 3,779 Recorded Texas Historic Landmark; Texas; RTHL; USTX
Texas State Antiquities Landmark United States - Texas 352 Texas State Antiquities Landmark; Texas; TSAL; USTX
Virginia Landmarks Register United States - Virginia ??? Virginia Landmarks Register; Virginia; VLR; USVA
  • Cities in the United States of America
Designation Bordered version Scope Count Valid <designation> values (Callnames)
Albuquerque Historic Landmark United StatesNew MexicoAlbuquerque 20 Albuquerque Historic Landmark; Albuquerque; ALBHL
Baltimore City Landmark United StatesMarylandBaltimore 206 Baltimore City Landmark; Baltimore; BCL
Berkeley Landmark United StatesCaliforniaBerkeley ~350 Berkeley Landmark; Berkeley; BERKL
Chicago Landmark United StatesIllinoisChicago ~200 Chicago Landmark; Chicago; CHICL
Dallas Landmark United StatesTexasDallas 100 Dallas Landmark; Dallas
Davenport Register of Historic Properties United StatesIowaDavenport ~50 Davenport Register of Historic Properties; Davenport; DRHP
Long Beach Historic Landmark United StatesCaliforniaLong Beach 114 Long Beach Historic Landmark; Long Beach; LBHL
Los Angeles Historic-Cultural Monument United StatesCaliforniaLos Angeles 886 Los Angeles Historic-Cultural Monument; Los Angeles Historic Cultural Monument; Los Angeles; LAHCM
New York City Landmark United StatesNew YorkNew York City ~2,600 New York City Landmark; NYC Landmark; New York City; NYC; NYCL
Oakland Designated Landmark United StatesCaliforniaOakland ~200 Oakland Designated; Oakland; ODL
Omaha Landmark United StatesNebraskaOmaha ~100 Omaha Landmark; Omaha
Oyster Bay Landmark United StatesNew YorkOyster Bay 40 Oyster Bay Landmark; Oyster Bay, New York; Oyster Bay, NY; Oyster Bay
Philadelphia Register of Historic Places United StatesPennsylvaniaPhiladelphia ??? Philadelphia Register of Historic Places; Philadelphia; PRHP
Pittsburgh Historic Designation United StatesPennsylvaniaPittsburgh >100 Pittsburgh Historic Designation; City of Pittsburgh; PGHL; CPHD
Pittsburgh Landmark – PHLF United StatesPennsylvaniaPittsburgh 66 Pittsburgh Historic Landmark; Pittsburgh Landmark; Pittsburgh; PHLF
Riverside Landmark United StatesCaliforniaRiverside ~110 Riverside Landmark; Riverside; RIVL
St. Louis Landmark United StatesMissouriSt. Louis 121 St. Louis Landmark; St Louis Landmark; St. Louis; St Louis
San Diego Historic Landmark United StatesCaliforniaSan Diego ~870 San Diego Historic Landmark; San Diego; SDHL
San Francisco Designated Landmark United StatesCaliforniaSan Francisco ~250 San Francisco Designated Landmark; San Francisco Landmark; San Francisco; SFDL
Santa Monica Historic Landmark United StatesCaliforniaSanta Monica ~90 Santa Monica Historic Landmark; Santa Monica; SMHL
Invalid designation
Invalid designation
United StatesCaliforniaWindsor ~10? Windsor Historic Landmark;WINDSORHL
Seattle Landmark United StatesWashingtonSeattle ~450 Seattle Landmark; Seattle
Cincinnati Local Historic Landmark United StatesOhioCincinnati 71 Cincinnati Local Historic Landmark; Cincinnati Landmark; Cincinnati; CLHL
Columbus Register of Historic Properties United StatesOhioColumbus 77 Columbus Register of Historic Properties; Columbus Register; Columbus; CRHP
In other countries
edit
Designation Bordered version Scope Count Valid <designation> values (Callnames)
Basque Cultural Heritage SpainBasque Country >11,000 Basque Cultural Heritage; Basque Country; Basque
Yangon City Landmark MyanmarYangon 188 Yangon City Heritage List; Yangon City Landmark; Yangon Landmark; Yangon City; Yangon


Adding new designations

edit

If you've created or contributed to a list-article or individual property articles of a designation or heritage register not listed above, you can suggest its addition to the template. To suggest a new designation for inclusion in this template, raise a question or open an edit request on this template's talk page.

Requirements

edit

In order for a register to be added to this template, there are several criteria that must be met:

  1. The register must be an official designation consisting of a reasonable number of sites. If a designation covers only a small community and contains only a handful of sites, it's probably not necessary to add it to this template.
  2. There must be an article about the register on Wikipedia, and there should be at least an external link to a list of all sites on the register. Ideally, there should be a list article on Wikipedia containing links to all articles about sites on that register.
  3. The register's scope must be identified. What exactly can become listed on this register? Is it confined to a small area such as a city or municipality? Perhaps a state or province? Or maybe even an entire nation or many nations? A designation can be classified as "Global", meaning any site in any nation can qualify, "National/regional", meaning only sites in a particular nation or group of nations (i.e. the United Kingdom or North America) can qualify, "State/provincial", meaning only sites in a particular region of a country (i.e. a state in the United States or an emirate in the United Arab Emirates) may qualify, or "Local", meaning only sites in a specific city, neighborhood, or community may qualify.
  4. Text and a color scheme must be chosen for the designation. This template allows an editor freedom over the background color of the designation's bar in {{Infobox historic site}} as well as the text color. The text of the bar will link to the main article of the register in some way, and should contain sufficient information to uniquely identify the register.
  5. Valid callnames must be chosen for the designation. Callnames are valid values for the <designation> parameter described at the top of this page. Callnames are unique to an individual register, so if another similar designation contains callnames that may conflict with the new register, some reconciliation will be needed (i.e. if Switzerland maintains two national designations and one is already in this template using the callname "Switzerland", that callname must be taken out to remove ambiguity before the second designation is added).

Through discussion, determine a color scheme for the designation and which text will appear in the infobox bar. Also, determine callnames, identifying any ambiguities or overlap between designations. Once the text, the color, and the callname(s) have been discussed, the designation can be incorporated into this template. Below are a few guidelines on how to choose these identifiers.

Color selection

edit

While it's desirable for the colors to be related to the designation, accessibility is our first concern. Some users of Wikipedia may be fully or partially color blind, and certain color combinations can be hard for them to see. It may be necessary to modify the colors a little to accommodate these users; for more information see Wikipedia:Color.

In general, very light colors are preferred in order to have adequate contrast between the text and the background. The following colors are all acceptable choices:

#FFE978 #DACAA5 #CDE5B2 #BFFFBF #B2E5CD #A5CADA #A8BDEC #FFC0CB

The bordered div box versions (as used on {{Infobox historic site}}) do not have these accessibility issues, and thus use a different color palette.

Callname selection

edit

In choosing callnames (valid <designation> values), choose names that are generally associated with the designation – not personal preferences (i.e. don't choose "My Hometown," "Family Vacation Spot," etc.). Be sure to include many different variations on word order (If you include "Canadian National Historic Site" then include "National Historic Site of Canada" as well). Callnames are case-insensitive, so there is no need for various capitalization changes.

You may use abbreviations, but use abbreviations that make sense. For Atlanta Landmarks, "AL" wouldn't be good because it may be confused with landmarks in Alabama; something like "ATL" would be better because more potential readers would associate that with Atlanta. For smaller cities it is wise to include country or state names too (such as "Oyster Bay, New York") because people are more likely to use state names than for larger, more well-known cities.

Care must also be taken to avoid overlap or ambiguity in choosing callnames. Common practice in this template's designations is to include the nation, state, or city's name as a potential callname for that designation. If a nation, state, or city maintains more than one historic register, though, things can get messy. When adding a new designation, check first to make sure that no other designations use the callnames you wish to attach to the new designation. If you were adding a new national designation for Switzerland, you would notice that the designation already in the template (Swiss Cultural Properties of National Significance) uses the callname "Switzerland". Since your new designation would also be a national designation of Switzerland, the "Switzerland" callname should be removed from the old designation, making sure to update any articles using that callname, before the new designation is added to the template.

Text selection

edit
Be sure to provide adequate information to uniquely identify the designation.

When selecting the text that will be shown in the infobox bar, be sure to provide enough information to uniquely identify the designation. Many registers in this template are very similar, and some may even overlap in scope (i.e. a single area may be covered by more than one register). Make sure when selecting the text that will display in the designation's bar that enough information is given to remove all ambiguity. If you were adding a register about the National monuments of Singapore, you couldn't simply choose "National Monument" for the text bar because almost every single country contains its own national monuments. Generally a good idea is to include the nation, region, or area covered by the register in the text. Instead of "State Landmark", the text should read "California Landmark" or something similar.

The list article to which the text will point can be helpful in identifying the register, though it should not be a primary identifier. A reader should be able to read the text of the bar and know immediately which register the infobox is talking about. Secondary information such as intricacies of scope, requirements of addition, and explanations of labels (Grade I, Category C, Type IV, etc.) should be explained in the list article but not the text bar. While adequate information is needed in the text bar, make sure not to be overly descriptive so as not to overwhelm the infobox. If the bar's text takes up more than two lines, you should probably think about shortening it.

Adding new designations: instructions for template editors

edit

The template is split up into three major code blocks:

To incorporate the designation's color into the template, find the appropriate scope-level (Global, national/regional, state/provincial, or local) section of the "color" block of code. The section is alphabetized according to scope. Nation names are in alphabetical order, followed by states or provinces, followed by cities.

The format of each entry is

|CALLNAME ONE|CALLNAME TWO|ADDITIONAL CALLNAMES
|WRAPPED CALLNAMES IF NECESSARY                 = #nnnnnn

where "#nnnnnn is the hexadecimal color code in standard CSS notation.

Once this is done, repeat the procedure for the alternate colour template.

The text codes in Template:Designation/text use the same format (and the code from the color designations can be copy/pasted as a starting point), but instead of a color code, the equals sign at the end of each set of callnames is followed by a text string to be displayed in the infobar. This text, as discussed above, should contain a link to the register's main list article.

Documenting new supported designations

edit

In addition to adding the color/text to the main template, the documentation at Template:Designation/Supported designations must be updated to list the new designation. You can either ask someone at Wikipedia talk:WikiProject Historic sites to update the "Supported designations" page or update it yourself.

To add your designation to the page, you'll have to find the correct scope-based subpage. If you want to add a global designation, append "/Global" to the end of the article name (i.e. Template:Designation/Supported designations/Global); for national/regional designations, it's /National; and for state/provincial and local/municipal designations, it's /State.

Once you've navigated to the correct subpage, simply click the edit button and add a new table row in the correct alphabetical order based on descending order of scope. (So if you were adding New York State Landmarks, and Alabama/Ohio were already there, you would add New York between the two. If there was a Hong Kong landmark, it would be even before Alabama because "China" starts with C and "United States" starts with U.)

The simplest method of creating a new row is to copy/paste a pre-existing row and edit that. For more information on Wikipedia Tables, see Help:Table.

Don't change anything in the first column except the designation call.

Change the former designation callname to one of your designation's callnames in both the "color" and "text" locations.

The next cell is the scope of the designation. Scopes are generally in Country – State/province – City/municipality, etc. form, so for the New York State example, you would not just type "New York"; you would type "United States – New York" and for Hong Kong, you would type "China – Hong Kong."

The next column is the approximate count of sites having that designation. No sources are needed on this list since the count will more than likely appear on the main article for that designation, a requirement to be supported by this infobox.

The final cell is a list of all callnames that can be used to call that designation. You can copy and paste the callnames from the main template, but be sure to separate them by semicolons instead of leaving the vertical pipes, and make sure not to leave them in all caps.

After you have added the new row, save the page with the same edit summary used when you updated the main template.