Create a new version of Unlocked Package

Task ID

Latest Version



This task is used to create a new version of an Unlocked Package. The task can optionally generate a build artifact, containing metadata such as the package ID, name, version, repository URL and the commit ID from which it was generated. The build artifact can then be used in release pipelines to install the associated unlocked package in a Salesforce org. You can read more about unlocked packages here.


Install SFDX CLI with sfpowerkit task must be added to the pipeline before utilizing this task

Task Snapshot



Classic Designer Labels are in Bold, YAML Variables are in italics

  • ID or alias of the package / package

    Provide the alias or username of the target org on which the source directory is to be deployed

  • the version number of the package to be created / version_number

    The format is major.minor.patch.buildnumber. This will override the build number mentioned in the sfdx-project.json. Consider using the Increment Version Number task before this task and passing thesfpowerscripts_incremented_project_version variable as an input to this field.

  • Tag of the package version / tag

    The tag of the package version to be created

  • Enable generation of test coverage of this particular package / enable_coverage

    Calculate and store the code coverage percentage by running the Apex tests included in this package version.

  • Skip Validation of Dependencies,Ancestors etc / isValidationToBeSkipped

    Skips validation of dependencies, package ancestors, and metadata during package version creation. Skipping validation reduces the time it takes to create a new package version, but package versions created without validation can’t be promoted.

  • Config File Path / config_file_path

    Path in the current project directory containing config file for the packaging org

  • Bypass Installation Key / installationkeybypass

    Bypass the requirement for having an installation key for this version of the package.

  • Installation Key / installationkey

    Installation key for this package

  • Project directory / project_directory

    Leave it blank if the sfdx-project.json is in the root of the repository, else provide the folder directory containing the sfdx-project.json.

  • Alias/username of the Dev Hub

    Provide the alias of the Dev Hub previously authenticated, default value is HubOrg if using the Authenticate Devhub task.

  • Wait Time / wait_time

    Time to wait for this execution to complete,after this set wait time the next task in the pipeline will be executed. It is recommended to provide sufficient wait time so that the command can be made into a synchronous execution

  • Only run task if package has changed / isDiffCheck

    Enable this option to conditionally build the source package only if there has been a change to the package. To determine whether a package has changed, also enable 'Tag latest commit ID with package name and version'.

  • Tag latest commit ID with package name and version / isGitTag

    Enable this option to tag the latest commit ID with an annotated Git tag that shows the package name and version. To push the tag to your repository, please refer to Execute Post Steps after Creating a Package.

  • Display the package's version number as the pipeline build number / set_build_number

    Set the pipeline's build number to the the package's incremented version number. Useful when one is using NEXT as the build number.



This variable holds the id of the package version. Use this package version to install it or use it for any other subsequent tasks.


The version number of the package that was created

displayName: 'Creates a new version of <mypackage>'
package: <mypackage>
enable_coverage: false
isValidationToBeSkipped: true
isDiffCheck: false
isGitTag: false

Please ensure a package is already created before utilizing this task and the package alias is available in the sfdx-project.json, as this task is all about creating a new version of the package


  • 12.0.5 Refactor artifact structure #131, resolve package dependencies to exact version #155

  • 11.0.6 Update Core dependency

  • 8.0.9 Refactored to use revamped folder structure

  • 7.0.2 Support for creation of multiple packages in a single build such as in a MonoRepo

  • 6.0.1 Skip Validation

  • 5.1.2 Hotfix for Exception bug

  • 5.0.1 Updated with Telemetry

  • 4.0.0 Added Coverage Option

  • 3.1.0 Initial Version

Edit on GitHub