Octopus Deploy Documentation

Release Versioning

Last updated

Under Project settings there's a section for Release Versioning where you can select how the next release number is generated when creating a release.

Release Versioning

You can use variables from the project (un-scoped or scoped only to a channel). In addition, some special variables are provided - example:

1.2.#{"{"}Octopus.Version.NextPatch{"}"}-pre

These special variables take the form:

Octopus.Version.(Last|Next)(Major|Minor|Patch|Build|Revision|Suffix)

If you are using channels, channel-specific special variables are also available:

Octopus.Version.Channel.(Last|Next)(Major|Minor|Patch|Build|Revision|Suffix)

Version components from other channels in the project can be referenced using the channel name as the index:

Octopus.Version.Channel[ChannelName].(Last|Next)(Major|Minor|Patch|Build|Revision|Suffix)

The channel name can also be used (generally as part of the suffix):

Octopus.Release.Channel.Name

The version can also include Octopus semantic version mask characters i and c referring to the incremented and current values of the version, respectively. For example:

2.1.c.i

Finally, date fields can be also be used, for example:

#{"{"}Octopus.Date.Year}.#{"{"}Octopus.Date.Month{"}"}.#{"{"}Octopus.Date.Day{"}"}

These take the form:

Octopus.Date.(Day|Month|Year|DayOfYear)
Octopus.Time.(Hour|Minute|Second)

Welcome! We use cookies and data about how you use our website allow us to improve the website and your experience, and resolve technical errors. Our website uses cookies and shares some of your data with third party analytics companies for these purposes. We do not use these cookies for advertising.

If you decline, we will respect your privacy. A single cookie will be used in your browser to remember your preference.