> ## 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.

# Photo Overview

> The processing pipeline for sources, importing, processing, and publishing your event photos.

## Overview

The **Overview** tab is the control centre for 9Pic Photo. It is where you connect image sources, import photos into 9Pic, run AI processing (face recognition, bib detection, optional watermarking), and publish the event so participants can search and download their photos.

The tab has two regions: a **status strip** at the top, and the **four-step processing pipeline** below it.

![Photo Overview tab showing the status strip and four pipeline cards for watermark setup, import photos, process photos, and publish event](https://assets.9pic.ai/docs/dashboard-guide/photos/overview-tab.webp)

Photo Overview pipeline

## The Status Strip

The strip across the top summarises where your photos are in the pipeline:

| Stat | What it means |
| - | - |
| **Total** | Every photo imported into this event |
| **New** | Imported but not yet processed |
| **In Progress** | Being processed right now |
| **Failed** | Hit an error. Use the download icon on the **Failed** chip to export the list, then re-run |
| **Completed** | Processed and ready to publish |

A progress bar shows the percentage completed (Completed ÷ Total). While a step is running, the overview refreshes automatically; you can pause auto-refresh or refresh now.

## The Four-Step Pipeline

The pipeline runs top to bottom. Each step is a card that shows its status, a primary action, and a recommended-next highlight so you always know what to do next.

**1. Step 1 — Watermark Setup (optional)**

Add a logo, sponsor strip, or (on events selling photos through 9Pic Checkout) copyright text that is burned onto every processed photo. The card asks *Add a watermark to every photo?*: click **Add Watermark** to set it up and click **Save watermark**, then **Generate Preview** to check placement on your event photos before processing. Click **Skip** if you don't need branding. See [Branding](https://docs.9pic.ai/products/photo/watermark.md).

**2. Step 2 — Import Photos**

Connect your photo **sources** and pull photos into 9Pic. The **Sources** panel lives inside this card. Click **Import Photos** to bring in new photos; it only pulls what's new, so it's safe to re-run. Only .jpg and .jpeg files are supported.

**3. Step 3 — Process Photos**

Click **Start Processing** to run AI processing on imported photos: face recognition, bib detection, and watermarking (if configured). The dialog lets you process every pending photo or a custom batch, and shows the credits needed against your balance. Processing uses credits when Selfie or Bib search is on. See [Credit costs](https://docs.9pic.ai/account/credits/costs.md).

**4. Step 4 — Publish Event**

Click **Publish**, review the **Pre-Flight Check**, tick *I confirm all of the above* and click **Publish** to make processed photos live for participants. Only processed photos appear; newly imported ones stay hidden until you process them. After you process more photos, click **RePublish** to make them live. Use **Unpublish** to take the event offline again, or **Open event** to open the participant page.

> [!NOTE]
>
> The pipeline highlights the **recommended next step**. You don't have to follow it in strict order, but Publish needs at least one processed photo.

## Managing Sources (Step 2)

Sources tell 9Pic where your event photos live. After connecting a source, click **Import Photos** to bring in new photos.

**1. Open the sources**

In the **Sources** panel on the **Import Photos** card, click **Add source** (or **Manage** to edit existing ones). This opens **Image Sources**.

**2. Add a source**

Click **Add Source**, pick a **Source Type**, give it a **Source Name**, and paste the **Source URL** for the folder you want to import.

**3. Confirm the source is Live**

After saving, make sure the source shows **Live**. A source set to **Skip** is paused and won't import. If something looks wrong, reopen the source and fix the link or the folder's sharing settings.

**4. Import**

Back on the Overview tab, click **Import Photos** to pull photos in.

| Source type | What to paste |
| - | - |
| **Google Drive** | The folder link from **Share → Copy link**, shared with *Anyone with the link* as Viewer. Google Photos and single-file links don't work |
| **Dropbox** | The shared folder link from **Share → Copy link**, set to *Anyone with link* / *can view*. Not the address-bar link |
| **OneDrive** | The OneDrive or SharePoint shared folder link from **Share → Copy link**, shared with *Anyone with the link* |
| **9Pic Uplink** | Photographers upload straight to 9Pic from their browser or the desktop app. See [9Pic Uplink](https://docs.9pic.ai/products/uplink/overview.md) |

> [!NOTE]
>
> To have photographers upload directly instead of using a cloud folder, click **Upload photos** in the Sources panel. It opens [9Pic Uplink](https://docs.9pic.ai/products/uplink/overview.md), where you share a web upload link or desktop app details.

> [!WARNING]
>
> Point each source at the **single folder** for this event. If a source points at the wrong folder, participants may see photos from another event. Always verify the folder before processing.

## If Publish Fails on Rotated Images

When publishing stops because the AI flagged rotated photos, the **Publish Event** card shows two extra buttons:

* **Open AI Analysis** — jump to the rotation review tool to fix orientations. See [AI Image Analysis](https://docs.9pic.ai/products/photo/ai-analysis.md).
* **Skip AI Analysis** — confirm **Skip and Go Live** to publish anyway, leaving the flagged images as-is.

## Common Questions

> [accordion] Can I run Import Photos more than once?
>
> Yes. **Import Photos** only brings in new photos, so it's safe to re-run after you add more photos to a source.

> [accordion] Does processing change my originals?
>
> No. Processing creates searchable, optionally watermarked copies. Your original files stay in your source.

> [accordion] Why is Publish disabled?
>
> Publish needs at least some processed photos. Finish Step 3 (Process Photos) first. If processing is paused, check your [credit balance](https://docs.9pic.ai/account/credits/overview.md).

> [accordion] How do I take an event offline?
>
> Click **Unpublish** on the **Publish Event** card. The event moves back to draft and participants can no longer access photos until you publish again.

## Next Steps

> [card] [Configuration](https://docs.9pic.ai/products/photo/configuration.md)
>
> Search methods, display options, downloads, and bib detection.

> [card] [Watermark](https://docs.9pic.ai/products/photo/watermark.md)
>
> Logo, sponsor-strip and copyright-text watermarks.

> [card] [Download & Delete](https://docs.9pic.ai/products/photo/download-delete.md)
>
> Download originals and permanently remove photos.

> [card] [AI Image Analysis](https://docs.9pic.ai/products/photo/ai-analysis.md)
>
> Review and fix rotated photos flagged during publish.


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