--- title: "Configuring the Calendar" slug: "configuring-the-calendar" updated: 2026-11-17T16:37:30Z published: 2026-11-17T16:37:30Z canonical: "docs.xtremepush.com/configuring-the-calendar" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.xtremepush.com/llms.txt > Use this file to discover all available pages before exploring further. # Configuring the Calendar Colour rules, markets and key dates, insight settings, and permissions for the Calendar. A tenant admin sets up the Calendar once so it matches how your marketing team works. Colour rules make it clear whose campaign is whose. Markets and key dates put the moments that matter to your customers on the Calendar. Insight settings decide how strict the Calendar is about clashes and over-contact. Everyone else can see these settings but not change them. > [!NOTE] > Planning features > > Everything on this page comes with the Calendar's planning features, an optional extra currently in early access: **Calendar settings** and the settings cog only appear when they are enabled. Contact your account manager to have them enabled for your account. See [Standard and planning features](/documentation/docs/calendar#standard-and-planning-features). To open the settings, click the **cog** at the end of the Calendar header. **Calendar settings** has three tabs: **Colour rules**, **Insights** and **Key dates**. ## Colour rules Colour rules tag campaigns with a **Team**, **Brand** or **Product** and colour them on the Calendar, so anyone can tell at a glance who owns a send. Rules apply to everyone in your organisation. Tags also become filters and Timeline lanes, so each team can narrow the Calendar to its own work. ### Add a colour rule 1. On the **Colour rules** tab, click **Add rule**. 2. Choose the **Tag**: **Team**, **Brand** or **Product**. 3. Enter a **Label**, for example *Sportsbook*. 4. Choose a **Colour**. 5. Under **When**, choose **all conditions match** or **any condition matches**. 6. Build a condition: choose a field, an operator and a value. Click **Add condition** to add more, up to ten. 7. Check the preview, which reads **Matches N campaigns in this window.** 8. Click **Add rule**. | Fields | Operators | | --- | --- | | **Campaign name**, **Channel**, **Campaign type**, **Segment**, **Label** (the campaign's Xtremepush labels), **Send type** | **contains**, **does not contain**, **equals**, **starts with**, **ends with**, **is any of** | Matching ignores upper and lower case. For **is any of**, pick the values from the list, or enter them separated by commas. Rules work best when they follow how your team already names or labels campaigns. For example, if every Sportsbook campaign name starts with *SB*, a **Brand** rule where **Campaign name** **starts with** *SB* tags them all. ### Rule order Rules run from top to bottom, and the first rule that matches sets each tag. A campaign can carry one Team, one Brand and one Product tag. To change which rule wins, drag a rule by its handle or use its up and down arrows. To change or remove a rule, use its edit and delete buttons. ## Insight settings The **Insights** tab tunes what [Calendar insights](/documentation/docs/calendar-insights) flag. Start with the defaults, then adjust them to match your contact policy: if insights flag more than your team would act on, raise a threshold or ignore a segment that includes everyone. Saving reloads the Calendar's insights straight away. | Setting | What it does | Default | | --- | --- | --- | | **Ignored segments** | Segments that never cause a clash, a frequency warning or a busy broadcast day. Ignore a segment that everyone is in, such as an "all customers" segment, so it stops pairing every campaign with every other. Kept per Xtremepush project, for the instance chosen on the Calendar | None | | **Frequency warning** | How many times one person in a segment can be contacted within 7 days before a frequency insight is raised. Only campaigns that can reach the same person are counted. From 2 to 50 | 4 | | **Collision overlap** | How much two campaigns' custom audience rules must share before they clash, from 10% to 100%. Raise it if near-identical rules are not a concern for your team | 60% | To ignore a segment, search for it by name and tick it. To stop ignoring one, click the cross on its chip. Click **Save** to apply your changes, or **Reset to defaults** to go back to the defaults (nothing changes until you save). You can also ignore a segment straight from an insight's **Ignore** action. ## Key dates The **Key dates** tab controls the bands shown across the top of the Calendar's days. Key dates put the moments your customers care about on the Calendar, so your team plans for them in good time. ### Choose your markets Markets decide which public holidays and commercial moments appear, such as Christmas Day, Thanksgiving, Black Friday, or Mother's Day, on the right date for each market. These dates come built in, so there is nothing to connect or import. Add every market you send to. 1. Open **Add a market…** and choose a country, such as *United Kingdom (GB)*, or a region, such as *England (GB-ENG)* or *New Jersey (US-NJ)*. 2. Repeat for each market you send to. 3. Click **Save markets**. When a date falls in several of your markets, it shows as one band naming each market. The commercial moments included for each market are: | Market | Commercial moments | | --- | --- | | All markets | Valentine's Day, Black Friday, Cyber Monday, New Year's Eve | | United Kingdom and Ireland | Pancake Day, Mothering Sunday, Father's Day, Halloween, Christmas Eve | | United Kingdom only | Bonfire Night | | United States | Super Bowl Sunday, Mother's Day, Small Business Saturday, Father's Day, Halloween, Christmas Eve | ### Add your own key dates and promotion windows Add the dates that matter to your business but are not public holidays, such as a product launch, a major promotion, or the start of a new season. Use a promotion window for anything that runs over several days; it appears on each day it covers. Your key dates also feed insights: one with no campaign planned on it is raised as a **Key dates** insight. Key dates are added one at a time; there is no bulk upload. If you have a year's promotions calendar, start with the dates your team plans campaigns around. 1. Under **Your key dates**, click **Add key date**. 2. Enter a **Title**. 3. Choose the **Kind**: **Key date** or **Promotion window**. 4. Choose a **Colour**. 5. Set the **Start date**, and the **End date** for anything longer than a day. 6. Optionally, add **Notes**. They show when someone hovers the band, so use them for anything the team should know, such as the offer or the markets it covers. 7. Click **Add**. To change or remove one of your key dates, use its edit and delete buttons in the list. ## Permissions | Action | Who can do it | | --- | --- | | View the Calendar, search, filter, and open entries | Any team member | | Save views, and share them with the team | Any team member | | Change or delete a saved view | The person who saved it | | Delete a shared view for everyone | Tenant admins | | Dismiss, snooze and restore insights | Any team member | | Run **Review my calendar** | Any team member | | Change colour rules, markets, key dates, and insight settings | Tenant admins or custom role with granted permission only | | Ignore a segment from an insight | Tenant admins only | | Delete or dismiss ideas on the Calendar | The person who added the idea. Tenant admins or custom role with granted permission can delete or dismiss anyone's ideas. | | Create and move tickets from the Calendar | Any team member, with Work Trafficking enabled | Changes to colour rules, markets, key dates, and insight settings, a tenant admin deleting a shared view, and every dismiss, snooze, and restore are recorded in the Control Tower audit log under the **Calendar** module.