Setting Up Holidays in Yeastar PBX: Guide

Knowledge Base Guide: Setting Up Holidays in Yeastar PBX

Applies To: Yeastar P-Series PBX (Cloud, Appliance, Software Editions)

Purpose / Summary

This article explains how to configure Holidays in Yeastar PBX systems and correctly apply them to call routing. Proper holiday configuration ensures inbound calls are handled as expected during public holidays, shutdown periods (e.g. Christmas break), or special closures.

Important: Creating a holiday alone does not change call behaviour. Holidays must be applied to inbound routes or other call control rules to take effect.

Important Notes (Read Before You Start)

• Holidays are time-based, not just date-based (start and end times matter).

• Holidays will not affect call routing unless they are referenced in inbound routes.

• Always confirm the PBX time zone before creating holidays.

• This guide applies to Yeastar P-Series PBX.

  • For older S-Series, holidays are managed via separate Time Conditions.

Step 1: Navigate to Business Hours & Holidays

1. Log in to the Yeastar PBX web portal.

2. Go to:
   Call Control → Business Hours and Holidays

This page is the central location for:

• Time zones

• Business hours

• Holiday schedules

Step 2: Verify the System Time Zone (Critical)

At the top of the Business Hours and Holidays page:

• Confirm the Time Zone (e.g. Australia/Sydney)

• Check Daylight Saving Time (usually set to Automatic)

Why this matters

• Holidays trigger based on the PBX system time.

• An incorrect time zone can cause holidays to activate early or late, resulting in misrouted calls.

If changes are required

• Update the time zone under:
  System → Date and Time

• For multi-region environments:

  • Add additional time zones on this page

  • Configure holidays separately per time zone

Only proceed once the correct time zone is confirmed.

Step 3: Open the Holidays Tab

1. On the Business Hours and Holidays page:

   • Select the relevant time zone (if multiple exist)

2. Click the Holidays tab

Note: Do not configure holidays under Business Hours. Business Hours settings do not control holiday routing.

Step 4: Add a New Holiday

1. Click + Add (or Add Holiday)

2. Configure the holiday details as follows:

Required Fields

Holiday Name

• Use a clear, descriptive name

  • Example: Christmas Holidays 2025

• This name will appear in routing and configuration menus.

Holiday Type

• By Date (Recommended)

  • For specific dates or multi-day closures

• By Week

  • For recurring holidays (e.g. first Monday of September)

• By Month

  • For fixed annual dates (e.g. December 25 every year)

Set the Date & Time Range (Very Important)

• Start Date / Time

  • Example: 19/12/2025 05:30 PM

• End Date / Time

  • Example: 05/01/2026 08:00 AM

Key Tips

• Yeastar checks both date and time

• For a full single-day holiday:

  • Start: 12:00 AM

  • End: 11:59 PM

• For multi-day closures:

  • Use one continuous date/time range

• Avoid overlapping or incorrect times as this can cause unexpected call routing

Optional Settings

• Holiday Prompt

  • Assign a custom voice prompt (e.g. “We are closed for the holidays”)

  • This can be played before routing during holiday periods

Step 5: Save the Holiday

1. Click Save (and Apply if prompted)

The holiday will now appear in the list showing:

• Holiday Name

• Type

• Date & Time Range

• Edit / Delete options

Step 6: Apply the Holiday to Call Routing (Mandatory)

Important: Holidays do nothing unless they are applied to call routing rules.

Most Common Method: Inbound Routes

1. Go to:
   Call Control → Inbound Routes

2. Edit an existing inbound route (or create a new one)

3. In the Time Condition section, configure:

   • Business Hours Destination

     • Example: Ring Group or IVR

   • Non-Business Hours Destination

     • Example: Voicemail

   • Holiday Destination

     • Example:

       • Holiday IVR

       • Voicemail

       • Queue

       • External number

       • AI Voice Agent

Example Configuration

• Business Hours → Ring Group

• Non-Business Hours → Voicemail

• Holidays → Holiday Greeting IVR

4. (Optional) Enable Play Holiday Prompt During Holidays

5. Click Save and Apply

What Happens If Holiday Destination Is Not Set?

• Calls during holidays will automatically follow Non-Business Hours routing

• This may not match the intended customer experience

Final Checks

Before closing the task:

• Confirm the holiday dates and times

• Test call routing during a holiday window (if possible)

• Verify the correct inbound route is being used by the DID