Template:Infobox holiday/doc

The {{Infobox holiday}} template adds an infobox with data fields for defining a particular festival or other day of observance.

Usage

{{Infobox holiday
| holiday_name  = required
| type          = required
| image         =
| imagesize     =
| caption       =
| official_name =
| nickname      =
| observedby    =
| litcolor      =
| longtype      =
| significance  =
| begins        =
| ends          =
| date          =
| scheduling    = <!-- e.g. "same day each year" -->
| duration      = <!-- e.g. "1 day", "1 week" -->
| frequency     = <!-- e.g. "Annual", "Every 4 years", "Once" -->
<!-- Use next three if holiday is the same day of the same week every year -->
| week_ordinal  = <!-- "first", "second", "last", etc. -->
| weekday       = <!-- "Sunday", "Monday", "Friday", etc. -->
| month         = <!-- "January", "February", "December", etc. -->
<!-- Use next four if the date changes in an unusual pattern each year -->
| date2023      = <!-- only for days that change each year -->
| date2024      = <!-- only for days that change each year -->
| date2025      = <!-- only for days that change each year -->
| date2026      = <!-- only for days that change each year -->
| celebrations  =
| observances   =
| relatedto     =
}}

For an annual holiday occurring on the same day each year:

{{Infobox holiday
| holiday_name  = Template Day
| type          = 
| image         =
| imagesize     =
| caption       =
| official_name =
| nickname      =
| observedby    =
| litcolor      =
| longtype      =
| significance  =
| begins        =
| ends          =
| date          = 30 February
| scheduling    = same day each year
| duration      = 1 day
| frequency     = Annual
| celebrations  =
| observances   =
| relatedto     =
}}

Parameters

Required

holiday_name

This is the most common holiday name, which appears at the top of the infobox. It should almost always be the name of the article.

type

The type of the holiday, for example: national, Judaism, Islamic, etc. The type parameter has this relation:

Type (param "type")	Color
islam, islamic	LightGreen
judaism, juda, jewish, jew	LightSkyBlue
buddhism, buddhist, buddha	PaleGoldenRod
christian, christ, christianity	Lavender
asian, asian festival	RosyBrown
secular	DarkGray
national, international, local, group	LightViolet
historical, cultural, patriotic, ethnic	LightSalmon
pagan	DarkKhaki
commercial	Yellow
hindu, hinduism	Orange
shinto, shintoism	Light red
default	LightSteelBlue

begins

required for multi-day holidays - This is the starting date for a multi-day holiday.

ends

required for multi-day holidays - This is the ending date for a multi-day holiday.

date

required for single-day holidays - This is the date of a single-day holiday. (If you use the week_ordinal/weekday/month parameters below, date will default to a phrase like "First Sunday in January". Otherwise it has no default and is required.). Specific phrases for other rules are decoded in Template:Infobox holiday/date. Sample: "first Thursday after 18 April". If no value is given, the value of d:Property:P837 of the holiday's Wikidata item is displayed instead.

date2024

highly recommended for holidays that don't stay on the same Gregorian date - This is the Gregorian date on which the holiday will occur in 2024. At the end of 2024, this will be replaced with date2025, which will later be replaced with date2026. Therefore, it's a good idea to specify the Gregorian date for a few future years. (Not necessary if week_ordinal/weekday/month are specified instead.)

Optional

image

This should be an image that represents the holiday. The value is just the simple target-name, not a full wikilink.

imagesize

The size of the image (default is 225px).

caption

This is a caption that describes the image.

official_name

This should contain the official name of the holiday if it is not the holiday_name; this can also be the name of the holiday in its original language

nickname

This should hold any nicknames, alternatives, and translations for the holiday_name or official_name

observedby

highly recommended - These are the people who celebrate/observe the holiday (e.g. Muslims and Islam, United States, people worldwide)

litcolor

