> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fusioncore.us/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating Benefit Allocations

> Add beneficiaries to a Purchase Activity using the Add Benefit quick action.

## How to Create a Benefit Allocation

<Steps>
  <Step title="Open the Purchase Activity">
    Navigate to the **Purchase Activity** record detail page.

    * In the **Benefits** section of the details, the **Active Beneficiaries** field (`Active_Beneficiaries__c`) shows how many beneficiaries are currently assigned.
    * The **Maximum Allocations** field (`Maximum_Allocations__c`) shows the maximum number of beneficiaries allowed on this Purchase Activity. This is the cap copied from the Product, and it is the limit enforced for this purchase.

    <Frame caption="The Benefits section on a Purchase Activity">
      <img src="https://mintcdn.com/fusionspan/4u-JGPkRA8QDMGYi/images/end-user-guides/4845338643/Screenshot_2025-01-10_at_4.11.16-PM.png?fit=max&auto=format&n=4u-JGPkRA8QDMGYi&q=85&s=4badc70761d2352880ce6323130b61af" alt="The Benefits section of a Purchase Activity showing the Active Beneficiaries and Maximum Allocations fields" width="1458" height="1126" data-path="images/end-user-guides/4845338643/Screenshot_2025-01-10_at_4.11.16-PM.png" />
    </Frame>
  </Step>

  <Step title="Click Add Benefit">
    At the top-right of the Purchase Activity record detail page, click **Add Benefit**.

    <Frame caption="The Add Benefit action on a Purchase Activity">
      <img src="https://mintcdn.com/fusionspan/4u-JGPkRA8QDMGYi/images/end-user-guides/4845338643/Screenshot_2025-01-10_at_4.12.42-PM.png?fit=max&auto=format&n=4u-JGPkRA8QDMGYi&q=85&s=a3c1e6c325f833928d6f1562e8ef8950" alt="The Add Benefit button at the top right of a Purchase Activity record" width="794" height="278" data-path="images/end-user-guides/4845338643/Screenshot_2025-01-10_at_4.12.42-PM.png" />
    </Frame>
  </Step>

  <Step title="Define the individuals">
    **Define the individuals** who will receive the benefit, then click **Next**.

    <Frame caption="Selecting the individuals to receive the benefit">
      <img src="https://mintcdn.com/fusionspan/4u-JGPkRA8QDMGYi/images/end-user-guides/4845338643/Screenshot_2025-01-10_at_4.13.35-PM.png?fit=max&auto=format&n=4u-JGPkRA8QDMGYi&q=85&s=0ce09ba55165e5b74b1402524d52bfbf" alt="The Add Benefit dialog listing the individuals available to receive the benefit" width="1566" height="674" data-path="images/end-user-guides/4845338643/Screenshot_2025-01-10_at_4.13.35-PM.png" />
    </Frame>

    <Info>
      The individuals shown in this section are only active Contacts within the Account who do not already have an active Benefit Allocation for the same Purchase Activity.
    </Info>
  </Step>

  <Step title="Set the start and end dates">
    Fill in the appropriate **start and end date**, then click **Next**. These set the `Benefit_Start_Date__c` and `Benefit_End_Date__c` fields on the new `Benefit_Allocation__c` record.

    <Frame caption="Setting the benefit start and end dates">
      <img src="https://mintcdn.com/fusionspan/4u-JGPkRA8QDMGYi/images/end-user-guides/4845338643/Screenshot_2025-01-10_at_4.14.48-PM.png?fit=max&auto=format&n=4u-JGPkRA8QDMGYi&q=85&s=81b03c056342039d925acff787934889" alt="The Add Benefit dialog with the start and end date fields" width="1554" height="684" data-path="images/end-user-guides/4845338643/Screenshot_2025-01-10_at_4.14.48-PM.png" />
    </Frame>

    <Info>
      The start and end dates of the benefit must match the subscription start and end dates.
    </Info>
  </Step>

  <Step title="Confirm the Benefit Allocation">
    Your **Benefit Allocation** has been created. Click **Close**.

    <Frame caption="The created Benefit Allocation">
      <img src="https://mintcdn.com/fusionspan/4u-JGPkRA8QDMGYi/images/end-user-guides/4845338643/Screenshot_2025-01-10_at_4.17.21-PM.png?fit=max&auto=format&n=4u-JGPkRA8QDMGYi&q=85&s=b8e97c64e61e07cc4eee50e54532c178" alt="Confirmation that the Benefit Allocation has been created" width="1574" height="438" data-path="images/end-user-guides/4845338643/Screenshot_2025-01-10_at_4.17.21-PM.png" />
    </Frame>
  </Step>
</Steps>

## Limitations and Common Pitfalls

* **You cannot exceed Maximum Allocations.** Adding more beneficiaries than the Purchase Activity's **Maximum Allocations** is blocked with a validation error.
* **Benefit dates must match the subscription.** The benefit start and end dates must match the subscription's start and end dates.
* **Only eligible Contacts appear.** The selector shows only active Contacts on the Account that do not already have an active allocation for the same Purchase Activity.
