---
schema_version: "1"
id: 33fdcf08906bb6d6b714cb5edf0c37ee2f8c1ce9648c5dfa6a379df0b0edf780
title: InstalledPackage
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_installedpackage.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_installedpackage.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: dc0a8b53a206eaaae0d2bb07fa8e52fbc2f98c284e41083b6b31eede6126c50b
description: Represents a first-generation managed package to be installed or uninstalled. Deploying a newer version of a currently installed package upgrades the package. You can install up to 20 first-generation managed packages in a single deployment. To install an unlocked or second-generation managed package, use the sf package install Salesforce CLI command.
---
# InstalledPackage

Represents a first-generation managed package to be installed or uninstalled. Deploying a newer version of a currently installed package upgrades the package. You can install up to 20 first-generation managed packages in a single deployment. To install an unlocked or second-generation managed package, use the sf package install Salesforce CLI command.

![Note](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/images/icon_note.png)

#### Note

You can’t deploy a package along with other metadata types. When you deploy InstalledPackage, it must be the only metadata type specified in the manifest file.

## File Suffix and Directory Location

The package is specified in the installedPackages directory, in a file named after the package’s namespace prefix. The file extension is .installedPackage.

## Version

InstalledPackage is available in API version 28.0 and later.

## Fields

<table class="featureTable sort_table" summary="">



          <thead class="thead sorted" align="left">
            <tr>
              <th class="featureTableHeader  " id="d592984e91">Field Name</th>

              <th class="featureTableHeader  " id="d592984e94">Field Type</th>

              <th class="featureTableHeader  " id="d592984e97">Description</th>

            </tr>

          </thead>

          <tbody class="tbody">
            <tr>
              <td class="entry" headers="d592984e91" data-title="Field Name"><span class="keyword parmname">activateRSS</span></td>

              <td class="entry" headers="d592984e94" data-title="Field Type">boolean</td>

              <td class="entry" headers="d592984e97" data-title="Description">Required. Determines the state of Remote Site Settings (RSS) and Content
                Security Policy (CSP) at the time of installing the package and must be set to
                either of these values. <dl class="dl detailList">

                  <dt class="dt dlterm">true</dt>

                  <dd class="dd">Keep the isActive state of any RSS or CSP in the package. </dd>



                  <dt class="dt dlterm">false</dt>

                  <dd class="dd">Override the isActive state of any RSS or CSP in the package and set it to
                    <samp class="codeph nolang">false</samp>.
                  </dd>


                </dl>
                The default value is <samp class="codeph nolang">false</samp>. Available in
                API version 43.0 and later.</td>

            </tr>

            <tr>
              <td class="entry" headers="d592984e91" data-title="Field Name"><span class="keyword parmname">password</span></td>

              <td class="entry" headers="d592984e94" data-title="Field Type">string</td>

              <td class="entry" headers="d592984e97" data-title="Description">Specifies the package password.</td>

            </tr>

            <tr>
              <td class="entry" headers="d592984e91" data-title="Field Name"><span class="keyword parmname">securityType</span></td>

              <td class="entry" headers="d592984e94" data-title="Field Type">string</td>

              <td class="entry" headers="d592984e97" data-title="Description">Determines user access for the installed package.<p class="p">Valid values are:</p>
                <ul class="ul bulletList">
                  <li class="li"><samp class="codeph nolang">AdminsOnly</samp></li>

                  <li class="li"><samp class="codeph nolang">AllUsers</samp></li>

                </ul>
                <p class="p">The default value is <samp class="codeph nolang">AllUsers</samp>.
                  Available in API version 57.0 and later.</p>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d592984e91" data-title="Field Name"><span class="keyword parmname">versionNumber</span></td>

              <td class="entry" headers="d592984e94" data-title="Field Type">string</td>

              <td class="entry" headers="d592984e97" data-title="Description">Required. The version number of the package. The version number has the format
                <samp class="codeph nolang"><var class="keyword varname">majorNumber.minorNumber.patchNumber</var></samp> (for example,
                <samp class="codeph nolang">2.1.3</samp>).
              </td>

            </tr>

          </tbody>

        </table>

## Declarative Metadata Sample Definition

The following example specifies a sample package to be installed or uninstalled.

<?xml version="1.0" encoding="UTF-8"?>
        <InstalledPackage xmlns="http://soap.sforce.com/2006/04/metadata">
        <versionNumber\>1.0</versionNumber\>
        <password\>optional\_password</password\>
        <securityType\>AdminsOnly</securityType\>
        <activateRSS\>true</activateRSS\>
        </InstalledPackage\>

The securityType field is optional. If it’s not specified, the default security type is AllUsers.

## Wildcard Support in the Manifest File

This metadata type supports the wildcard character \* (asterisk) in the package.xml manifest file. For information about using the manifest file, see [Deploying and Retrieving Metadata with the Zip File](https://developer.salesforce.com/docs/atlas.en-us.264.0.api_meta.meta/api_meta/file_based_zip_file.htm).