Skip to main content
CanoeUX home

SharePoint Web Parts Essentials

CNX Holidays

Show the statutory holidays of each country and region as a list or a year calendar, then download or email them as a PDF.

Overview

CNX Holidays shows the statutory holidays of the countries your organization works in, so everyone can see at a glance when colleagues are away and plan meetings, deadlines and coverage around them. Show the holidays as a list or a year calendar, narrow them down to a region, and download or email them as a ready-to-share PDF.

There's no data entry to get started. The first time someone views a country and year, CNX Holidays fills in its holidays from a public holiday service and saves them in a SharePoint list on your site. From then on, the list is your single source of truth: you can add company holidays, correct dates and add notes, and everyone sees the same calendar.

It's ideal for intranet home pages, HR and team sites, and any organization with people across several provinces, states or countries.

CNX Holidays web part walkthrough (6:45). Captions are available in the player.

Features

Holidays by country and region

Choose the countries to offer, and readers pick one with the Country filter. Depending on the country, holidays are shown nationwide and for its regions, provinces or states: use the Regions filter to show only the ones that apply to you. The choice is remembered for each country, and a tag above the list shows the active filter, so all regions are one click away. The Year filter goes from last year to three years ahead.

CNX Holidays in table view on a SharePoint page, showing Canada's holidays for 2026. The Regions filter is open with Nationwide and ON (Ontario) selected among the provinces and territories, so the list shows 11 of 31 holidays, each with its date, weekday, name, type and the regions that observe it.

View full-size image (opens in a new tab)

List or calendar view

Switch between two views. The list (Table view) shows each holiday's date, weekday, name, type, regions and notes, and can be sorted by date, name or type. The Calendar view shows the whole year as twelve month grids, with each holiday highlighted in the color of its type. Hover over a highlighted day to see its holidays, or select it for the details and a Learn More link.

CNX Holidays in calendar view: twelve month grids for 2026 with each holiday highlighted in green. A pop-up for August 3 shows the Civic Holiday, its date, Public type, country and regions, and a Learn More button.

View full-size image (opens in a new tab)

Download as PDF

Select Download to save the holidays as a PDF: a year calendar on the first page, followed by the list of holidays, both in your configured colors. The PDF contains the holidays currently shown, so if you've filtered by region, only those holidays are included.

The two pages of a downloaded PDF for Canada 2026: a Holidays Calendar page with twelve month grids and the holidays highlighted, followed by a Holidays List page with each holiday's date, weekday, name, type and regions.

View full-size image (opens in a new tab)

Share by email

Select Send email to send the holidays as a PDF attachment to colleagues, clients, partners or anyone else. Search for colleagues by name, or type any email address; the subject and a short message are filled in for you. The email is sent from your own mailbox, and a copy is saved in your Sent Items.

The Send holidays by email dialog over the calendar, with a To box for a name or email address, the subject “Canada holidays 2026”, a short greeting as the message, the Holidays-CA-2026.pdf attachment, and the Send and Cancel buttons.

View full-size image (opens in a new tab)

Add your own holidays

People with Full Control of the holidays list can add, edit and delete holidays right from the web part with New, Edit and Delete: add company holidays or local observances, correct a date or add notes. A duplicate check warns you before the same holiday is added twice, and deleted holidays go to the site recycle bin.

Configuration

