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

# Shareable Box URLs

> Share a pre-configured box via a unique link.

<Info>
  Shareable Box URLs is a **Pro feature**. [Upgrade to BoxBuilder Pro →](https://swiftlywp.com/plugin/boxbuilder-for-woocommerce/)
</Info>

BoxBuilder Pro lets customers share their box configuration with others via a unique URL. The recipient opens the link and sees the box pre-filled with the shared selections.

## How It Works

<Steps>
  <Step title="Customer builds a box">
    The customer adds items to their box as usual.
  </Step>

  <Step title="Click Share">
    A **Share** button in the box summary generates a unique URL.
  </Step>

  <Step title="Send the link">
    The customer copies the URL and sends it to someone (email, messaging, social media).
  </Step>

  <Step title="Recipient opens the link">
    The recipient visits the URL. The box builder loads with all the shared items pre-selected.
  </Step>

  <Step title="Recipient can modify and purchase">
    The recipient can keep the box as-is, modify it, add a gift message, and add it to their own cart.
  </Step>
</Steps>

## Use Cases

* **Gift registries**: "Here's the box I'd love — buy it for me!"
* **Recommendations**: "I made this chocolate selection for you, try it!"
* **Team orders**: "Fill your box like mine" — for corporate or group gifts
* **Social sharing**: Share curated boxes on social media

## Technical Details

* Share links use a unique 12-character key
* Shared box data is stored as a WordPress transient with a **30-day expiry**
* After 30 days, the link expires and shows a "this shared box has expired" message
* Share links are read-only — the original sharer's box is not affected by changes the recipient makes

## Share URL Format

```
https://yourstore.com/product/build-your-own-box/?boxbuilder_share=abc123xyz456
```

The `boxbuilder_share` parameter triggers the builder to load with the shared configuration.
