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

# What Is the Gameball Family Wallet?

> Learn how the Family Wallet lets customers pool loyalty points with family members or groups to earn and redeem rewards together.

| Platform             | Plan                                                   |
| -------------------- | ------------------------------------------------------ |
| Shopify              | Add-on (Contact [Support](mailto:support@gameball.co)) |
| Salla                | Add-on (Contact [Support](mailto:support@gameball.co)) |
| Non-platform Clients | Add-on (Contact [Support](mailto:support@gameball.co)) |

**Gameball's Family Wallet** allows customers to link their loyalty accounts with family members or a group, combining all earned points into a single shared wallet. Everyone contributes to the same balance and any member can redeem from it — making it easier for groups to reach rewards faster.

***

## How It Works for Customers

The Family Wallet guides customers through three steps: copy their invite link, share it with a family member, and start earning rewards together.

<div style={{maxWidth: '380px'}}>
  <Frame>
    <img src="https://mintcdn.com/gameball/we1mLcbMGjuvcffb/images/product-docs/family-wallet/family-wallet-invite-flow.png?fit=max&auto=format&n=we1mLcbMGjuvcffb&q=85&s=eee6454e3672d630b85ee001380709da" alt="Family Wallet invite flow showing copy link, invite members, and get rewards together steps" width="646" height="1062" data-path="images/product-docs/family-wallet/family-wallet-invite-flow.png" />
  </Frame>
</div>

The Family Wallet is accessible from the Gameball widget. Customers find it on their profile home screen alongside their points balance, tier progress, and referral section.

<div style={{maxWidth: '380px'}}>
  <Frame>
    <img src="https://mintcdn.com/gameball/we1mLcbMGjuvcffb/images/product-docs/family-wallet/family-wallet-widget-home.png?fit=max&auto=format&n=we1mLcbMGjuvcffb&q=85&s=ee5c0b6a06d2a4d441bedd1dc2bdc049" alt="Family Wallet entry point on the Gameball widget home screen" width="776" height="1432" data-path="images/product-docs/family-wallet/family-wallet-widget-home.png" />
  </Frame>
</div>

When a customer shares their invite link, the invited member lands on an acceptance page where they enter their email or mobile number and click **Accept Invitation**.

<Frame>
  <img src="https://mintcdn.com/gameball/we1mLcbMGjuvcffb/images/product-docs/family-wallet/family-wallet-join-invitation.png?fit=max&auto=format&n=we1mLcbMGjuvcffb&q=85&s=ef7f3787f96b82f6e6167c231c134650" alt="Invitation acceptance page showing email or mobile input and joining benefits" width="1902" height="836" data-path="images/product-docs/family-wallet/family-wallet-join-invitation.png" />
</Frame>

Once confirmed, they see a success screen letting them know they have joined the Family Wallet.

<Frame>
  <img src="https://mintcdn.com/gameball/we1mLcbMGjuvcffb/images/product-docs/family-wallet/family-wallet-join-confirmation.png?fit=max&auto=format&n=we1mLcbMGjuvcffb&q=85&s=efc4cee9fe211ab469e3f2544163ab7e" alt="Confirmation screen showing successful Family Wallet join" width="1890" height="795" data-path="images/product-docs/family-wallet/family-wallet-join-confirmation.png" />
</Frame>

<Note>
  Each invite link can only be used by one person. A new link is generated automatically after each use.
</Note>

***

## Family Wallet Roles

Every Family Wallet has two types of participants:

| Role                      | Permissions                                                                               |
| ------------------------- | ----------------------------------------------------------------------------------------- |
| **Parent (Family Owner)** | Invites members, removes members, deletes the wallet, views full combined points history  |
| **Member**                | Earns and redeems from the shared wallet, views own points history, can leave at any time |

There is always one Parent per Family Wallet — the customer who created it. From your Gameball dashboard, you can transfer the Parent role to a different customer at any time.

***

## Earning, Redeeming, and Viewing Points

**Earning** — Points earned by the Parent and all members across all Gameball programs and modules are combined into the shared wallet. Groups accumulate points faster than they would individually.

**Redeeming** — Both the Parent and members can redeem from the combined wallet at any time, with no approval required from other members.

**Viewing the wallet** — Each member can see their individual points alongside the combined family balance. The Parent sees the full activity history; members see only their own.

