# Distribute License Manager entitlements
<a name="distribute-entitlement"></a>

If you are a license administrator operating in the management account of your organization with [all features](https://docs.amazonaws.cn/organizations/latest/userguide/orgs_manage_org_support-all-features.html) enabled, you can distribute entitlements to your organization from your granted licenses by creating a grant. For more information about Amazon Organizations, see [Amazon Organizations terminology and concepts](https://docs.amazonaws.cn/organizations/latest/userguide/orgs_getting-started_concepts.html).

You can specify the recipient of the grant as one of the following:
+ An Amazon Web Services account, which includes only the specified account.
+ An organization root, which will include all accounts across your organization.
+ An organizational unit (OU) (that is not nested), which includes all accounts in the specified OU and in nested OUs under the specified OU.

**Note**  
You can create up to 2,000 grants per license.

You can use either the Amazon License Manager console or the Amazon CLI to distribute your entitlements. You can specify the organization ID or the organization ARN when creating a grant in the console, but the ARN format must be used with the Amazon CLI. For example, the ARNs will resemble the following:

**Organization ID ARN**  
`arn:aws:organizations::<account-id-of-management-account>:organization/o-<organization-id>`

**Organization OU ARN**  
`arn:aws:organizations::<account-id-of-management-account>:ou/o-<organization-id>/ou-<organizational-unit-id>`

------
#### [ Console ]

**To create a grant (Console)**

1. Open the License Manager console at [https://console.amazonaws.cn/license-manager/](https://console.amazonaws.cn/license-manager/).

1. In the navigation pane, choose **Granted licenses**.

1. Choose a license ID to open the **License overview** page.

1. From the **Grants** section, choose **Create grant**.

1. On the **Grant details** panel, do the following:

   1. Enter a name for the grant to help you identify the purpose or recipient of the grant.

   1. Enter the Amazon Web Services account ID, Amazon Organizations OU ID or ARN, or Amazon Organizations ID or ARN of the grant recipient.

   1. Choose **Create grant**.

1. On the **License overview** page, you'll see an entry for the grant in the **Grants** panel. The initial status of the grant is **Pending acceptance**. The status changes to **Active** when the recipient accepts the grant or **Rejected** when the recipient rejects the grant.

------
#### [ Amazon CLI ]

You can use the Amazon CLI to distribute an entitlement. You must use specify an organization ID or OU in ARN format when using the Amazon License Manager API.

**To create and list your grants using the Amazon CLI:**
+ [https://docs.amazonaws.cn/cli/latest/reference/license-manager/create-grant.html](https://docs.amazonaws.cn/cli/latest/reference/license-manager/create-grant.html)
+ [https://docs.amazonaws.cn/cli/latest/reference/license-manager/list-distributed-grants.html](https://docs.amazonaws.cn/cli/latest/reference/license-manager/list-distributed-grants.html)

------

The grant details page displays the list of accounts that you have granted access to the entitlement. After distributing a license to your organization, you can deactivate or activate the licenses individually on each account.