After the CanoeUX SharePoint Web Parts Essentials package has been deployed to your SharePoint tenant, you can add CNX Holidays to any modern SharePoint page and configure it to show the holidays of the countries you work in.

  1. Step 1: Edit the page

    Go to the SharePoint page where you want to add the web part, and select Edit.

    Important: The Edit button is in the upper-right corner of the page. If you don't see it, you don't have permission to edit the page: ask the site owner or a site administrator for edit permissions.

  2. Step 2: Add a new web part

    Hover over the section where you want the web part to appear, and select + Add a new web part.

  3. Step 3: Select CNX Holidays

    In the web part toolbox, search for CNX Holidays, and select it to add it to the page.

  4. Step 4: Open the property pane

    Select the web part, and then select Edit properties in its toolbar.

    The toolbar of a selected web part: the move handle, the Edit properties button with its tooltip, and the Duplicate and Delete buttons.

    The property pane has two sections: Source and Layout and Appearance. SharePoint may add its own sections, such as Visibility, below them. To learn more about an option, hover over its information icon.

  5. Step 5: Configure the Source section

    Expand Source to choose the SharePoint list that stores the holidays, and the countries to offer.

    CNX Holidays property pane with the Source section expanded, showing the List name box set to “Holidays”, the Create Holidays list button and Supported countries set to Canada, United States and United Kingdom. The Layout and Appearance and Visibility sections are collapsed below.

    Available options

    List name

    The list where the holidays are stored, on the same site as the page. The default name is Holidays. Another name must start with Holidays- and have no spaces, such as Holidays-company or Holidays-fr.

    Select Create Holidays list to create the list. A dialog explains the permission change before it starts, then shows each step. If the site already has a compatible list with that name, you can select it instead. Creating a list requires the Manage Lists permission, which site owners have.

    Tip: One list can hold the holidays of several countries, but each list supports a single language. If your site has pages in several languages, create a list for each language.

    Supported countries

    Search by name or country code, and select the countries readers can choose from in the Country filter. At least one is required, and the first one is shown when the page opens. The default is Canada and United States.

    Where the holidays come from

    When the list has no holidays for a country and year, CNX Holidays reads them from a public holiday service (nagerholidays.com) and saves them in the list, so later visitors read them straight from SharePoint. Only the country and the year are sent: no credentials or SharePoint data.

    So that any visitor can save a missing year, a new list gives the people who can read or edit the site Contribute permission on it. Only people with Full Control of the list can add, edit or delete holidays from the web part. CNX Holidays never changes the permissions of an existing list.

  6. Step 6: Configure the Layout and Appearance section

    Expand Layout and Appearance to customize the title and the colors, so the web part matches your site's branding and page design.

    The Layout and Appearance section of the property pane: the Show title toggle turned on, the Title box set to “Holidays”, the Automatic title color toggle and the formatting toolbar, then the colors of the Public, Bank, School, Authorities, Optional and Observance holiday types with an Add holiday type button, then the Header, Sub-header, Border, Weekends and Weekdays calendar colors and a Reset all colors to default button.

    Available options

    Title
    • Turn Show title on or off to suit your page design. It's on by default.
    • Enter a custom title. The default is Holidays.
    • Use the formatting toolbar to change the title's font size, font weight and color. To choose your own color, turn off Automatic title color first.
    Holiday types

    Color-code holidays by type. Select a type's color to change it. The built-in types (Public, Bank, School, Authorities, Optional and Observance) match the public holiday service, so they can't be renamed or removed.

    Select Add holiday type to add your own, such as Company, which you can rename or delete later. Holidays saved with a type that has since been renamed or deleted use the Public color.

    Calendar colors

    Choose the colors of the calendar that fit your branding: Header (month), Sub-header (weekdays), Border, Weekends and Weekdays. Text is shown in black or white, whichever contrasts better with the color you choose.

    Reset all colors to default restores the default calendar and holiday type colors.

  7. Step 7: Approve API access

    To send email, CNX Holidays needs the Microsoft Graph Mail.Send permission. It's a delegated permission: the web part sends email only on behalf of the person who's signed in, from their own mailbox, and only when they select Send. It can't read anyone's mail or send email as someone else.

    An administrator approves the permission once for your whole organization. If it's already been approved, skip this step.

    1. Open the SharePoint admin center, and then go to Advanced > API access.
    2. Under Pending requests, select the Mail.Send request from CanoeUX SharePoint Web Parts Essentials.
    3. Review the permission, and then select Approve.

    Tip: The package may list other pending requests. Other web parts in the package use them; CNX Holidays needs only Mail.Send.

    Until Mail.Send is approved, everything else in CNX Holidays works, including Download. Only Send email is affected: it shows a message that an administrator must approve the permission.

  8. Step 8: Publish the page

    1. Back on the page that holds the web part, select Republish (or Publish, if the page has never been published) to save your changes and make the page available.
    2. Check that the web part appears correctly on the published page.

    CNX Holidays is now configured and ready to use. The first time a country and year are shown, their holidays are added to the list automatically.

Examples

  • National organization

    Show statutory holidays by province or state for a workforce that spans the country, so each person can filter to their own region.

  • Global team site

    Offer each country a team works in, so colleagues can check who's away before they schedule a meeting or set a deadline.

  • HR and onboarding

    Add company holidays alongside the statutory ones, and give new hires a calendar they can download as a PDF.

  • Client and partner planning

    Email the year's holidays to clients and partners, so project schedules account for your team's days off.

Best practices

  • Offer only the countries your organization works in, so the Country filter stays short.
  • Review the list at the start of each year, and add company holidays and notes where they help.
  • Approve the Mail.Send permission before you announce the page, so Send email works from day one.
  • Choose calendar and holiday type colors that match your branding and keep the calendar easy to read.
  • Place the web part on HR, team and home pages, where people plan their time.

Release notes

  1. Initial release

    October 2026

    • First release, included in CanoeUX SharePoint Web Parts Essentials.

Support

Have a question about CNX Holidays, or found something that doesn't work as expected? Contact CanoeUX and tell us what you expected to happen and what happened instead. Screenshots help, and for display or access issues, so does the output of CNX User Diagnostics.

Planning a wider intranet? Explore our SharePoint and digital workplace services.

Free of charge

Support CanoeUX

CanoeUX SharePoint Web Parts Essentials is provided free of charge.

If these web parts helped you save time or deliver value to your organization, consider supporting future development.