Deployment Calendar


Table of contents

Related Articles


In order to deliver features with with ease, while minimizing the impact on the infrastructure and users, the deployment calendar becomes a very useful tool. It allows to visualize the planned deployments and show if one or more services will be impacted. It is recommended to do implementations based on a schedule pre-established by the enterprise to minimize impacts. It is also important to consider the interrupted services and the frequency of their deployments.

A change can have multiple deployment tasks. This is an advantage to plan deployments in multiple phases.

How to Add a Deployment to the Calendar

To add a new entry to the deployment calendar, you must enter the following information from a Change task:

  1. Enter a start date and time
  2. Enter an end date and time
  3. Check the Is a deployment box
  4. Choose the impact level between: 
    • None
    • Degradation
    • Interruption
Visual explanation


Note: In order for the task to appear into the deployment calendar, it must be checked Is a deployment and have an impact selected. 

Add a Deployment Task to a Change Template

It is possible to add a deployment task to a change template. You only need to check the Is a deployment box and add an Impact

The deployment task will be created along with the change. However, for the task to be visible in the deployment calendar, you need to add the start and end dates. 


  Trick: Create a list that targets tasks and that searches for deployment tasks without dates to prevent you from forgetting them. 

Use the following criteria: 

  • Is a deployment
    • Operator - Equal
    • Value - Yes
  • ​Estimated Start Date
    • Operator - Is empty


Visual explanation

Deployment Task in an SR

In some contexts where Change Management is not used or in non-IT teams, there may be a need to use the deployment calendar to manage deployment tasks inside SRs. It works the same way in SRs as it does in Changes. 

If needed, an on-demand option exist to activate deployment tasks in SRs. Contact our Service Desk to make the request and ask for the ServiceRequest.TaskDeployment.Enabled option.

Calendar Overview


The deployment calendar is colour coded by impact.

  • No colour and crossed out: The task was cancelled
  • Gray: No impact
  • Orange: Service degradation
  • Red: Service interruption


Calendar View

Several views are available:

  • Agenda
  • Week
  • Month

Each of these views displays different information

Visual explanation


The Agenda view displays all planned deployments.  

Here is the information displayed:

  1. Deployment date
  2. Deployment period
  3. Impact colour
  4. Impacted service
  5. Subject of deployment task
  6. Assigned deployment group
Visual explanation


The Week view displays all deployments planned during the selected week.

Here is the information displayed:

  1. Week
  2. Date 
  3. Time
  4. Impact colour
  5. Impacted service
  6. Subject of deployment task
  7. Assigned deployment group
Visual explanation

Options for the Week View

By default, the week view of the deployment calendar shows the deployments from 7:00 to 00:00. As most deployments are done out of this range an option allows to modify the start time of the range.

For example to 00:00 in order to see 24 hours at a time.

It is also possible to choose the end time visible in the calendar. 

Contact us to modify the time range if required and mention the DeploymentCalendar.StartTime or DeploymentCalendar.EndTime option depending on whether you wish to change the start or end time.

Visual explanation


The Month view displays all deployments planned during the selected month.

Here is the information displayed:

  1. Month
  2. Impact colour
  3. Impacted service
Visual explanation


Note: When you mouse over a deployment, the following information is displayed: 
  • Subject of deployment task
  • Assigned deployment group


Deployment History

The deployment calendar keeps a complete history of deployment tasks unless they have been deleted.

Note: Before version 4.2.240 only the last three months could be seen in the deployment calendar. 


Deployment Calendar Configuration

The default data that is visible in the deployment calendar is:

  1. The service selected in the change.
  2. The subject of the deployment task.
  3. The group assigned to the deployment task.
Visual explanation


The variables can be changed using the configuration button at the top right of the calendar.

What you need to know:
  • Only an Octopus user with permission to administer Octopus can see the configuration button in the deployment calendar.
  • The change affects all users in all of the calendar modes.
  • To return to the default values in a section, just do CTRL + D.

The button opens the 3 labels and allows to modify the display of elements in the calendar. 

In our example, we do not use the Service field, so we will replace it with the name of the change that is represented in a task by the Context. Then we will add the Octopus user who is in charge of the task as well as the group. 

Here are the steps:

  1. The Octopus administrator selects the configuration button. 
  2. In the Title label, we replace the default variable with the context one using F3
  3. We leave the Task hyperlink label section as is.
  4. In the Other labels section we will add a space, a pipe and the name of the Octopus user with F3
  5.  No saving is required, the modifications are automatically executed. 
Visual explanation


Visibility of SR Deployment Tasks

If the deployment tasks have been activated for the SRs, the Octopus users have the option of choosing to see these tasks in the calendar or not.

  • From the Configuraiton section of the Deployment Calandar. 
  • Use the Include SR Tasks button to choose. 
Visual Explanation



Help us improve our articles

Help us improve our articles