package1 Commands

Use the package1 commands to create and view first-generation package versions in your Dev Hub org.

package1:version:create

Creates a first-generation package version in the release org.

Command Syntax

sfdx force:package1:version:create
-i PACKAGEID
-n NAME
[-d DESCRIPTION]
[-v VERSION]
[-m]
[-r RELEASENOTESURL]
[-p POSTINSTALLURL]
[-k INSTALLATIONKEY]
[-w WAIT]
[-u TARGETUSERNAME]
[--json]
[--loglevel LOGLEVEL]

Parameters

-i | --packageid PACKAGEID
Required

ID of the metadata package (starts with 033) of which you’re creating a new version.

Type: id
-n | --name NAME
Required

Package version name.

Type: string
-d | --description DESCRIPTION
Optional

Package version description.

Type: string
-v | --version VERSION
Optional

Package version in major.minor format, for example, 3.2.

Type: string
-m | --managedreleased
Optional

Creates a managed package version. To create a beta version, don’t include this parameter.

Type: flag
-r | --releasenotesurl RELEASENOTESURL
Optional

Release notes URL.

Type: url
-p | --postinstallurl POSTINSTALLURL
Optional

Post install URL.

Type: url
-k | --installationkey INSTALLATIONKEY
Optional

Installation key for creating the key-protected package. The default is null.

Type: string
-w | --wait WAIT
Optional

Minutes to wait for the package version to be created. The default is 2 minutes.

Type: number
-u | --targetusername TARGETUSERNAME
Optional

A username or alias for the target org. Overrides the default target org.

Type: string
--json
Optional

Format output as JSON.

Type: flag
--loglevel LOGLEVEL
Optional

The logging level for this command invocation. Logs are stored in $HOME/.sfdx/sfdx.log.

Type: string
Permissible values are: trace, debug, info, warn, error, fatal
Default value: error

Help for package1:version:create

NOTE: This command must be run from within a project.

The package version is based on the contents of the specified metadata package. Omit -m if you want to create an unmanaged package version.

package1:version:create:get

Retrieves the status of a package version creation request.

Command Syntax

sfdx force:package1:version:create:get
-i REQUESTID
[-u TARGETUSERNAME]
[--json]
[--loglevel LOGLEVEL]

Parameters

-i | --requestid REQUESTID
Required

The ID of the PackageUploadRequest.

Type: id
-u | --targetusername TARGETUSERNAME
Optional

A username or alias for the target org. Overrides the default target org.

Type: string
--json
Optional

Format output as JSON.

Type: flag
--loglevel LOGLEVEL
Optional

The logging level for this command invocation. Logs are stored in $HOME/.sfdx/sfdx.log.

Type: string
Permissible values are: trace, debug, info, warn, error, fatal
Default value: error

Help for package1:version:create:get

Examples:

1$ sfdx force:package:version:create:report -i 08c...
1$ sfdx force:package:version:create:report -i 08c... -v devhub@example.com

package1:version:display

Displays detailed information about an individual first-generation package version.

Command Syntax

sfdx force:package1:version:display
-i PACKAGEVERSIONID
[-u TARGETUSERNAME]
[--json]
[--loglevel LOGLEVEL]

Parameters

-i | --packageversionid PACKAGEVERSIONID
Required

ID (starts with 04t) of the metadata package version whose details you want to display.

Type: id
-u | --targetusername TARGETUSERNAME
Optional

A username or alias for the target org. Overrides the default target org.

Type: string
--json
Optional

Format output as JSON.

Type: flag
--loglevel LOGLEVEL
Optional

The logging level for this command invocation. Logs are stored in $HOME/.sfdx/sfdx.log.

Type: string
Permissible values are: trace, debug, info, warn, error, fatal
Default value: error

Help for package1:version:display

NOTE: This command must be run from within a project.

Display detailed information about an individual package version, including metadata package ID, name, the release state, and build number.

package1:version:list

Lists the versions for the specified package or all first-generation packages in the org.

Command Syntax

sfdx force:package1:version:list
[-i PACKAGEID]
[-u TARGETUSERNAME]
[--json]
[--loglevel LOGLEVEL]

Parameters

-i | --packageid PACKAGEID
Optional

Metadata package ID (starts with 033) whose package versions you want to list. If not specified, shows all versions for all packages (managed and unmanaged) in the org.

Type: id
-u | --targetusername TARGETUSERNAME
Optional

A username or alias for the target org. Overrides the default target org.

Type: string
--json
Optional

Format output as JSON.

Type: flag
--loglevel LOGLEVEL
Optional

The logging level for this command invocation. Logs are stored in $HOME/.sfdx/sfdx.log.

Type: string
Permissible values are: trace, debug, info, warn, error, fatal
Default value: error

Help for package1:version:list

NOTE: This command must be run from within a project.

If a metadata package ID is specified, lists all versions of the specified package. Otherwise, lists all package versions for the org. For each package version, the list includes the package version ID, metadata package ID, name, version number, and release state.