Promote an Unlocked Package

Task ID

Latest Version



This task is used to promote an unlocked package to ‘released’ state before deploying it into a production org. You can read more about promoting a package to released status here. It is recommended to utilize this taks in the ‘Prod’ stage in a release pipeline in most normal scenarios, where a tested package in the lower environment is ready to be deployed to production and the version number has to be frozen.


Install SFDX with Sfpowerkit task must be added to the pipeline before utilizing this task.

Task Snapshot


  • Name of the package to be promoted / package

    The name of the package that is to be promoted to the released state. This name does not have any significant value addition other than being just displayed in the task execution.

  • Path to the directory where artifacts are downloaded / artifactDir

    Path to the artifact directory where the artifacts are downloaded, If not provided, the default values will be automatically used

  • Project directory / project_directory

    The directory containing the sfdx-project.json.

  • Alias/username of the DevHub / devhub_alias

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

  • Skip if no artifact is found / skip_on_missing_artifact

    Enable this option to remove attached artifacts for a specific release, without having to remove the corresponding task from the release pipeline.



displayName: 'Promote version of package <mypackage> '
package: <mypackage>
artifact: '_mypackage'
project_directory: '$(sfpowerscripts_checked_out_path)'
skip_on_missing_artifact: false

Please note for this task to succeeded, the task needs access to the project directory. If you are using this task in the release pipeline, ensure the project directory is available.


  • 8.0.5 Remove "packagepromotedfrom" input parameter #151

  • 7.0.4 Update Core dependency

  • 7.0.0

    • Removed Telemetry Collection

    • Add support for Azure Artifacts

  • 4.0.1 Fix for #18 Promote task failing to promote unlocked package

  • 3.0.9 Refactored to use revamped folder structure

  • 2.0.1 Updated with Telemetry

  • 1.6.0 Initial Version

Edit on GitHub