<div style={{maxWidth: '380px'}}>
  <Frame>
    <img src="https://mintcdn.com/gameball/we1mLcbMGjuvcffb/images/product-docs/family-wallet/family-wallet-my-family-view.png?fit=max&auto=format&n=we1mLcbMGjuvcffb&q=85&s=5a1a79e2c2af44bfc6247b2affa187e4" alt="My Family widget view showing combined points, individual points, and members list" width="430" height="751" data-path="images/product-docs/family-wallet/family-wallet-my-family-view.png" />
  </Frame>
</div>

Members can leave the Family Wallet at any time by tapping **Leave** on the My Family screen.

<div style={{maxWidth: '380px'}}>
  <Frame>
    <img src="https://mintcdn.com/gameball/we1mLcbMGjuvcffb/images/product-docs/family-wallet/family-wallet-leave-wallet.png?fit=max&auto=format&n=we1mLcbMGjuvcffb&q=85&s=9dd3f70f91ad03cc8a91e71010521f3a" alt="Leave wallet confirmation screen asking the member to confirm they want to leave" width="421" height="746" data-path="images/product-docs/family-wallet/family-wallet-leave-wallet.png" />
  </Frame>
</div>

***

## Enabling the Family Wallet

The Family Wallet is an add-on feature. Once purchased, you can enable it from your dashboard:

<Steps>
  <Step title="Go to Settings">
    In your Gameball dashboard, navigate to **Settings**.
  </Step>

  <Step title="Open the Customers section">
    Under **Customers**, locate the **Family Wallet** option.
  </Step>

  <Step title="Enable the feature">
    Click the toggle to enable Family Wallet for your customers.
  </Step>
</Steps>

Once enabled, customers can create and join Family Wallets directly from the widget.

***

## Monitoring Family Wallets on Your Dashboard

From any customer profile in your Gameball dashboard, you can see that customer's Family Wallet details — including total family points, the number of members, and each member's role.

<Frame>
  <img src="https://mintcdn.com/gameball/we1mLcbMGjuvcffb/images/product-docs/family-wallet/family-wallet-dashboard.png?fit=max&auto=format&n=we1mLcbMGjuvcffb&q=85&s=acc25f0c478939cf55cb5cb65b815f07" alt="Customer profile showing Family Wallet section with total family points and member list" width="1914" height="1450" data-path="images/product-docs/family-wallet/family-wallet-dashboard.png" />
</Frame>

***

## Important Notes

<Note>
  **Maximum size:** A Family Wallet can have a maximum of 10 members, including the Parent.
</Note>

<Warning>
  **Parent account deletion:** If the Parent's account is deleted, the entire Family Wallet is deleted. All members revert to standard individual accounts and their points are no longer pooled.
</Warning>

<Note>
  **Changing the Parent:** If you need to transfer ownership to a different customer, a dashboard admin can make that change directly from the customer profile.
</Note>

***

## Common Questions

<AccordionGroup>
  <Accordion title="Can a customer be part of multiple Family Wallets?">
    No. Each customer can belong to only one Family Wallet at a time, either as a Parent or as a Member.
  </Accordion>

  <Accordion title="What happens when a member leaves the Family Wallet?">
    The member's account reverts to an individual account. Points they earned while in the Family Wallet remain in the shared wallet and are not returned to them.
  </Accordion>

  <Accordion title="Can members redeem points without the Parent's approval?">
    Yes. Both the Parent and members can redeem from the combined wallet at any time without requiring approval from one another.
  </Accordion>

  <Accordion title="What happens to the Family Wallet if the Parent account is deleted?">
    The Family Wallet is deleted and all members revert to standard individual accounts.
  </Accordion>

  <Accordion title="How do I get the Family Wallet for my store?">
    The Family Wallet is an add-on feature. Contact [Gameball support](mailto:support@gameball.co) to add it to your plan.
  </Accordion>
</AccordionGroup>

***

## Related Articles

<CardGroup cols={2}>
  <Card title="Launch Your Earn Program" icon="coins" href="/product-documentation/programs/loyalty-points-earn/launch-and-configure-your-earn-pointing-system">
    Set up how customers earn points across your store.
  </Card>

  <Card title="Configure Redemption" icon="gift" href="/product-documentation/programs/loyalty-points-redeem/launch-and-configure-your-redeem-pointing-system">
    Define how customers redeem their points for rewards.
  </Card>

  <Card title="Explore a Customer Profile" icon="user" href="/product-documentation/understanding-your-customers/customer-profile/explore-and-manage-a-customer-profile">
    View Family Wallet details and manage customer accounts from the dashboard.
  </Card>

  <Card title="Export Customer Activities Log" icon="file-csv" href="/product-documentation/understanding-your-customers/your-customers/export-customer-activities-log">
    Family redemption data is included in the activities export.
  </Card>
</CardGroup>
