# Managing group packages

Source: https://docs.arcxp.com/en/products/subscriptions/arc-xp-subscriptions-retail/managing-group-packages.html

Use the Group Packages page in Subscriptions Retail to manage enterprise group subscriptions and gift purchases. You can use the group packages feature for small group membership, large corporations, or location-based entitlement.

Arc XP allows you to configure group packages by the following criteria:

- **IP Entitlement** \- provides location-based access for users who connect to the site from a set of IP addresses.
- **Email Domain Entitlement** \- provides access to medium-sized groups where all members share the same email domain.
- **Enterprise Groups** \- customers can build their flows for large enterprise organizations.
- **Associate Subscriptions** \- provides access for up to 10 friends, family, or small organization members.

From the Group Packages page, you can filter group packages by site, if you have a multi-site organization. For single-site organizations, your site is the only and default option.

## Prerequisites

To create group packages, you must have completed the following items:

- Created a product. See [Managing products](https://docs.arcxp.com/en/products/subscriptions/arc-xp-subscriptions-retail/managing-products.html).

## Scenario: Setting a group package for a domain

As a news organization administrator, you want to give free access to all employees of a corporate subscriber’s office. You configure a group package using the company’s email domain: @example.com. You share the access code, _ABC123_, with your customer, so their employees can log in to your site.

The company’s employees visit your fulfillment page, enter “ABC123”, verify their “@example.com” email, and automatically get added to their company’s group subscription.

This approach allows your organization to distribute access while maintaining control over who can join based on email domain restrictions.

## Procedures

### Creating a group package

To create a group package, complete the following:

1. Navigate to **Subscriptions** \> **Retail** \> **Group packages**. The Group Packages page opens.
2. Click **Create Group Package**. The New Group Package page opens.
3. Complete the following fields:

  - **Package name** \- enter a name for the group package no longer than 128 characters.
  - **Choose how readers should be granted access to this package’s subscription**:

    - **Email** \- grant access based on a group access code and your customers’ email domain. This process provides customer access away from the office and from all their devices while logged in  
      to their corporate account.

      - **Email domain** \- enter the email domain for your group subscription.
      - **Login ID** \- enter the user’s unique user identifier (UUID), an alphanumeric element. You can find it in **Subscriptions** \> **Customers** \> **Identity** \> your desired customer.
      - **Product** \- choose the product this subscription applies to. To create or adjust a product, see [Managing products](https://docs.arcxp.com/en/products/subscriptions/arc-xp-subscriptions-retail/managing-products.html).
    - **IP Address (CIDR Block IPv4 or IPv6)** \- specify network ranges using CIDR (Classless Inter-Domain Routing) notation to grant automatic subscription access to users connecting from those IP addresses.

      - **IP Address (CIDR Block IPv4 or IPv6)** \- enter an IP address or a range of IP addresses.
      - **Require reader to sign in** \- toggle on and customers who are on the CIDR block automatically get access to the Product entitlement.
      - **Product** \- choose the product this subscription applies to. To create or adjust a product, see [Managing products](https://docs.arcxp.com/en/products/subscriptions/arc-xp-subscriptions-retail/managing-products.html).
4. Click **Save**. An access code appears on the screen.
5. Copy and paste the Access code into an email to the customer, so their team can enter your site using this subscription.

When the company’s employees receive their group package notification, they must enter the following information on a login page:

- **Access code** \- send the code that appears after configuring the group.
- **Verified email** \- have their email address confirmed or validated.
- **Matching domain** \- have an email domain that matches the one specified for the group package.

### Editing a group package

To edit an existing group package, complete the following:

1. Navigate to **Subscriptions** \> **Retail** \> **Group packages**. The Group Packages page opens.
2. Click the ellipsis icon ![icon_ellipsis.png](https://docs.arcxp.com/images/learning-center/image/img-36e988534106c557aab2119deabbbed2.png) \> **Edit**. The group package configuration window opens.
3. Edit any of the following fields:  
If an email domain package:

  - **Package name** \- enter a name for the group package no longer than 128 characters.
  - **Email domain** \- enter the email domain for your group subscription.
  - **Login ID** \- enter the user’s unique user identifier (UUID), an alphanumeric element. You can find it in **Subscriptions** \> **Customers** \> **Identity** \> your desired customer.
  - **Product** \- choose the product this subscription applies to. To create or adjust a product, see [Managing products](https://docs.arcxp.com/en/products/subscriptions/arc-xp-subscriptions-retail/managing-products.html).  
If an IP address package:

  - **Package name** \- enter a name for the group package no longer than 128 characters.
  - **IP Address (CIDR Block IPv4 or IPv6)** \- enter an IP address or a range of IP addresses.
  - **Require reader to sign in** \- toggle on and customers who are on the CIDR block automatically get access to the Product entitlement.
  - **Product** \- choose the product this subscription applies to. To create or adjust a product, see [Managing products](https://docs.arcxp.com/en/products/subscriptions/arc-xp-subscriptions-retail/managing-products.html).
4. Click **Save**.

### Copying a group package

To copy a group package and its settings, complete the following:

1. Navigate to **Subscriptions** \> **Retail** \> **Group packages**. The Group Packages page opens.
2. Click the ellipsis icon ![icon_ellipsis.png](https://docs.arcxp.com/images/learning-center/image/img-36e988534106c557aab2119deabbbed2.png) \> **Copy**. The group package configuration window opens.
3. Enter a name for the new group package.  
The other settings can remain the same.
4. Click **Save**.

Copy and paste the Access code in an email to the customer, so their team can enter your site using this subscription.

### Deleting a group package

To delete a group package, complete the following:

1. Navigate to **Subscriptions** \> **Retail** \> **Group packages**. The Group Packages page opens.
2. Click the ellipsis icon ![icon_ellipsis.png](https://docs.arcxp.com/images/learning-center/image/img-36e988534106c557aab2119deabbbed2.png) \> **Delete**. The Delete Group Package window opens.
3. Click **Yes, delete** to confirm your choice.

The group package is no longer available in the main **Group Packages** page. This action cannot be undone.

### Managing enterprise groups

To manage enterprise group subscriptions, Arc XP offers API endpoints. To learn more, refer to the [Subscriptions API documentation](https://dev.arcxp.com/api/subscriptions-apis/) and the `developer_sales` endpoint.

### Managing associate subscriptions

Associate subscriptions allow regular subscribers to offer seat-based licenses.

When configuring your products, you can specify how many users the subscription owner can share their subscription with. The subscriber maintains soul ownership of the subscription and can share and rotate their benefit with the allotted number of people.

Each associate subscriber creates their account and password.