This is the liturgical color of the day, if applicable to a religious holiday; or other color which is applicable to the holiday (e.g. green for Saint Patrick's Day)

longtype

This is a lengthier description of the type, for example if there are two types that could be defined, for example "Cultural, Historical, Islamic"

significance

This is a lengthier description of the holiday's significance

scheduling

define the how the date varies (not displayed). Sample value: "same day each year"

duration

time the holiday or observance last. Sample values: "1 day", "1 week", "3 days"

frequency

the frequency with which the holiday or observance re-occurs. Sample values: "Annual", "Weekly", "Monthly"

week_ordinal, weekday, month

For days that are observed on the same day of the same week every year, these specify the week (week_ordinal), day of the week (weekday), and month. If you use these, you no longer have to specify date2023, date2024, date2025 and date2026. If you specify week_ordinal, then weekday and month are required also.

date2023, date2025, date2026

recommended for holidays that don't stay on the same Gregorian date - The template will display the previous and next year's dates along with that of the current year, if they are provided. Again, it's a good idea to provide dates for a few years further into the future as well. (Not necessary if week_ordinal/weekday/month are specified instead.)

mdy

if set to a non-blank value, auto-formatted dates will be displayed in "month day, year" format instead of the default "day month year" order.

firsttime

first time/year the holiday was observed (if available)

lasttime

last time/year the holiday was observed (if no longer observed)

celebrations

This contains the celebrations that occur on the holiday.

observances

This contains essentially the same thing as the celebrations attribute. However, the word observances is used. This may be more appropriate than celebrations when referring to prayer or more solemn observances. Most likely, you will not need both celebrations and observances.

relatedto

This contains holidays that relate to the current holiday.

Examples

Same date every year

{{Infobox holiday | image = | caption = Fireworks at the [[Eiffel Tower]], [[Paris]], 2017 | holiday_name = Bastille Day | nickname = French National Day<br />(''Fête nationale'')<br />The Fourteenth of July<br />(''Quatorze juillet'') | significance = Commemorates the [[Storming of the Bastille]] on 14 July 1789, and the unity of the French people at the [[Fête de la Fédération]] on 14 July 1790 | observedby = [[France]] | date = 14 July | frequency = annual | celebrations = [[Military parade]]s, [[fireworks]], concerts, [[Ball (dance)|ball]]s | type = national }}

Bastille Day Also called French National Day (Fête nationale) The Fourteenth of July (Quatorze juillet) Observed by France Type National Significance Commemorates the Storming of the Bastille on 14 July 1789, and the unity of the French people at the Fête de la Fédération on 14 July 1790 Celebrations Military parades, fireworks, concerts, balls Date 14 July Frequency annual

Same day of same week every year

{{Infobox holiday | holiday_name = Astronauts Day | type = secular | observedby = United States | week_ordinal = last | weekday = Friday | month = January }}

Astronauts Day Observed by United States Type Secular Date Last Friday in January 2023 date January 27  (2023-01-27) 2024 date January 26  (2024-01-26) 2025 date January 31  (2025-01-31) 2026 date January 30  (2026-01-30)

Different days and dates each year

{{Infobox holiday | holiday_name = Giving Tuesday | type = cultural | duration = 1 day | frequency = annual | observedby = Worldwide | date = Tuesday after Black Friday/Cyber Monday | date2020 = December 1 | date2021 = November 30 | date2022 = November 29 | date2023 = November 28 | relatedto = [[Thanksgiving (United States)|Thanksgiving]], [[Black Friday (shopping)|Black Friday]] }}

Giving Tuesday Observed by Worldwide Type Cultural Date Tuesday after Black Friday/Cyber Monday 2023 date November 28 Frequency annual Related to Thanksgiving, Black Friday

Formulas for calculating occurrences

Sample formulas used in Template:Infobox holiday/date:

• For First Day of Summer: first Thursday after 18 April:

  {{Weekday after date|{{{year}}}|April|18|Thursday}}

  See also: Template:Weekday after date

• For Victoria Day (Scotland): last Monday before or on 24 May

  {{Weekday before date|{{{year}}}|May|25|Monday}}

  See also: Template:Weekday before date

• For Sexagesima: second Sunday before Ash Wednesday (56 calendar days before Easter Sunday)

  {{#invoke:Easter|Calculate|{{{year}}}|day=-56|format=F j}}

  See also: Module:Easter

For some holidays, this is still defined on the holiday page itself. For First Day of Summer, this would be:

| date                     = first Thursday after 18 April
| date{{LASTYEAR}}         = {{Weekday after date|{{LASTYEAR}}|April|18|Thursday}}
| date{{CURRENTYEAR}}      = {{Weekday after date|{{CURRENTYEAR}}|April|18|Thursday}}
| date{{NEXTYEAR}}         = {{Weekday after date|{{NEXTYEAR}}|April|18|Thursday}}
| date{{#time:Y|+2 years}} = {{Weekday after date|{{#time:Y|+2 years}}|April|18|Thursday}}

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. Click here to see a monthly parameter usage report for this template based on this TemplateData.

TemplateData for Infobox holiday

No description.

Template parameters

This template has custom formatting.

Parameter		Description	Type	Status
type	type	Type of holiday, sets banner color Default e.g. secular, national, international, cultural, historic, ethnic, patriotic, default, asian, judaism, shinto, islam, christian, commercial Example international	String	required
holiday_name	holiday_name	Usually the same as the page name Example World AIDS Day	Unknown	required
image	image	Do not include File: and do not wikilink Example Easter.svg	Unknown	suggested
image_size	image_size	no description	Unknown	optional
imagesize	imagesize	no description	Unknown	optional
alt	alt	Image description for visually impaired readers Example orange awareness ribbon	Unknown	suggested
caption	caption	Image caption	String	optional
official_name	official_name	no description	Unknown	suggested
nickname	nickname	Nickname for the date, or translations Example SAAM	Unknown	suggested
observedby	observedby	Countries or people who celebrate or observe the date Example [[Muslim]]s and [[Islam]], people worldwide	String	suggested
litcolor	litcolor	Color used for the holiday Example Blue	String	suggested
longtype	longtype	Lengthier alternative to type Example Cultural, ethnic and Buddhist	Unknown	optional
significance	significance	Lengthier description of holiday's significance	String	suggested
celebrations	celebrations	What usually happens on that date. Observances can be used instead. Example gift-giving, Church services	String	suggested
observances	observances	Can be used instead of celebrations to describe what happens on the date	String	optional
begins	begins	Required for multi-day holidays Example 1 October	Unknown	suggested
ends	ends	Required for multi-day holidays Example 31 October	Unknown	suggested
date	date	Date of event, do not use "1st", "5th" use 1, 5 Example 1 October	Unknown	required
week_ordinal	week_ordinal	For the first, second etc weeks in a month Example first	Unknown	optional
weekday	weekday	Day of week if always the same Example Sunday	Unknown	suggested
month	month	Use for long observances Example October	Unknown	suggested
date2023	date2023	no description	Unknown	optional
date2022	date2022	no description	Unknown	optional
date2020	date2020	Use when the date changes every year	Unknown	optional
scheduling	scheduling	Not displayed Example same day each year	String	suggested
mdy	mdy	if set auto-formatted dates will be displayed in "month day, year" Example yes	String	optional
duration	duration	no description Default e.g. 1 day, 1 week, 1 month Example 1 day	String	suggested
frequency	frequency	How often it occurs Default e.g. Annual, Every 4 years, Once Example Annual	Unknown	suggested
firsttime	firsttime	either first date or calculation of how long ago Example {{start date and age|df=yes|1988}}	Unknown	suggested
lasttime	lasttime	Useful for events no longer held or not held every year	Unknown	optional
startedby	startedby	Person or organization	Unknown	suggested
relatedto	relatedto	Any other dates or wiki pages linked to it Example [[World Mental Health Day]]	Unknown	suggested
date2021	date2021	no description	Unknown	optional

Tracking categories

Pages using the template with unsupported parameters are tracked in Category:Pages using infobox holiday with unknown parameters (0).

Other maintenance categories include:

• Category:Infobox holiday with missing field (2)