Skip to main content
Version: Early Access

Create Release Task

The Create Release task enables you to automatically create and start a release based on a configured template.

Create Release

Input Properties

The following properties configure the behavior of the Create Release task:

PropertyDescription
Release TitleThe title for the newly created release
TemplateThe template to create the release from, or a variable containing the template ID
FolderThe destination folder for the new release
Risk ProfileThe risk profile to assign to the release
Start ReleaseWhen enabled, automatically starts the release after creation (enabled by default)
Release TagsTags to add to the new release (supports variables using ${...} syntax)
VariablesRequired template variables to populate (if applicable)
Release IDOutput property storing the ID of the created release
Wait for Release to FinishControls task completion behavior:
- Enabled: Task waits for sub-release completion
- Disabled: Task completes after initiating sub-release

In the Release Flow Editor, Create Release tasks are visually distinguished with a green border.

Template Name Display in Dropdown

The Template dropdown now displays both folder paths and template names, improving template selection.

Create Release

The system applies intelligent name truncation:

  • Single root folders: Names truncate at the end
  • Nested folders: Names truncate at the beginning
  • Template names: Always truncate at the end
  • Hovering reveals full names via tooltip

Automated Tasks User Configuration

Create Release tasks require an assigned automated tasks user. This user must have:

  • The "Create Release" permission on the specified template
  • Assignment through the "Run automated tasks as user" release property

The automated tasks user carries over to the new release, overriding any template-specific user assignments. For more details, see Configure Release Properties.

Dynamic Template and Variable Assignment

Templates can be dynamically assigned using release variables. Toggle the template selector to variable mode to:

  • Select from existing global/release variables
  • Create new variables directly
  • Configure dynamic variable values
  • Pass template variables through the Create Release task

Folder Variable Selection

The destination folder can be dynamically set using a text-type variable:

  1. Create a folder variable if needed
  2. Toggle the folder selector to variable mode
  3. Choose from available release/folder/global variables

The selected variable's value determines the Folder ID at runtime.

Working with the Created Release ID

The new release's unique ID is stored in the task's "Created Release ID" output property. You can:

  • Map this ID to a variable for use in other tasks
  • Use it in Gate tasks to coordinate release flow
  • Track the sub-release progress when needed

Without saving the ID to a variable, the release proceeds normally but cannot reference the sub-release.

Concurrent Release Limits

To maintain optimal performance, Release enforces a default limit of 100 concurrent releases from Create Release tasks. To modify this limit:

  1. Locate XL_RELEASE_SERVER_HOME/conf/deployit-defaults.properties
  2. Uncomment and adjust xlrelease.Release.maxConcurrentReleases
  3. Restart the Release server to apply changes