Package manifest reference
Reference for the package manifest file.
Read time 6 minutesLast updated a day ago
The Unity Editor uses a package manifest file () to manage information about a specific version of a specific package.
package.jsonThe package manifest uses JSON (JavaScript Object Notation) syntax to describe what's inside the package. The file's format is similar to npm's format, but uses different semantics for some of its properties. Refer to the example for a sample package manifest file.
package.jsonThe Package Manager reads this manifest to find out the package's contents, how to unpack its contents, and what information to display in the Package Manager window. The manifest stores this information in a series of required, recommended, and optional properties.
Required properties
If these properties aren't present, either the registry refuses the package when it's published, or the Package Manager can't fetch or load the package.
Property | JSON Type | Description |
|---|---|---|
| name | String | A unique multi-part identifier that conforms to the Unity Package Manager naming convention, which uses reverse domain name notation. For more information about the naming convention, refer to Package name guidelines. Note: The |
| version | String | The package version number, which uses the format For example, This value must respect Semantic Versioning. For more information, refer to Package versioning. |
Recommended properties
The Package Manager can install packages in a project even if the recommended properties are missing or have invalid values.
However, the recommended best practice is to assign values for these properties to make sure that your package is discoverable and to offer a better experience for users.
Property | JSON Type | Description |
|---|---|---|
| description | String | A brief description of the package. This is the text that appears in the details panel of the Package Manager window. This field supports UTF-8 character codes. This means that you can use special formatting character codes, such as line breaks ( |
| displayName | String | A user-friendly name that appears in the Unity Editor, such as in the Project window and the Package Manager window. Examples of |
| unity | String | Indicates the lowest Unity version the package is compatible with. If omitted, the Package Manager considers the package compatible with all Unity versions. The expected format is To point to a specific patch, also include the Note: Installing a package in a project using an Editor lower than the value specified in |
Optional properties
These properties are optional, meaning that you can omit them. However, if they're present, they must have a valid value.
Property | JSON Type | Description |
|---|---|---|
| author | Object or string | The author of the package. This property supports only one author. This property has one required field, name, and two optional fields, email and url. You can specify these fields as a JSON object, or collapse them into a single string whose key is author. Object example: String example: |
| changelogUrl | String | Custom location for this package's changelog specified as a URL. For example:Note: When the Package Manager can't reach the URL location (for example, if there's a network issue), it does the following: - If the package is installed, the Package Manager opens a file browser displaying the - If the package isn't installed, the Package Manager displays a warning that an offline changelog isn't available. |
| dependencies | Object | A map of package dependencies. Keys are package names, and values are specific versions. They identify other packages that this package depends on. Note: The Package Manager doesn't support range syntax, only SemVer versions. |
| documentationUrl | String | Custom location for this package's documentation, specified as a URL. For example:Note: When the Package Manager can't reach the URL location (for example, if there's a network issue), it does the following: - If the package is installed, the Package Manager opens a file browser displaying the - If the package isn't installed, the Package Manager displays a warning that offline documentation isn't available. |
| hideInEditor | Boolean | By default, the Project window hides a package's assets and omits them from the results when you use the Object Picker in the Inspector window. Set this property to |
| keywords | Array of Strings | An array of keywords used by the Package Manager search APIs. This helps users find relevant packages. |
| license | String | Identifier for an OSS license using the SPDX identifier format, or a string such as 'Refer to LICENSE.md file'. Note: If you omit this property in your package manifest, your package must contain a |
| licensesUrl | String | Custom location for this package's license information, specified as a URL. For example:Note: If the Package Manager can't reach the URL location (for example, if there's a network issue), it does the following: - If the package is installed, it opens a file browser displaying the - If the package isn't installed, the Package Manager displays a warning that offline license information isn't available. |
| samples | Array of Objects | List of samples included in the package. Each sample requires a display name and the path to the sample folder starting at the Important: If any subdirectory within For more information about the |
| type | String | Reserved for internal use. |
| unityRelease | String | Part of a Unity version indicating the specific release of Unity that the package is compatible with. You can use this property when an updated package requires changes made during the Unity alpha/beta development cycle. This might be the case if the package needs newly introduced APIs, or uses existing APIs that have changed in a non-backward-compatible way without API updater rules. The expected format is Note: If you omit the recommended unity property, this property has no effect. A package that's not compatible with Unity doesn't appear in the Package Manager window. |
Package manifest example
{ "name": "com.[company-name].[package-name]", "version": "1.2.3", "displayName": "Package Example", "description": "This is an example package", "unity": "2019.1", "unityRelease": "0b5", "documentationUrl": "https://example.com/", "changelogUrl": "https://example.com/changelog.html", "licensesUrl": "https://example.com/licensing.html", "dependencies": { "com.[company-name].some-package": "1.0.0", "com.[company-name].other-package": "2.0.0" }, "keywords": [ "keyword1", "keyword2", "keyword3" ], "author": { "name": "Unity", "email": "unity@example.com", "url": "https://www.unity3d.com" }}