Jump to content

Template:FDC issue: Difference between revisions

From PhantomWiki

PhantomSteve (talk | contribs)

4 user groups
1,782 edits
VisualWikitext
Create
 
No edit summary
 
(45 intermediate revisions by the same user not shown)
Line 1: Line 1:
<includeonly>
<includeonly>
{| class="wikitable"
{| class="wikitable"
|+ First-day cover details
|+ First day cover details
|-
! FDC image
| {{#if:{{{fdc-image|}}}|[[File:{{{fdc-image}}}|frameless|500px|{{{issue-title|First day cover}}}]]|No image uploaded}}
|-
! FDC reverse image
| {{#ifeq:{{{fdc-back-image|}}}|N/A|{{Not applicable}}|{{#if:{{{fdc-back-image|}}}|[[File:{{{fdc-back-image}}}|frameless|500px|Reverse of {{{issue-title|first day cover}}}]]|No reverse image uploaded}}}}
|-
|-
! Country
! Country
Line 8: Line 14:
! Country code
! Country code
| {{{country-code|Not specified}}}
| {{{country-code|Not specified}}}
{{#if:{{{country-2|}}}|
{{!}}-
! Second country
{{!}} {{{country-2}}}
{{#if:{{{country-code-2|}}}|
{{!}}-
! Second country code
{{!}} {{{country-code-2}}}
}}
}}
|-
|-
! Issue title
! Issue title
Line 14: Line 30:
! Date of issue
! Date of issue
| {{{issue-date|Not specified}}}
| {{{issue-date|Not specified}}}
|-
! Withdrawal or invalidation date
| {{#if:{{{withdrawn-date|}}}|{{{withdrawn-date}}}|Not specified}}
{{#if:{{{quantity-sold|}}}|
{{!}}-
! Quantity sold
{{!}} {{{quantity-sold|}}}
}}
{{#if:{{{sold-out|}}}|
{{!}}-
! Sold out
{{!}} {{{sold-out|}}}
}}
|-
|-
! Stamp type
! Stamp type
Line 20: Line 49:
! Stamp subtype
! Stamp subtype
| {{{stamp-subtype|Not specified}}}
| {{{stamp-subtype|Not specified}}}
|-
! Theme or subject
| {{{theme|Not specified}}}
|-
! Text credit
| {{{text-credit|Not specified}}}
|-
! Designer or artist
| {{{designer|Not specified}}}
|-
! Printer
| {{{printer|Not specified}}}
|-
! Printing process
| {{{printing-process|Not specified}}}
|-
! Colours
| {{{colours|Not specified}}}
|-
! Paper and gum
| {{{paper-gum|Not specified}}}
|-
! Perforation
| {{{perforation|Not specified}}}
|-
! Stamp dimensions
| {{{stamp-dimensions|Not specified}}}
|-
! Issue format
| {{{issue-format|Not specified}}}
|-
! Number of stamps
| {{#var_final:stamp-count|0}}
|-
! Cover type
| {{{cover-type|Not specified}}}
|-
! Cover producer
| {{{cover-producer|Not specified}}}
|-
! Cover reference
| {{{cover-reference|Not specified}}}
|-
! Limited edition
| {{{limited-edition|No}}}
|-
! Edition limit
| {{#ifeq:{{{limited-edition|No}}}|No|{{Not applicable}}|{{{edition-limit|Not applicable}}}}}
|-
! Copy number
| {{#ifeq:{{{limited-edition|No}}}|No|{{Not applicable}}|{{{copy-number|Not applicable}}}}}
|-
! Cachet or cover design
| {{{cachet|Not specified}}}
|-
! Addressed
| {{{addressed|Not specified}}}
|-
! Postmark type
| {{{postmark-type|Not specified}}}
|-
! Postmark location
| {{{postmark-location|Not specified}}}
|-
! Postmark date
| {{{postmark-date|Not specified}}}
|-
! Postmark inscription
| {{{postmark-inscription|Not specified}}}
|-
! Postmark notes
| {{{postmark-notes|Not specified}}}
|-
! Postmark image
|
{{#if:{{{postmark-image|}}}
|[[File:{{{postmark-image}}}|frameless|300px|Main postmark for {{{issue-title|first day cover}}}]]
|No postmark image uploaded
}}
{{#if:{{{postmark-additional-image-1|}}}
|<br>[[File:{{{postmark-additional-image-1}}}|frameless|300px|Additional postmark for {{{issue-title|first day cover}}}]]
|}}
{{#if:{{{postmark-additional-image-2|}}}
|<br>[[File:{{{postmark-additional-image-2}}}|frameless|300px|Additional postmark for {{{issue-title|first day cover}}}]]
|}}
|-
! Signed
| {{{signed|No}}}
|-
! Signed by
| {{#ifeq:{{{signed|No}}}|No|{{Not applicable}}|{{{signed-by|Not applicable}}}}}
|-
! Signature details
| {{#ifeq:{{{signed|No}}}|No|{{Not applicable}}|{{{signature-details|Not applicable}}}}}
|-
! Information sheet included
| {{{information-sheet|No}}}
|-
! Information materials
| {{#ifeq:{{{information-sheet|No}}}|No|{{Not applicable}}|{{{information-materials|Not specified}}}}}
|-
! Information sheet title
| {{#ifeq:{{{information-sheet|No}}}|No|{{Not applicable}}|{{{information-sheet-title|Not specified}}}}}
|-
! Information sheet image
| {{#ifeq:{{{information-sheet|No}}}|No|{{Not applicable}}|{{#if:{{{information-sheet-image|}}}|[[File:{{{information-sheet-image}}}|frameless|300px|{{{information-sheet-title|Information sheet}}} — front]]|No image uploaded}}}}
|-
! Information sheet reverse image
| {{#ifeq:{{{information-sheet|No}}}|No|{{Not applicable}}|{{#ifeq:{{{information-sheet-back-image|}}}|No|{{Not applicable}}|{{#if:{{{information-sheet-back-image|}}}|[[File:{{{information-sheet-back-image}}}|frameless|300px|{{{information-sheet-title|Information sheet}}} — reverse]]|No reverse image uploaded}}}}}}
|-
! Information sheet notes
| {{#ifeq:{{{information-sheet|No}}}|No|{{Not applicable}}|{{{information-sheet-notes|None}}}}}
|-
! Certificate of authenticity included
| {{{authenticity-certificate|No}}}
|-
! Certificate of authenticity image
| {{#ifeq:{{{authenticity-certificate|No}}}|No|{{Not applicable}}|{{#if:{{{authenticity-certificate-image|}}}|[[File:{{{authenticity-certificate-image}}}|frameless|300px|Certificate of authenticity for {{{issue-title|first day cover}}} — front]]|No image uploaded}}}}
|-
! Certificate of authenticity reverse image
| {{#ifeq:{{{authenticity-certificate|No}}}|No|{{Not applicable}}|{{#if:{{{authenticity-certificate-back-image|}}}|[[File:{{{authenticity-certificate-back-image}}}|frameless|300px|Certificate of authenticity for {{{issue-title|first day cover}}} — reverse]]|No reverse image uploaded}}}}
|-
|-
! FDC owned
! FDC owned
| {{{fdc-owned|No}}}
| {{{fdc-owned|No}}}
|-
! Condition
| {{{condition|Not specified}}}
|-
! Collection Comment
| {{{collection-comment|None}}}
|}
|}
{{Collection image notice}}
{{#ifeq:{{NAMESPACE}}||
[[Category:First day covers]]
[[Category:First day covers by issue date|{{#if:{{{issue-date|}}}|{{#iferror:{{#time:Ymd|{{{issue-date}}}}}|99999999}}|99999999}} {{PAGENAME}}]]
{{#if:{{{issue-date|}}}|
{{#iferror:{{#time:Ymd|{{{issue-date}}}}}||
[[Category:First day covers issued in the {{#expr:floor({{#time:Y|{{{issue-date}}}}} / 10) * 10}}s|{{#time:Ymd|{{{issue-date}}}}} {{PAGENAME}}]]
}}
}}
{{#ifeq:{{{fdc-owned|No}}}|Yes|
[[Category:First day covers owned]]
|
[[Category:First day covers wanted]]
{{#if:{{#ifeq:{{{country|}}}|Isle of Man|1|}}{{#ifeq:{{{country-2|}}}|Isle of Man|1|}}|
[[Category:Isle of Man first day covers wanted|{{#if:{{{issue-date|}}}|{{#iferror:{{#time:Ymd|{{{issue-date}}}}}|99999999}}|99999999}} {{PAGENAME}}]]
}}
}}
{{#if:{{{country|}}}|[[Category:{{{country}}} first day covers]]}}
{{#if:{{{country-2|}}}|
{{#ifeq:{{{country-2}}}|{{{country|}}}||
[[Category:{{{country-2}}} first day covers]]
}}
}}
{{#if:{{{year|}}}|[[Category:First day covers issued in {{{year}}}]]}}
{{#if:{{{year|}}}|[[Category:{{{year}}} stamps and first day covers]]}}
{{#if:{{{country|}}}|[[Category:{{{country}}} stamps and first day covers]]}}
{{#if:{{{country-2|}}}|
{{#ifeq:{{{country-2}}}|{{{country|}}}||
[[Category:{{{country-2}}} stamps and first day covers]]
}}
}}
{{#ifeq:{{{limited-edition|No}}}|Yes|[[Category:Limited-edition first day covers]]|}}
{{#if:{{{copy-number|}}}|[[Category:Individually numbered first day covers]]|}}
}}
</includeonly>
</includeonly>
<noinclude>
<noinclude>
This template displays the principal details of a first-day-cover issue.
This template displays the principal details of a first day cover issue.


== Usage ==
== Usage ==
Line 32: Line 222:
<pre>
<pre>
{{FDC issue
{{FDC issue
|fdc-image=Example-FDC.jpg
|fdc-back-image=
|country=Isle of Man
|country=Isle of Man
|country-code=IM
|country-code=IM
|country-2=
|country-code-2=
|issue-title=Example issue
|issue-title=Example issue
|issue-date=15 September 2026
|issue-date=15 September 2026
|withdrawn-date=
|quantity-sold=
|sold-out=
|year=2026
|stamp-type=Commemorative
|stamp-type=Commemorative
|stamp-subtype=Commemorative stamps
|stamp-subtype=Commemorative stamps
|fdc-owned=Yes
|theme=
|text-credit=
|designer=
|printer=
|printing-process=
|colours=
|paper-gum=
|perforation=
|stamp-dimensions=
|issue-format=
|cover-type=
|cover-producer=
|cover-reference=
|limited-edition=No
|edition-limit=
|copy-number=
|cachet=
|addressed=
|postmark-type=
|postmark-location=
|postmark-date=
|postmark-inscription=
|postmark-notes=
|postmark-image=IM-Example-Issue-2026-postmark.jpg
|postmark-additional-image-1=
|postmark-additional-image-2=
|signed=No
|signed-by=
|signature-details=
|information-sheet=Yes
|information-materials=Double-sided information card
|information-sheet-title=Example issue information card
|information-sheet-image=IM-Example-Issue-2026-information-card-front.jpg
|information-sheet-back-image=IM-Example-Issue-2026-information-card-back.jpg
|information-sheet-notes=
|authenticity-certificate=No
|authenticity-certificate-image=
|authenticity-certificate-back-image=
|fdc-owned=No
|condition=
|collection-comment=
}}
}}
</pre>
</pre>
The number of stamps is calculated automatically from the uses of [[Template:FDC stamp row]] later on the page.
FDC articles in the main namespace are automatically added to [[:Category:First day covers]] and to country-specific categories based on <code>country</code> and, when supplied, <code>country-2</code>.
Use the full plain-text country names in <code>country</code> and <code>country-2</code>. Country codes belong in <code>country-code</code> and <code>country-code-2</code>.
Leave <code>country-2</code> and <code>country-code-2</code> blank for a single-country cover. Both secondary rows are hidden when <code>country-2</code> is blank. The second country code row is also hidden when its code is blank.
A cover with two countries appears once in the chronological, year and decade listings. It appears in the appropriate categories for both countries.
Wanted covers are automatically added to [[:Category:Isle of Man first day covers wanted]] when either <code>country</code> or <code>country-2</code> is exactly <code>Isle of Man</code>. Covers with <code>fdc-owned=Yes</code> are excluded.
Set <code>fdc-owned</code> to exactly <code>Yes</code> or <code>No</code>. This automatically places the article in either [[:Category:First day covers owned]] or [[:Category:First day covers wanted]].
The <code>year</code> parameter places the page in the appropriate first day covers by year category.
For <code>fdc-back-image</code>, enter a filename without the File: prefix, or exactly <code>N/A</code> when the reverse has no content to document and no reverse image will be provided. N/A displays through [[Template:Not applicable]]. Leave the field blank when a reverse image is unknown or has not yet been supplied.
The <code>withdrawn-date</code> parameter records withdrawal from sale or invalidation for postage of the '''stamps''', rather than the physical cover. Where both dates are known, include both with explanatory labels. If stamps on the cover have different dates, identify the relevant stamps beside each date. Leave the field blank if unknown; the table will display “Not specified”. Record dates or descriptive statements about stocks selling out in <code>sold-out</code>. Selling out does not establish formal withdrawal from sale or invalidation for postage.
The <code>quantity-sold</code> parameter records a supported numeric quantity sold, such as <code>350,000</code>. It must not be substituted with a quantity printed or an edition limit. Leave it blank if unknown; its row will be hidden. Explain in the page text whether the quantity describes the cover product, a stamp set, the entire stamp issue or a particular stamp, and cite the source.
The <code>sold-out</code> parameter accepts either a supported date, such as <code>1 January 2000</code>, or descriptive text, such as <code>Soon after issue.</code>. Leave it blank if unknown; its row will be hidden. Explain which stamp or cover product the statement describes, preserve any relevant sales-outlet qualification, and cite the source. Where individual stamps have different quantities sold or sold-out dates, describe them separately in the page text rather than forcing them into one summary value.
Examples:
<pre>
|withdrawn-date=1 March 1972 (invalidated for postage)
</pre>
<pre>
|withdrawn-date=31 August 1966 (withdrawn from sale); 1 March 1972 (invalidated for postage)
</pre>
== Fields that do not apply ==
The following fields automatically display {{Not applicable}} when their controlling parameter is set to exactly <code>No</code>:
* <code>limited-edition=No</code>: <code>edition-limit</code> and <code>copy-number</code>.
* <code>signed=No</code>: <code>signed-by</code> and <code>signature-details</code>.
* <code>information-sheet=No</code>: <code>information-materials</code>, <code>information-sheet-title</code>, <code>information-sheet-image</code>, <code>information-sheet-back-image</code> and <code>information-sheet-notes</code>.
* <code>authenticity-certificate=No</code>: <code>authenticity-certificate-image</code> and <code>authenticity-certificate-back-image</code>.
Leave dependent parameters blank when they do not apply. The template generates the N/A display automatically, overriding any supplied dependent value when the controlling parameter is <code>No</code>. Do not enter N/A or a template call in filename parameters.
For other controlling values, the existing display behaviour is retained. A controlling parameter supplied with a blank value does not trigger the N/A display. An omitted controlling parameter uses this template's existing default of <code>No</code>.
For <code>information-sheet-back-image</code>, enter a filename without the File: prefix, or exactly <code>No</code> when no reverse image is applicable, for example when the reverse is blank or unprinted. This displays N/A through [[Template:Not applicable]]. Leave the field blank when the reverse is unknown or an image is still awaited.
An information sheet with no applicable reverse image still uses <code>information-sheet=Yes</code>.
== TemplateData ==
<templatedata>
{
"description": "Displays the details of a first day cover and its associated stamp issue.",
"params": {
"fdc-image": {
"label": "FDC image",
"description": "Filename of the main first day cover image, without the File: prefix.",
"type": "wiki-file-name"
},
"fdc-back-image": {
"label": "FDC reverse image",
"description": "Filename of the reverse image, without the File: prefix. Enter N/A when the reverse has no content to document and no reverse image will be provided. Leave blank if unknown or not yet supplied.",
"type": "string"
},
"country": {
"label": "Country",
"description": "Issuing country or postal authority.",
"type": "string",
"example": "Isle of Man",
"required": true
},
"country-code": {
"label": "Country code",
"description": "Two-letter country code used in stamp identifiers.",
"type": "string",
"example": "IM",
"required": true
},
"country-2": {
            "label": "Second country",
            "description": "Optional second issuing country represented by stamps on this cover. Use its full plain-text name, such as Gibraltar or Isle of Man. Leave blank for a single-country cover; the row is hidden.",
            "type": "string",
            "example": "Gibraltar",
            "default": "",
            "required": false
        },
        "country-code-2": {
            "label": "Second country code",
            "description": "Optional two-letter code for the second country, in the same form as country-code. Its row appears only when country-2 and this value are both supplied. Leave blank for a single-country cover.",
            "type": "string",
            "example": "GI",
            "default": "",
            "required": false
        },
"issue-title": {
"label": "Issue title",
"description": "Official or descriptive title of the stamp issue.",
"type": "string",
"required": true
},
"issue-date": {
"label": "Date of issue",
"description": "Date on which the stamps and first day cover were issued.",
"type": "string",
"example": "15 September 2026"
},
"withdrawn-date": {
"label": "Withdrawal or invalidation date",
"description": "Date when the stamps were withdrawn from sale or ceased to be valid for postage. This refers to the stamps, not the physical cover. Where both dates are known, include both with explanatory labels. Identify individual stamps if their dates differ. Leave blank if unknown.",
"type": "string",
"example": "1 March 1972 (invalidated for postage)"
},
"quantity-sold": {
            "label": "Quantity sold",
            "description": "Supported numeric quantity sold, with thousands separators if appropriate. This is not a quantity printed or an edition limit. Leave blank if unknown; the row is hidden. Cite the source and explain the product or variant scope in the page text.",
            "type": "string",
            "example": "350,000",
            "required": false
        },
        "sold-out": {
            "label": "Sold out",
            "description": "Supported date or descriptive statement about stocks selling out. This does not establish formal withdrawal or invalidation. Leave blank if unknown; the row is hidden. Cite the source and explain the product or outlet scope in the page text.",
            "type": "string",
            "example": "Soon after issue.",
            "required": false
        },
"year": {
"label": "Year of issue",
"description": "Four-digit year of issue. This places the page in the corresponding first day covers by year category.",
"type": "number",
"example": "2021",
"required": true
},
"stamp-type": {
"label": "Stamp type",
"description": "General classification, such as Commemorative or Definitive.",
"type": "string"
},
"stamp-subtype": {
"label": "Stamp subtype",
"description": "More specific classification of the issue.",
"type": "string"
},
"theme": {
"label": "Theme or subject",
"description": "Overall theme or subject of the stamp issue.",
"type": "string"
},
"text-credit": {
"label": "Text credit",
"description": "Person or organisation responsible for the written text accompanying the stamp issue.",
"type": "string",
"example": "Ted Cummings, Cloud PR"
},
"designer": {
"label": "Designer or artist",
"description": "Designer, illustrator, artist or photographer responsible for the issue.",
"type": "string"
},
"printer": {
"label": "Printer",
"description": "Company or organisation that printed the stamps.",
"type": "string"
},
"printing-process": {
"label": "Printing process",
"description": "Printing method, such as lithography, intaglio or photogravure.",
"type": "string"
},
"colours": {
"label": "Colours",
"description": "Number or description of colours used to print the stamp issue.",
"type": "string",
"example": "Four-colour"
},
"paper-gum": {
"label": "Paper and gum",
"description": "Paper weight, paper type and gum used for the stamps.",
"type": "string",
"example": "110 gsm paper; PVA gum"
},
"perforation": {
"label": "Perforation",
"description": "Perforation measurement for the stamps in the issue.",
"type": "string",
"example": "13 per 2 cm"
},
"stamp-dimensions": {
"label": "Stamp dimensions",
"description": "Physical dimensions of each stamp.",
"type": "string",
"example": "36 × 36 mm"
},
"issue-format": {
"label": "Issue format",
"description": "Format in which the stamps were issued, such as sheet, miniature sheet or booklet.",
"type": "string"
},
"cover-type": {
"label": "Cover type",
"description": "General type of cover, such as standard, commercial or official.",
"type": "string"
},
"cover-producer": {
"label": "Cover producer",
"description": "Postal authority, company or organisation that produced the cover.",
"type": "string"
},
"cover-reference": {
"label": "Cover reference",
"description": "Catalogue, producer or collection reference for this cover.",
"type": "string"
},
"limited-edition": {
"label": "Limited edition",
"description": "Whether the first day cover was produced as a limited edition.",
"type": "string",
"suggestedvalues": [
"Yes",
"No"
],
"default": "No"
},
"edition-limit": {
"label": "Edition limit",
"description": "Maximum number of copies produced in the limited edition.",
"type": "number",
"example": "500"
},
"copy-number": {
"label": "Copy number",
"description": "Individual number or designation assigned to this particular first day cover.",
"type": "string",
"example": "24"
},
"cachet": {
"label": "Cachet or cover design",
"description": "Description of the illustration or cachet on the cover.",
"type": "string"
},
"addressed": {
"label": "Addressed",
"description": "Whether the cover is addressed, for example Yes, No or Address label.",
"type": "string",
"suggestedvalues": [
"Yes",
"No"
]
},
"postmark-type": {
"label": "Postmark type",
"description": "Type of postmark, such as special handstamp, FDI postmark, CDS or slogan postmark.",
"type": "string"
},
"postmark-location": {
"label": "Postmark location",
"description": "Town, post office or other location shown in the postmark.",
"type": "string"
},
"postmark-date": {
"label": "Postmark date",
"description": "Date shown in the postmark.",
"type": "string"
},
"postmark-inscription": {
"label": "Postmark inscription",
"description": "Wording or slogan appearing in the postmark.",
"type": "string"
},
"postmark-notes": {
"label": "Postmark notes",
"description": "Any additional information about the cancellation or postmark.",
"type": "string"
},
"postmark-image": {
"label": "Main postmark image",
"description": "Filename of the principal postmark image, without the File: prefix.",
"type": "wiki-file-name"
},
"postmark-additional-image-1": {
"label": "Additional postmark image 1",
"description": "Filename of an optional additional postmark image, without the File: prefix.",
"type": "wiki-file-name"
},
"postmark-additional-image-2": {
"label": "Additional postmark image 2",
"description": "Filename of a second optional additional postmark image, without the File: prefix.",
"type": "wiki-file-name"
},
"signed": {
"label": "Signed",
"description": "Whether the cover has been signed.",
"type": "string",
"suggestedvalues": [
"Yes",
"No"
]
},
"signed-by": {
"label": "Signed by",
"description": "Name and role of each signer, such as artist, author or depicted subject.",
"type": "string"
},
"signature-details": {
"label": "Signature details",
"description": "Location, ink colour, authentication or other details about the signature.",
"type": "string"
},
"information-sheet": {
"label": "Information sheet included",
"description": "Whether an information sheet is included with the cover.",
"type": "string",
"suggestedvalues": [
"Yes",
"No"
]
},
"information-materials": {
"label": "Information materials",
"description": "Description of all information cards, inserts and other materials included with the cover.",
"type": "content"
},
"information-sheet-title": {
"label": "Information sheet title",
"description": "Title or description of the accompanying information sheet.",
"type": "string"
},
"information-sheet-image": {
"label": "Information sheet image",
"description": "Filename of the front of the information sheet, without the File: prefix.",
"type": "wiki-file-name"
},
        "information-sheet-back-image": {
            "label": "Information sheet reverse image",
            "description": "Filename of the reverse image, without the File: prefix. Enter exactly No when no reverse image is applicable, for example a blank or unprinted reverse. Leave blank if unknown or an image is still awaited.",
            "type": "string"
        },
"information-sheet-notes": {
"label": "Information sheet notes",
"description": "Additional information about the accompanying sheet.",
"type": "string"
},
"authenticity-certificate": {
"label": "Certificate of authenticity included",
"description": "Whether a certificate of authenticity is included with the cover.",
"type": "string",
"suggestedvalues": [
"Yes",
"No"
]
},
"authenticity-certificate-image": {
"label": "Certificate of authenticity image",
"description": "Filename of the front of the certificate of authenticity, without the File: prefix.",
"type": "wiki-file-name"
},
"authenticity-certificate-back-image": {
"label": "Certificate reverse image",
"description": "Filename of the reverse of the certificate of authenticity, without the File: prefix.",
"type": "wiki-file-name"
},
"fdc-owned": {
"label": "FDC owned",
"description": "Whether this first day cover is currently in the collection. This controls the ownership category.",
"type": "string",
"suggestedvalues": [
"Yes",
"No"
],
"default": "No",
"required": true
},
"condition": {
"label": "Condition",
"description": "Condition of the cover, including any faults or damage.",
"type": "string"
},
"collection-comment": {
"label": "Collection Comment",
"description": "Private collection details such as damage, duplicates owned or replacement requirements.",
"type": "string"
}
}
}
</templatedata>
[[Category:Philatelic templates]]
</noinclude>
</noinclude>

Latest revision as of 15:04, 4 October 2026


This template displays the principal details of a first day cover issue.

Usage

{{FDC issue
|fdc-image=Example-FDC.jpg
|fdc-back-image=
|country=Isle of Man
|country-code=IM
|country-2=
|country-code-2=
|issue-title=Example issue
|issue-date=15 September 2026
|withdrawn-date=
|quantity-sold=
|sold-out=
|year=2026
|stamp-type=Commemorative
|stamp-subtype=Commemorative stamps
|theme=
|text-credit=
|designer=
|printer=
|printing-process=
|colours=
|paper-gum=
|perforation=
|stamp-dimensions=
|issue-format=
|cover-type=
|cover-producer=
|cover-reference=
|limited-edition=No
|edition-limit=
|copy-number=
|cachet=
|addressed=
|postmark-type=
|postmark-location=
|postmark-date=
|postmark-inscription=
|postmark-notes=
|postmark-image=IM-Example-Issue-2026-postmark.jpg
|postmark-additional-image-1=
|postmark-additional-image-2=
|signed=No
|signed-by=
|signature-details=
|information-sheet=Yes
|information-materials=Double-sided information card
|information-sheet-title=Example issue information card
|information-sheet-image=IM-Example-Issue-2026-information-card-front.jpg
|information-sheet-back-image=IM-Example-Issue-2026-information-card-back.jpg
|information-sheet-notes=
|authenticity-certificate=No
|authenticity-certificate-image=
|authenticity-certificate-back-image=
|fdc-owned=No
|condition=
|collection-comment=
}}

The number of stamps is calculated automatically from the uses of Template:FDC stamp row later on the page.

FDC articles in the main namespace are automatically added to Category:First day covers and to country-specific categories based on country and, when supplied, country-2.

Use the full plain-text country names in country and country-2. Country codes belong in country-code and country-code-2.

Leave country-2 and country-code-2 blank for a single-country cover. Both secondary rows are hidden when country-2 is blank. The second country code row is also hidden when its code is blank.

A cover with two countries appears once in the chronological, year and decade listings. It appears in the appropriate categories for both countries.

Wanted covers are automatically added to Category:Isle of Man first day covers wanted when either country or country-2 is exactly Isle of Man. Covers with fdc-owned=Yes are excluded.

Set fdc-owned to exactly Yes or No. This automatically places the article in either Category:First day covers owned or Category:First day covers wanted.

The year parameter places the page in the appropriate first day covers by year category.

For fdc-back-image, enter a filename without the File: prefix, or exactly N/A when the reverse has no content to document and no reverse image will be provided. N/A displays through Template:Not applicable. Leave the field blank when a reverse image is unknown or has not yet been supplied.

The withdrawn-date parameter records withdrawal from sale or invalidation for postage of the stamps, rather than the physical cover. Where both dates are known, include both with explanatory labels. If stamps on the cover have different dates, identify the relevant stamps beside each date. Leave the field blank if unknown; the table will display “Not specified”. Record dates or descriptive statements about stocks selling out in sold-out. Selling out does not establish formal withdrawal from sale or invalidation for postage.

The quantity-sold parameter records a supported numeric quantity sold, such as 350,000. It must not be substituted with a quantity printed or an edition limit. Leave it blank if unknown; its row will be hidden. Explain in the page text whether the quantity describes the cover product, a stamp set, the entire stamp issue or a particular stamp, and cite the source.

The sold-out parameter accepts either a supported date, such as 1 January 2000, or descriptive text, such as Soon after issue.. Leave it blank if unknown; its row will be hidden. Explain which stamp or cover product the statement describes, preserve any relevant sales-outlet qualification, and cite the source. Where individual stamps have different quantities sold or sold-out dates, describe them separately in the page text rather than forcing them into one summary value.

Examples: 

|withdrawn-date=1 March 1972 (invalidated for postage)

|withdrawn-date=31 August 1966 (withdrawn from sale); 1 March 1972 (invalidated for postage)

Fields that do not apply

The following fields automatically display N/A when their controlling parameter is set to exactly No:

  • limited-edition=No: edition-limit and copy-number.
  • signed=No: signed-by and signature-details.
  • information-sheet=No: information-materials, information-sheet-title, information-sheet-image, information-sheet-back-image and information-sheet-notes.
  • authenticity-certificate=No: authenticity-certificate-image and authenticity-certificate-back-image.

Leave dependent parameters blank when they do not apply. The template generates the N/A display automatically, overriding any supplied dependent value when the controlling parameter is No. Do not enter N/A or a template call in filename parameters.

For other controlling values, the existing display behaviour is retained. A controlling parameter supplied with a blank value does not trigger the N/A display. An omitted controlling parameter uses this template's existing default of No.

For information-sheet-back-image, enter a filename without the File: prefix, or exactly No when no reverse image is applicable, for example when the reverse is blank or unprinted. This displays N/A through Template:Not applicable. Leave the field blank when the reverse is unknown or an image is still awaited.

An information sheet with no applicable reverse image still uses information-sheet=Yes.

TemplateData

Displays the details of a first day cover and its associated stamp issue.

Template parameters[Edit template data]

ParameterDescriptionTypeStatus
FDC imagefdc-image

Filename of the main first day cover image, without the File: prefix.

Fileoptional
FDC reverse imagefdc-back-image

Filename of the reverse image, without the File: prefix. Enter N/A when the reverse has no content to document and no reverse image will be provided. Leave blank if unknown or not yet supplied.

Stringoptional
Countrycountry

Issuing country or postal authority.

Example
Isle of Man
Stringrequired
Country codecountry-code

Two-letter country code used in stamp identifiers.

Example
IM
Stringrequired
Second countrycountry-2

Optional second issuing country represented by stamps on this cover. Use its full plain-text name, such as Gibraltar or Isle of Man. Leave blank for a single-country cover; the row is hidden.

Default
Example
Gibraltar
Stringoptional
Second country codecountry-code-2

Optional two-letter code for the second country, in the same form as country-code. Its row appears only when country-2 and this value are both supplied. Leave blank for a single-country cover.

Default
Example
GI
Stringoptional
Issue titleissue-title

Official or descriptive title of the stamp issue.

Stringrequired
Date of issueissue-date

Date on which the stamps and first day cover were issued.

Example
15 September 2026
Stringoptional
Withdrawal or invalidation datewithdrawn-date

Date when the stamps were withdrawn from sale or ceased to be valid for postage. This refers to the stamps, not the physical cover. Where both dates are known, include both with explanatory labels. Identify individual stamps if their dates differ. Leave blank if unknown.

Example
1 March 1972 (invalidated for postage)
Stringoptional
Quantity soldquantity-sold

Supported numeric quantity sold, with thousands separators if appropriate. This is not a quantity printed or an edition limit. Leave blank if unknown; the row is hidden. Cite the source and explain the product or variant scope in the page text.

Example
350,000
Stringoptional
Sold outsold-out

Supported date or descriptive statement about stocks selling out. This does not establish formal withdrawal or invalidation. Leave blank if unknown; the row is hidden. Cite the source and explain the product or outlet scope in the page text.

Example
Soon after issue.
Stringoptional
Year of issueyear

Four-digit year of issue. This places the page in the corresponding first day covers by year category.

Example
2021
Numberrequired
Stamp typestamp-type

General classification, such as Commemorative or Definitive.

Stringoptional
Stamp subtypestamp-subtype

More specific classification of the issue.

Stringoptional
Theme or subjecttheme

Overall theme or subject of the stamp issue.

Stringoptional
Text credittext-credit

Person or organisation responsible for the written text accompanying the stamp issue.

Example
Ted Cummings, Cloud PR
Stringoptional
Designer or artistdesigner

Designer, illustrator, artist or photographer responsible for the issue.

Stringoptional
Printerprinter

Company or organisation that printed the stamps.

Stringoptional
Printing processprinting-process

Printing method, such as lithography, intaglio or photogravure.

Stringoptional
Colourscolours

Number or description of colours used to print the stamp issue.

Example
Four-colour
Stringoptional
Paper and gumpaper-gum

Paper weight, paper type and gum used for the stamps.

Example
110 gsm paper; PVA gum
Stringoptional
Perforationperforation

Perforation measurement for the stamps in the issue.

Example
13 per 2 cm
Stringoptional
Stamp dimensionsstamp-dimensions

Physical dimensions of each stamp.

Example
36 × 36 mm
Stringoptional
Issue formatissue-format

Format in which the stamps were issued, such as sheet, miniature sheet or booklet.

Stringoptional
Cover typecover-type

General type of cover, such as standard, commercial or official.

Stringoptional
Cover producercover-producer

Postal authority, company or organisation that produced the cover.

Stringoptional
Cover referencecover-reference

Catalogue, producer or collection reference for this cover.

Stringoptional
Limited editionlimited-edition

Whether the first day cover was produced as a limited edition.

Suggested values
Yes No
Default
No
Stringoptional
Edition limitedition-limit

Maximum number of copies produced in the limited edition.

Example
500
Numberoptional
Copy numbercopy-number

Individual number or designation assigned to this particular first day cover.

Example
24
Stringoptional
Cachet or cover designcachet

Description of the illustration or cachet on the cover.

Stringoptional
Addressedaddressed

Whether the cover is addressed, for example Yes, No or Address label.

Suggested values
Yes No
Stringoptional
Postmark typepostmark-type

Type of postmark, such as special handstamp, FDI postmark, CDS or slogan postmark.

Stringoptional
Postmark locationpostmark-location

Town, post office or other location shown in the postmark.

Stringoptional
Postmark datepostmark-date

Date shown in the postmark.

Stringoptional
Postmark inscriptionpostmark-inscription

Wording or slogan appearing in the postmark.

Stringoptional
Postmark notespostmark-notes

Any additional information about the cancellation or postmark.

Stringoptional
Main postmark imagepostmark-image

Filename of the principal postmark image, without the File: prefix.

Fileoptional
Additional postmark image 1postmark-additional-image-1

Filename of an optional additional postmark image, without the File: prefix.

Fileoptional
Additional postmark image 2postmark-additional-image-2

Filename of a second optional additional postmark image, without the File: prefix.

Fileoptional
Signedsigned

Whether the cover has been signed.

Suggested values
Yes No
Stringoptional
Signed bysigned-by

Name and role of each signer, such as artist, author or depicted subject.

Stringoptional
Signature detailssignature-details

Location, ink colour, authentication or other details about the signature.

Stringoptional
Information sheet includedinformation-sheet

Whether an information sheet is included with the cover.

Suggested values
Yes No
Stringoptional
Information materialsinformation-materials

Description of all information cards, inserts and other materials included with the cover.

Contentoptional
Information sheet titleinformation-sheet-title

Title or description of the accompanying information sheet.

Stringoptional
Information sheet imageinformation-sheet-image

Filename of the front of the information sheet, without the File: prefix.

Fileoptional
Information sheet reverse imageinformation-sheet-back-image

Filename of the reverse image, without the File: prefix. Enter exactly No when no reverse image is applicable, for example a blank or unprinted reverse. Leave blank if unknown or an image is still awaited.

Stringoptional
Information sheet notesinformation-sheet-notes

Additional information about the accompanying sheet.

Stringoptional
Certificate of authenticity includedauthenticity-certificate

Whether a certificate of authenticity is included with the cover.

Suggested values
Yes No
Stringoptional
Certificate of authenticity imageauthenticity-certificate-image

Filename of the front of the certificate of authenticity, without the File: prefix.

Fileoptional
Certificate reverse imageauthenticity-certificate-back-image

Filename of the reverse of the certificate of authenticity, without the File: prefix.

Fileoptional
FDC ownedfdc-owned

Whether this first day cover is currently in the collection. This controls the ownership category.

Suggested values
Yes No
Default
No
Stringrequired
Conditioncondition

Condition of the cover, including any faults or damage.

Stringoptional
Collection Commentcollection-comment

Private collection details such as damage, duplicates owned or replacement requirements.

Stringoptional
Retrieved from "https://wiki.k-e.org.uk/index.php?title=Template:FDC_issue&oldid=1767"