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

# 9Pic Motion

> Search-based video clipping that finds each participant's moments in event footage by selfie, bib number or video name.

## Overview

9Pic Motion finds participants in event footage and gives each one their own video clips. Participants search with a **selfie**, with their **bib number**, or both, depending on the search methods you turn on. It is available on **Pro, Business and Enterprise**; Trial and Pay As You Go show an upgrade prompt.

Open **9Pic Motion** in your event's product navigation. It has four tabs: **Overview**, **Configuration**, **Watermark**, and **Tools**. The Overview works like the Photo Overview: a status summary and four step cards, with the next step marked **Up next**.

## Prepare and Publish Videos

**1. Import event videos**

After videos are uploaded to this event's **9Pic Uplink** folders, choose **Import Videos**. This lists the new videos; it does not process them. Re-run import after new uploads. Videos already imported are skipped.

**2. Set up your watermark**

Optional. On the **Watermark Setup** card, choose **Add Watermark** or **Skip**. **Configure Watermark** opens the watermark page. Once you save a logo, new participant clips carry it automatically. **Generate Preview** and **View Preview** are an optional check of the exact look. If the logo couldn't be prepared for clips, processing stays switched off until you select **Try again** on the watermark page.

**3. Check orientation and process**

Choose **Start Processing**. The confirmation lists each new video once with a checkbox, all ticked by default; **Select all** clears or restores them, and an unticked video waits for a later run. Only ticked videos are priced and processed, up to 50 at a time; when more are waiting, the first 50 are ticked. Each row shows its length, size, orientation and cost (**Free**, a number of credits or **Already paid**); choose **Check** to open one and fix its orientation. Below the list are the **Credits required** and your **Available balance**, with your rate in a note. Confirm with **Process N videos**; it stays off until at least one video is ticked and you have enough credits (see [Processing credits](#processing-credits)). If only failed videos are left, the card offers **Retry Failed** instead, with the same cost check; it retries up to 50 failed videos per run.

Processing does only what your saved search methods use. **Processing prepares** shows which: **Video clips** always, **Selfie search** when Selfie Search is on and **BIB search** when **Find bibs automatically** is on. One that is off is struck through, with a **Change in Configuration** link. With only CSV clips on, videos are prepared for clipping only. Save your search methods first. Turning **Selfie Search** or **Find bibs automatically** on after a video was prepared for clipping only needs a **Reprocess** of that video (see below).

**4. Publish Motion**

Once at least one video is processed, choose **Publish** and confirm. The event goes live and participants can search for their clips with the search methods you saved. Use **RePublish** after processing more videos, or **Unpublish** to turn video search off. Unpublish also moves the event back to draft unless photos are published.

The summary above the steps shows how many videos are new, in progress, failed, and completed. It updates automatically during active work; **Refresh** checks it manually.

## The Videos Window

Choose **Manage** on the Import Videos card or **View Videos** on the Process Videos card. Search and filter the list (**All**, **New**, **In progress**, **Failed**, **Completed**), then select a video to watch it in the same window. **All videos** takes you back to the list.

| Video status | What you can do |
| - | - |
| **New** | Watch the original upload, fix its orientation, or choose **Process this video** |
| **Queued** | **Cancel processing** |
| **Processing** | Follow its progress |
| **Failed** | Read the error and choose **Retry** |
| **Ready** or **Live** | **Copy share link**, **Download** the processed video, or **Reprocess** it |

To fix a sideways video, use **Rotate left** or **Rotate right**, then choose **Save orientation**. Turning only changes the preview until you save. If you leave with an unsaved turn, you are asked to save or discard it.

### Processing credits

Processing a video uses your organisation's [credits](https://docs.9pic.ai/account/credits/overview.md). Each video costs its length in whole seconds, rounded down, times your rate: **1 credit per second** unless your organisation has an agreed rate. For example, a 61.3-second video costs 61 credits.

* **Before anything starts**, every processing confirmation shows each video's length and credits, the **Credits required**, your **Available balance** and your rate. A video can also show **Already paid** (a failed run whose credits are still held), **In progress** or **Free**.
* **Not enough credits:** the confirmation says how many more you need and offers **Add Credits**. A batch needs credits for every video in it; nothing is charged until it can all start.
* **Length couldn't be measured:** videos are measured when you import them. If a video says "Length couldn't be measured", choose **Import Videos** again, or email [support@9pic.ai](mailto:support@9pic.ai) if it still can't be measured. Other videos still start.
* **Refunds:** if processing fails for good, or you cancel a queued video, its credits come back automatically. Retrying a failed video doesn't charge again while its credits are still held.
* **Reprocessing** a finished video is charged again for its length. Reading bib numbers again from videos that are already processed is free.

Charges appear in **Credits & Billing → Usage report** (and in **Recent activity** on the Overview tab) as **Video Processing**, and refunds as **Video Processing refund**.

### Reprocess a video

Reprocess runs a processed video again from the start with your current settings. Use it when a video was processed before you turned on a search method, for example a video prepared for clipping only before you turned on **Find bibs automatically**.

**1. Open Reprocess**

Choose **Reprocess Videos** on the Process Videos card, or **Reprocess** on a ready video in the Videos window. The card also tells you how many videos were processed with no search on.

**2. Pick the videos**

Tick the videos to run again. From the card, videos processed with no search on are already ticked and marked "needs reprocessing". From a video's page, only that video is ticked.

**3. Start**

Read what will happen, what processing prepares and what it costs, then choose **Start Reprocessing**. Each video is charged again for its length. **Cancel** or **Back** starts nothing.

> [!WARNING]
>
> Until a video finishes reprocessing, participants can't play it or find clips in it. Its faces and bib numbers are found again from scratch, and it takes about as long as the first processing. Your other videos aren't affected. When it finishes, choose **RePublish** on the Publish Videos card.

> [!WARNING]
>
> Orientation locks once processing starts. Check every new video before you confirm processing.

## Configuration

The **Feature Configuration** card controls how participants find, watch and download videos. A menu on the left (a row across the top on a phone) shows one section at a time:

* **Search methods**: how participants find their clips.
* **Clips from your CSV**: your bib clips. It appears indented under Search methods, with the clip count, while **Bib Number Search** and **Clips from your CSV** are both on.
* **Clips**: how each clip is cut. The menu shows the clip length you chose.
* **Viewing and downloads**: what participants can watch and download.

Changes in every section apply when you choose **Save changes** on the bar that appears. **Discard** undoes them.

| Section | Setting | What it controls |
| - | - | - |
| Search methods | **Selfie Search** | Participants find clips with a selfie |
| Search methods | **Bib Number Search** | Participants find clips by bib number, using **Find bibs automatically**, **Clips from your CSV**, or both (see below) |
| Clips | **Clip length** | **Short** (up to 6 s), **Medium** (up to 10 s, default), **Long** (up to 20 s) or **Custom** |
| Clips | **Keep clips for** | How long clips stay available: 30, 60, 90 or 180 days |
| Clips | **Multiple clips per video** | Off gives each person their earliest appearance in a video. On gives every appearance, for example on a lap course |
| Viewing and downloads | **All videos** | Under **Video Clips** in your gallery, participants watch every processed event video instead of photos. Hidden while video clips are sold |
| Viewing and downloads | **Clip downloads** | Lets participants download their own clips (selfie and bib clips, including prepared clips) |
| Viewing and downloads | **Full video downloads** | Lets participants download the original full videos from All videos; needs All videos |

A published event must keep **Selfie Search** or **Bib Number Search** on; the page won't save with both off.

With **All videos** on, participants who pick **Video Clips** see a player and a grid of every processed video, in upload order, in place of the photos. Your Motion watermark logo shows over the player while they watch; the video files stay clean, so **Full video downloads** give the original video. All videos is hidden from participants while video clip selling is on in 9Pic Checkout, so full videos never give away the clips you sell.

### Clip length and multiple clips

Open **Clips** to choose how each participant's clip is cut.

| Clip length | Longest clip | Before each appearance | After each appearance |
| - | - | - | - |
| **Short** | 6 s | 1 s | 1 s |
| **Medium** (default) | 10 s | 2 s | 1 s |
| **Long** | 20 s | 3 s | 2 s |

Short, Medium and Long are fixed. Choosing one also resets matching to the defaults: 90% match confidence, a 2 s shortest appearance and gaps of up to 1 s joined.

Choose **Custom** to set your own numbers in **Custom length and matching**: **Match confidence (%)**, **Start padding (s)**, **End padding (s)**, **Shortest appearance (s)**, **Join gaps up to (s)** and **Longest clip (s)**. **Start from** Short, Medium or Long copies that preset's numbers so you can adjust them. Higher confidence means fewer wrong matches but more missed ones. While you edit, your Custom numbers are kept, so if you try a preset and then choose Custom again, they come back. Only the clip numbers are saved: next time the tab shows the preset they match, otherwise Custom.

Turn on **Multiple clips per video** only if the same person can appear more than once in a video, such as on a lap course. When it's off, each video gives the person their earliest appearance. When it's on, each video gives every separate appearance, in time order. This applies to selfie clips and to bibs found automatically.

**Keep clips for** sets how long clips stay available, at least 30 days. Clips from your CSV always use your exact start and end times, so Clip length doesn't change them.

Under **Bib Number Search**, turn on at least one of **Find bibs automatically** and **Clips from your CSV**; the page won't save bib search with neither. With both on, your CSV is used for any video where it has that bib, and bibs found automatically fill in the other videos.

### Bibs found in your videos

Turn on **Find bibs automatically** and choose **Save changes**. Videos processed from then on are read for bib numbers while they process. The **Bibs found in your videos** card is on the Motion **Tools** tab. Until Find bibs automatically is saved on, the Tools tab says so and offers **Go to Configuration**.

**1. Read videos you processed earlier**

Saving never starts reading by itself. If videos were processed before, the card lists them as **Not read yet**. Choose **Read bib numbers in N videos** and confirm with **Read bib numbers**. Bib numbers are read from the frames already saved, so nothing is uploaded or processed again; it takes about a minute per video and the card updates by itself. Use **Try again** for a video that couldn't be read. A video prepared for clipping only has nothing to read yet: the card marks it **Needs reprocessing** with **Reprocess in Overview**, and its bib numbers are read while it reprocesses.

**2. Check the bibs found**

**Searchable** lists the bibs participants can find, with the frames seen, the read quality (**Clear**, **Good** or **Fair read**), the videos and times, and a close-up. Use **Search bib**, the video filter and **Bib number** / **Most seen** sorting. Select a bib to see its frame with the bib boxed, where each video's clip comes from (**Your CSV**, **Found** or **Hidden**) and how many clips participants get.

**3. Review hidden bibs**

**Hidden** lists readings that can't be searched, with the reason: **Looks like a misread of** another bib, **Not on your participant list**, **Seen in only one frame** or **Seen too briefly to be sure**. If a hidden bib is a real runner, add it to your CSV.

**Detection settings** (folded at the bottom of the card) save with their own **Save and update list**:

* **Participant list**: **Use it when uploaded** (recommended), **Always** (only bibs on the list; nothing is searchable without one) or **Never**. Your list is the bibs with a name from the Name Search CSV in [Photo configuration](https://docs.9pic.ai/products/photo/configuration.md), or with results data.
* **Seen in at least**: 2 frames (recommended) or 3. A bib seen once is usually a misread; 3 frames can miss fast runners. A single very clear reading counts only when a participant list filters.
* **Read quality**: ignore readings below this; 90% is recommended.

Saving rebuilds the list from the readings you already have; nothing is read again. **Rebuild list** does the same without a change, for example when the card says the list needs a rebuild.

### Clips from your CSV

Turn on **Clips from your CSV** under **Bib Number Search** (turning on Bib Number Search turns it on when **Find bibs automatically** is off) and choose **Save changes**. An upload panel appears right under the switch, with **Download template**, **Upload CSV**, a summary of your clips and **View and manage N clips**, which opens the **Clips from your CSV** section. That section lists your clips and has the same upload buttons. Uploads and other actions there save straight away; they aren't part of **Save changes**. You can upload before you save the switch: the panel reminds you to save to turn on CSV clips.

1. Choose **Download template**. It has one row per video with its video ID and an empty bib.
2. Fill one row per bib and appearance: `bib_number`, `video_source` (the video ID, or the exact file name), `start_time`, `end_time` and an optional `label`. For example:

   ```csv theme={null}
   bib_number,video_source,start_time,end_time,label
   52662,37,00:00:36,00:00:46,Finish camera
   52851,03_closeups.mp4,00:36,00:46,Finish camera
   50427,36,56,66,Crowd camera
   53479,38,0:00:56.5,0:01:06,Road camera
   ```

   Use the video IDs from your own template: `37` here is a video ID, `03_closeups.mp4` a file name used by only one video in the event, and the rows show the three time forms below.
3. Times are positions in that video file, such as `00:01:02`, `01:02` (minutes and seconds) or `62` seconds. Clock times, dates and time zones are rejected. A clip can be up to 10 minutes. Format the time columns as text in your spreadsheet so `01:02` isn't turned into a clock time.
4. Choose **Upload CSV**, pick the file and, if you already have clips, **Replace all clips** or **Add to current clips**. Choose **Check file**: you see rows ready, rows with problems (with the row number and the reason), duplicates and warnings, plus a preview. Nothing is saved yet.
5. Choose **Import N clips** (or **Replace with N clips**). Rows with problems are skipped.

Files can be up to 5 MB and 50,000 rows, and an event can hold 50,000 clips. Use the bib search and the video chips to find clips, **Remove last import** to undo the most recent upload, or **Delete all clips**. If you upload a video again, clips on the old video are flagged; upload the CSV again with the new video's ID.

#### Prepare clips ahead

**How participants get these clips** at the top of the **Clips from your CSV** section has its own **Save**:

* **Cut when searched** (default): each clip is cut the first time someone opens it, so participants wait a few seconds.
* **Prepare ahead**: every clip is prepared in the background, so participants get it instantly. Set **Keep prepared clips for** 30 to 365 days (default 30). After that, clips are cut when searched again.

Choosing **Save and prepare N clips** starts at once, and new imports are prepared automatically. Clips are prepared at about one every 2 seconds. A strip shows how many are ready and refreshes by itself, and the **Status** column and status chips (Ready, Preparing, Waiting, Failed, Needs update, Expired) filter the list.

* **Retry N failed** tries failed clips again.
* **Update N clips** prepares again the clips marked **Needs update**, after you change the watermark, clip selling, preview quality, clip downloads or the number of days, or upload a video again. Changing the days doesn't extend existing clips.
* **Prepare N again** prepares expired clips again.

Until a clip is ready, participants still get it: it is cut when searched. Switching back to **Cut when searched** deletes nothing; prepared clips stop being used and expire on their own. Deleting or replacing clips removes their prepared clips too.

### What participants see

Once **Bib Number Search** is saved on and there is at least one CSV clip on a current video or one searchable bib found in a processed video, picking **Video Clips** in your gallery shows a bib field straight away, with **Find my videos** next to **Find with selfie** (when Selfie Search is on), the same layout as photo search.

* Participants type their bib. Letters, digits, spaces, `/` and `-` work, and case doesn't matter, but leading zeros do: `0123` and `123` are different bibs.
* They get one clip per CSV row for that bib, cut at your exact start and end times (Clip length doesn't apply), up to 20 per bib.
* For a bib found automatically, each video gives the bib's earliest pass, or every pass with **Multiple clips per video** on, cut with your **Clip length**, up to 20 clips per bib. A video where your CSV has that bib uses the CSV instead. Hidden bibs give no clips.
* With **Cut when searched**, clips are made the first time anyone searches that bib, so the first search takes about a minute. With **Prepare ahead**, ready clips appear instantly. Everyone who searches the same bib gets the same clips.
* If a video isn't ready yet, participants see "Videos are still being prepared" and can try again. A bib with no clips shows "No clips found".
* Bib clips use the same watermark, preview quality, **Purchase original videos** button and checkout as selfie clips. Clips are priced per clip, so a long clip costs the same as a short one.

After you upload a new CSV, change the watermark or replace a video, the next search makes fresh clips.

With **Selfie Search** on, a participant who searches photos with a selfie also sees **Find videos with selfie** on their photo results, which opens their clips with the same selfie. A bib number photo search finds photos only; for bib clips, participants pick **Video Clips**.

### Video name search

Use **Video name search** when each participant has their own edited video of up to 3 minutes (for example `RAHUL_SHARMA_1234.mp4`). Participants type a name or bib from the video's name and get that whole video as one clip, with no selfie. Keep selfie and bib search for long footage with many people in it.

**1. Choose the mode**

Open **Configuration**, then **Search methods**, choose **Video name** under **How participants search**, and select **Save changes**. Confirm "Turn on video name search?". Selfie Search, Bib Number Search and **All videos** turn off and stay off while it is on. You can't switch while videos are processing. If your event has 40 or more videos of about 3 minutes or less, the Overview suggests it; **Not now** hides the suggestion on that browser for that event.

**2. Check the search names**

Each video's search name starts as its file name without the extension. Open **Configuration**, then **Video names** (it appears once the mode is saved), then **Open Videos**, and use the pencil on a row to rename a video (1 to 100 characters). To change many at once, choose **Rename from CSV**: download the template, edit the `search_name` column, upload it, review the check, and select **Import**. Nothing is saved until you import, and renaming keeps a video's prepared clip.

**3. Process the videos**

**Start Processing** works as usual, with these differences: there is no orientation step, every new video up to 3 minutes starts in one go, and longer videos are skipped ("Longer than 3 minutes"), as are videos under 1 second ("Shorter than 1 second"). Processing costs **0.4 credits per second, at least 1 credit per video**, unless your organisation has its own rate. If you see "Processing was requested. Refresh in a minute to see progress.", nothing failed: refresh after a minute. Clips are prepared automatically, so participants get them instantly.

Participants see one **Search your video** field with **Find my videos**. The words they type must be the whole name or an unbroken run of whole words in it ("rahul sharma" or "1234" finds `RAHUL_SHARMA_1234`; "rah" finds nothing). Case, underscores, dashes and dots don't matter; they need at least 2 characters and see up to 20 videos, each labelled with its search name. Clips are sold like any video clip. A clip pass bought before the event covers only the videos whose full name matches what the buyer searches; a pass tied to a bib works by searching a name that contains that bib.

> [!WARNING]
>
> To switch back to selfie and bib search, choose **People in the videos** and save. Videos processed for video name search were prepared for clipping only, so selfie and bib search can't find anyone in them until you **Reprocess** them, which is charged again. Selfie Search and Bib Number Search stay off until you turn them on.

## Tips for Good Clips

* **Camera angles matter more than for photos.** A finish-line camera that sees faces head-on gives far better selfie clips than the same footage shot from above. For bib clips, bib numbers must be readable in the frame.
* **Trim footage before uploading.** Upload only the stretches where participants pass, such as the finish or start line. Processing is charged per second of video, so shorter footage is faster and uses fewer credits.
* **Test with one camera first.** Process one camera's videos, check the clips for a few real participants, then process the rest.

## Watermark

Open the watermark page with **Configure** on the **Watermark** tab's **Watermark** card, or from the Watermark Setup card. Choose what the watermark does:

* **Show my brand** puts your logo on videos. Pick the image, position, opacity and size, and check it in the live preview.
* **Protect videos for sale** repeats copyright text across videos until they are bought, using the same AI-resistant text overlay as Photo: choose **Recommended** or **Custom** in **Create text overlay**, then **Generate**. Any organiser can choose it; selling videos in [9Pic Checkout](https://docs.9pic.ai/products/checkout/overview.md) is up to you. Once saved, new participant clips carry the copyright text over the whole frame, landscape or portrait, and buyers get a clean video or one that keeps your logo, as set under **3. After purchase**.

For copyright text, step **3. After purchase** chooses what buyers get: a **Clean video**, or **Keep my logo**. Choose **Save watermark** to apply.

There are no switches for where the watermark shows. A saved logo goes on new participant clips automatically, and a downloaded clip keeps it. On the All videos page it shows over the player while participants watch (turn **All videos** on or off in Configuration); full video downloads are always the original file. You don't need to generate a preview first. If the logo can't be prepared for clips, your watermark is still saved and the page says new clips don't carry it yet; choose **Try again**. Changes apply to newly made clips and videos; earlier clips are not changed.

## Common Questions

> [accordion] Why is Publish unavailable?
>
> Import must finish and at least one video must complete processing. Check the Overview pipeline for the first incomplete step and wait for active work to finish.

> [accordion] How is Motion different from Flow?
>
> [9Pic Flow](https://docs.9pic.ai/products/flow/overview.md) creates personalised reels from templates and event media. Motion lets participants find their own moments in source footage by selfie or bib number.

> [accordion] Can my own website or app offer clip search?
>
> Yes. The 9Pic API offers the same selfie and bib clip searches your gallery uses, with the same clips, watermark and download settings. See [Video Clipping Search](https://docs.9pic.ai/api-reference/video-clipping-search.md). API keys are part of the Business plan.

> [accordion] Can I sell participant clips?
>
> On Business and Enterprise, add a **Video clips** price to the post-event [9Pic Checkout](https://docs.9pic.ai/products/checkout/overview.md#selling-motion-clips) package, or a clip pass to the pre-event package that participants pre-book before you publish the videos; publishing it puts clips on sale, and pausing it stops clip sales. You can price clips as soon as Motion is on for the event in Event Config; they go on sale once a watermark is saved (a logo, or copyright text with **Protect videos for sale**); no video needs to be processed first.

## Next Steps

> [card] [9Pic Flow](https://docs.9pic.ai/products/flow/overview.md)
>
> AI-generated highlight reels.

> [card] [Event details](https://docs.9pic.ai/products/events/details.md)
>
> How products and tabs work inside an event.


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