The default use provides post-nominals linked to the relevant article for the award. By default, the Canadian set of awards is used:
{{post-nominals|PC|CC|OBE}}
To list post-nominals without links and/or with customised linking, use |unlinked= or |list= (or |post-noms=):
|unlinked=
|list=
|post-noms=
{{post-nominals|unlinked=PC CC OBE}}
{{post-nominals|list=[[Order of the British Empire|KBE]]}}
The optional |size= parameter allows for the size of the text, as a percentage, to be changed from the template's default of 85%. As per MOS:FONTSIZE, this must be added when the template is used in infoboxes (it should be set to 100%), because infoboxes already use size-reduced text. It can be used elsewhere when there are few post-nominal letters.
|size=
Jane Smith {{post-nominals|size=100%|PC|CC|OBE}}
By default, a single space is placed between each linked post-nominal (see above). To include a comma, set |commas= (or |sep=) as "on", "true", "," etc. (without quotemarks):
|commas=
|sep=
Jane Smith, {{post-nominals|size=100%|commas=on|PC|CC|OBE}}
By default, the template links to articles on the Canadian versions of the honours indicated by the post-nominals. Please add |country=CAN anyway when Canada is wanted. To specify another country, include |country=XXX where XXX is the ISO 3166-1 alpha-3 code for that country:
|country=CAN
|country=XXX
Jane Smith {{post-nominals|country=NZL|PC|OBE}}
Currently, the countries supported are Australia (AUS); Canada (CAN); Ghana (GHA); Hong Kong (HKG); Jamaica (JAM); New Zealand (NZL); Nigeria (NGA); the United Kingdom (GBR); and South Africa (ZAR). United States (USA) is functional but blank. (See data links below.)
If country is missing and none of unlinked, list, post-noms are used then Category:Pages using Template:Post-nominals with missing parameters is added to the page.
country
unlinked
list
post-noms
Sir John Smith, {{post-nominals|country=NZL|size=100%|sep=,|GNZM|GCB|GCMG|GBE}}
Dame Jane Jones {{post-nominals|country=NZL|GNZMf|GCBf|GCMGf|GBEf}}
Joseph Jacques Jean Chrétien {{post-nominals|country=CAN|PC|OMt|CC|QC}}
John Smith {{post-nominals|country=NZL|QFSM|QPM|QPSMd|QPMd}}
Data templates for each supported country:
TemplateData for Post-nominals
Show a person's post-nominals cleanly and with links to the relevant articles.
Template parameters
This template prefers inline formatting of parameters.
Which set of awards to use, by ISO 3166-1 alpha-3 country code. By default, the Canadian set is used.
1
A post-nominal to show with a link to the relevant page.
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
sep
commas
What separator to use. By default, this uses a space; you can use commas if you wish.
size
At what size to show the list; only over-ride if appropriate.
A list of post-nominals to display without links, or with customised linking.