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

# Buyer Photo Options

> Let buyers pick extra photos, refresh search for new uploads, and use a curated pool at checkout.

> [!WARNING]
>
> 9Pic Checkout is a **Business plan** feature. Buyer photo options are configured on the **Configuration** tab and require an assigned payment gateway first.

## Overview

Beyond the photos in their purchased package, buyers can optionally add more photos at checkout. Configure these on **Configuration → Buyer options**. All features here are optional — checkout works without them.

| Feature | What it does |
| - | - |
| **Pick from the full library** | Buyers hand-pick extra photos from the full event library |
| **Curated generic photo pool** | Buyers add organiser-chosen generic photos (start line, group shots, and similar) |
| **Refresh search results** | Buyers re-run search later as new photos are uploaded — the main setting for multi-day events |

## Library selection

When enabled, buyers can browse the full event photo library and hand-pick additional photos during checkout.

| Setting | What it controls |
| - | - |
| **Pick from the full library** | Turns the feature on or off |
| **Max photos per buyer** | Upper limit on how many library photos a buyer can add (1–200). A number outside that range blocks saving |

> [!NOTE]
>
> Library selection uses photos already in your event. Buyers see the same library they would search on the public event page.

> [!WARNING]
>
> Turning off a saved library selection asks you to confirm first (**Disable option** or **Keep enabled**). Once you save, buyers no longer see the library picker; your max-photos limit is kept.

## Curated pool

A **curated pool** is a set of organiser-chosen photos — start-line shots, group photos, b-roll, and similar — that buyers can add at checkout.

| Setting | What it controls |
| - | - |
| **Curated generic photo pool** | Turns the feature on or off |
| **Pricing** | **Free for buyers** or **Priced like normal photos** |
| **Manage photos** | Opens the curated pool manager to add or remove photos (up to 500) |

Click **Manage photos** (it shows how many photos the pool has) to open the photo picker. Select photos from the event library to include in the pool. Adding and removing pool photos saves straight away, separately from **Save changes**; an empty pool isn't shown to buyers.

### Curated pool pricing modes

| Mode | Buyer experience |
| - | - |
| **Free for buyers** | Curated pool photos cost nothing to add |
| **Priced like normal photos** | Curated pool photos follow your package pricing |

## Search refresh (multi-day events)

**Refresh search results** is the main checkout setting for multi-day events and any event where photos keep arriving after buyers already purchased.

When it is on, eligible buyers see a **Find new photos** option on their purchase. They can search again so newly uploaded photos (for example from a later race day) can be added to the same package, without changing the photos they already have.

| Setting | What it controls |
| - | - |
| **Refresh search results** | Event-wide permission for every eligible completed purchase |

### How refresh works for buyers

* Buyers can refresh **every 12 hours** after a successful refresh (or immediately on first refresh when eligible).
* Their **original bib stays locked** for that purchase — they cannot switch to a different bib on later refreshes.
* They may try a **new selfie**. It is checked against the selfie already accepted for the purchase before new matches are added.
* Refresh only adds photos within **remaining package capacity**. If the package is already full, refresh is not available until capacity remains.
* For **pre-event** packages, the buyer must **claim** their initial photos before refresh is available.

The **Buyer options** menu item counts this switch with the other two, for example **2 / 3**.

> [!TIP]
>
> Turn this on for multi-day festivals, multi-day races, or any event where photographers keep uploading after early sales. Buyers who already paid can return later and pull in photos that were not available at purchase time.

### Admin control for one purchase

Event-wide refresh is not the only control. On a single order's detail page you can grant or adjust **Buyer refresh access** for that purchase only — useful when a buyer needs an immediate re-search and should not wait for the 12-hour window.

See [Order detail](https://docs.9pic.ai/products/checkout/transaction-detail.md#buyer-refresh-access) for the per-order actions and search history.

## Saving changes

Switches, the max-photos limit and the pool pricing wait until you save. A bar at the bottom of the page says **You have unsaved changes**: **Save changes** saves them (together with any waiting video clip, tax or webhook changes) and **Discard** reverts them. Moving to another Configuration section keeps your changes; leaving the tab asks first.

## Common Questions

> [accordion] Why are buyer photo options locked?
>
> Assign and save a payment gateway first. These features are stored on the event's payment configuration, which does not exist until a gateway is assigned.

> [accordion] Can I use library selection and curated pool together?
>
> Yes. Both can be active at the same time. The Overview tab shows **2 options active** when both library selection and curated pool are on, and the **Buyer options** menu item counts all three switches, including search refresh.

> [accordion] Do curated pool photos replace package photos?
>
> No. They are extras buyers can add on top of what their package includes.

> [accordion] When should I enable search refresh?
>
> Enable it when more photos will appear after buyers may already have purchased — multi-day events, staggered uploads, or long post-event publishing windows. Leave it off for short, fully uploaded single-day sales if you do not want buyers re-searching later.

> [accordion] Does search refresh let a buyer change their bib?
>
> No. The bib used for the purchase is locked. Refresh re-runs search for that same bib (and optional selfie checks) so new matching photos can be added within remaining package capacity.

## Next Steps

> [card] [Checkout Configuration](https://docs.9pic.ai/products/checkout/configuration.md)
>
> Gateway, packages, and enable checkout.

> [card] [Packages](https://docs.9pic.ai/products/checkout/packages.md)
>
> Define what buyers purchase first.

> [card] [Order detail](https://docs.9pic.ai/products/checkout/transaction-detail.md)
>
> Grant buyer refresh access for one purchase.

> [card] [Transactions](https://docs.9pic.ai/products/checkout/transactions.md)
>
> See how buyers selected library or curated photos in orders.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.