Video Details
# Video Details
## What This Page Does
This page gives you a complete view of a single video on your site. You can edit its title, description, categories, tags, models, thumbnails, chapters, scheduling, pricing, and SEO settings -- all from one place. You can also review how the video is performing, handle user reports, and preview the video using the built-in player.
[Screenshot: video-admin-details-full-modal-view]
---
## How to Get Here
1. Go to **Admin Panel > Content > Videos**.
2. Find the video you want to manage.
3. Click the video's thumbnail, title, or detail icon.
4. The Video Details panel opens on top of the video list.
---
## Understanding the Page
When you open Video Details, you see a panel with the video's ID number in a green badge and the video title at the top. Below that, the page is divided into multiple sections that you can show, hide, and reorder to match the way you like to work.
### Section Visibility Controls
At the top of the page, a green bar contains a row of toggle cards. Each card controls the visibility of one section on the page.
- **Toggle a section on or off** by clicking its switch.
- **Reorder sections** by dragging a card by its handle (the `::` icon) to a new position. The matching section on the page moves to follow.
- Your visibility and order preferences are remembered automatically, so the page looks the same every time you come back.
The available section toggles are: Player, Technical, Engagement, Analytics, Thumbnails, Chapters, Media, Metadata, Schedule, Sponsors, SEO & Social, Production, Content Flags, User Reports, Storage Server, and File Paths.
[Screenshot: video-admin-details-visibility-panel]
[tip]Hide sections you rarely use to keep the page clean and focused on what matters to you.[/tip]
### Auto-Save
Every field on this page saves automatically when you finish editing it. You do not need to click a save button. Just make your change and click somewhere else -- the update is saved right away.
[success]The **Save All Changes** button at the bottom is purely for visual reassurance. Clicking it briefly displays a confirmation message, but your changes were already saved the moment you finished typing or selecting.[/success]
---
## Common Tasks
### How to Edit the Video Title
1. Click on the video title at the top of the page.
2. Type your new title.
3. Click anywhere outside the title.
4. The new title is saved automatically.
### How to Change the Video Status
1. Find the **Status** dropdown in the Basic Information section.
2. Select one of the following:
- **Pending** -- The video is waiting to be processed.
- **Processing** -- The video is currently being converted.
- **Active** -- The video is live and visible on your site.
- **Error** -- Something went wrong during processing.
- **Deleted** -- The video is removed from public view.
3. The status updates automatically when you make your selection.
[info]Only videos set to **Active** appear on your site. All other statuses keep the video hidden from visitors.[/info]
### How to Set Who Can Watch the Video
1. Find the **Access Type** dropdown in the Basic Information section.
2. Choose one of the following:
- **Free** -- Anyone can watch, no account needed.
- **Members Only** -- Only logged-in members can watch.
- **Subscription** -- Only subscribers can watch.
- **Pay-Per-View** -- Visitors must pay to watch this video.
- **Private** -- Not visible to anyone on the public site.
3. The change saves automatically.
[tip]If you choose **Pay-Per-View**, scroll down to the Sponsors & Monetization section to set the price and currency.[/tip]
### How to Edit the Description
1. Scroll to the **Description** text box in the Basic Information section.
2. Click inside the text box and type or edit the description.
3. Click anywhere outside the box when you are done.
4. The description saves automatically.
### How to Manage Thumbnails
Your video's thumbnails are the small preview images visitors see when browsing your site.
#### Set the Main Thumbnail
1. Scroll to the **Thumbnails** section.
2. Browse the thumbnail gallery to find the image you want as the main poster.
3. Click the green **M** badge on that thumbnail.
4. Confirm your choice in the popup.
5. The selected thumbnail gets a pulsing green border showing it is now the main image.
[tip]Choose a clear, eye-catching thumbnail. This is the first image visitors see and it strongly affects whether they click to watch.[/tip]
#### Delete a Thumbnail
1. Click the red **D** badge on the thumbnail you want to remove.
2. Confirm the deletion in the popup.
[warning]Deleting a thumbnail is permanent and cannot be undone. The image is removed from storage entirely.[/warning]
#### View a Thumbnail Full Size
Click on any thumbnail image to open it in a full-screen viewer. Click anywhere outside the image or the close button to return to the page.
[Screenshot: video-admin-details-thumbnails]
### How to Add Video Chapters
Chapters are clickable markers on the video timeline that help viewers jump to specific parts of the video.
#### Add a Chapter at the Current Playback Position
1. Play the video in the built-in player and pause at the spot where you want a chapter to begin.
2. In the Chapters section, look at the **Current Video Time** display to confirm the position.
3. Click **Add Chapter Here**.
4. The chapter form opens with the timestamp already filled in.
5. Type a **Title** for the chapter (required).
6. Optionally add a **Description**.
7. Click **Save Chapter**.
[tip]This is the easiest way to add chapters. Just play the video, pause where you want the marker, and click the button.[/tip]
#### Add a Chapter Manually
1. Click **Add Chapter Manually** in the Chapters section.
2. Enter the timestamp in seconds (for example, `125.5` for 2 minutes and 5.5 seconds).
3. Click **Preview** to jump the player to that position and verify it looks right.
4. Type a **Title** and optional **Description**.
5. Click **Save Chapter**.
#### Edit a Chapter
1. Click the pencil icon on the chapter card you want to change.
2. Update the title, description, or timestamp as needed.
3. Click **Update from Player** if you want to re-sync the timestamp to the current player position.
4. Click **Save Chapter**.
#### Delete a Chapter
1. Click the trash icon on the chapter card.
2. Confirm the deletion in the popup.
[Screenshot: video-admin-details-chapters]
### How to Assign Categories
1. Scroll to the **Categories** card (near the bottom of the page).
2. Select a category from the dropdown.
3. Click **+ Add**.
4. The category appears as a badge. It is saved automatically.
5. To remove a category, click the **x** on its badge.
[info]You can assign up to 10 categories per video.[/info]
### How to Add Tags
1. Scroll to the **Tags** card.
2. Type a tag in the text field.
3. Press **Enter** or click **+ Add**.
4. The tag appears as a badge and is saved automatically.
5. To remove a tag, click the **x** on its badge.
#### Use Suggested Tags
1. Click the **Suggestions** button to see a list of popular tags.
2. Click any suggested tag to add it to the video instantly.
3. Click **Suggestions** again to close the panel.
[info]If you try to add a tag that already exists on the video, you will see an alert and the duplicate will not be added.[/info]
### How to Assign Models / Performers
1. Scroll to the **Models** card.
2. Type at least 2 characters of a model's name in the search field.
3. A dropdown of matching results appears after a brief pause.
4. Click the model you want to assign. Models already assigned to this video are grayed out.
5. The model appears as a badge and is saved automatically.
6. To remove a model, click the **x** on its badge.
#### Create a New Model
If the model you need does not exist yet:
1. Type the model name in the search field.
2. At the bottom of the search results, click **Create new model: [name]**.
3. The model is created and assigned to the video in one step.
### How to Schedule a Video
You can control when a video becomes visible and when it disappears from your site.
1. Scroll to the **Schedule** section.
2. Set a **Start Date** to choose when the video should appear on your site.
3. Set an **End Date** to choose when the video should stop being visible.
4. Both fields save automatically.
[tip]Leave these fields empty if you want the video to be visible at all times (as long as its status is Active).[/tip]
### How to Set Up Sponsors and Pricing
1. Scroll to the **Sponsors & Monetization** section.
2. Select a **Primary Sponsor** from the dropdown if this video is sponsored.
3. If your sponsor has sub-sponsors, a second dropdown appears automatically -- select the appropriate **Sub-Sponsor**.
4. Select a **Cam Site** if you want to link this video to a cam site.
5. Enter a **Price** if this is a pay-per-view video.
6. Choose the **Currency** (USD, EUR, GBP, CAD, AUD, or JPY).
### How to Configure SEO and Social Sharing
Good SEO settings help your videos appear in search engine results. Social sharing settings control how your videos look when shared on social media.
1. Scroll to the **SEO & Social Media** section.
2. Fill in the **Meta Title** (recommended: keep under 70 characters). A character counter shows your progress.
3. Fill in the **Meta Description** (recommended: keep under 160 characters). A character counter shows your progress.
4. Add **Meta Keywords** separated by commas.
5. Set the **URL Slug** for a clean, readable web address.
6. Fill in the **Open Graph** fields (Title, Description, Image) to control how the video appears when shared on Facebook and LinkedIn.
7. Fill in the **Twitter** fields (Title, Description, Image) to control how the video appears when shared on Twitter.
[tip]Keep your Meta Title under 70 characters and Meta Description under 160 characters. The live character counters help you stay within these limits so your content displays properly in search results.[/tip]
[Screenshot: video-admin-details-seo]
### How to Add Production Details
1. Scroll to the **Production Details** section.
2. Fill in any relevant fields:
- **Release Date** -- The official release date of the video.
- **Production Year** -- The year the video was produced.
- **Studio** -- The production studio name.
- **Director**, **Producer** -- Key production credits.
- **Series Name**, **Season Number**, **Episode Number** -- If the video is part of a series.
- **Orientation** -- Whether the video is landscape, portrait, or square.
### How to Mark Content Flags
1. Scroll to the **Content Flags & Optimization** section.
2. Check or uncheck the following as needed:
- **Copyright Claimed** -- Check this if the video has a copyright claim against it.
- **DMCA Notices** -- Enter the number of DMCA notices received.
- **SEO Optimized** -- Check this when you have completed the SEO fields.
- **Social Media Optimized** -- Check this when social sharing tags are configured.
- **Mobile Optimized** -- Check this if the video is confirmed to play well on mobile devices.
### How to Handle User Reports
When visitors report a problem with a video, those reports appear here.
1. Scroll to the **User Reports** section. A badge shows how many reports exist.
2. Review each report's details:
- **Reason** -- What the user reported (such as broken video, wrong category, copyright issue, and so on).
- **Reporter** -- The username of the person who filed the report.
- **Date** -- When the report was submitted.
- **Details** -- Any additional information the reporter provided.
3. Take action using the buttons on each report:
- **Mark Reviewed** -- You have seen the report and are looking into it.
- **Resolve** -- The issue has been fixed.
- **Dismiss** -- The report is not valid or no action is needed.
[warning]Take copyright and DMCA reports seriously. These may have legal implications. Always investigate before dismissing.[/warning]
[Screenshot: video-admin-details-reports]
### How to Write Admin Notes
1. Scroll to the **Admin Notes** section.
2. Type any internal notes about this video. These notes are only visible to administrators.
3. Click outside the text box. Notes save automatically.
[tip]Use admin notes to record why changes were made, flag issues for other team members, or keep track of report investigations.[/tip]
---
## Using the Built-In Video Player
The page includes a full video player so you can preview the video without leaving the admin panel.
### Basic Playback Controls
- **Play/Pause** -- Click the play button or press the spacebar.
- **Seek** -- Click or drag on the progress bar to jump to a specific point.
- **Volume** -- Adjust with the volume slider.
- **Fullscreen** -- Click the fullscreen button in the lower right corner.
### Changing Video Quality
If the video has multiple quality levels available:
1. Click the gear icon in the player's control bar.
2. Select the quality level you prefer, or choose **Auto** to let the player decide based on your internet speed.
### Debug Information
If you need to investigate playback issues:
1. Look at the stats bar above the player. It shows the current source type, quality level, player state, and buffer status.
2. Click **Debug Console** below the player for a detailed log of playback events.
3. Click again to hide the console.
[info]The player in the admin panel may behave slightly differently from the player your visitors see. Some features may be enabled or disabled specifically for the admin preview.[/info]
---
## Viewing Video Analytics
### Engagement Statistics
The Engagement section shows key numbers about how the video is performing:
| Stat | What It Tells You |
|------|-------------------|
| **Views** | How many times the video has been watched |
| **Likes** | How many users liked the video |
| **Dislikes** | How many users disliked the video |
| **Comments** | How many comments the video has received |
| **Rating** | The average star rating (1 to 5) and number of votes |
| **Downloads** | How many times the video has been downloaded |
| **Impressions** | How many times the video appeared on a page |
| **Clicks** | How many times visitors clicked on the video |
| **CTR** | Click-through rate -- the percentage of impressions that resulted in clicks |
#### Setting Override Values
Some stats (Views, Likes, Dislikes, Downloads, and Rating Votes) have an override field next to them. You can enter a minimum display value here for social proof. The actual tracked number is always shown separately so you know the real count.
1. Click the override input next to the stat you want to adjust.
2. Type your desired minimum value.
3. Click outside the field. The override saves automatically.
### Analytics & Performance
Click the **Analytics & Performance** section header to expand it. This section has three tabs:
#### Performance Tab
- **Watch Time & Engagement** -- Shows the average watch time, completion rate (what percentage of the video people watch), and bounce rate (what percentage of viewers left early).
- **Category Comparison** -- Shows how this video's completion rate compares to the average for videos in the same category.
- **Views Trend** -- A 30-day chart showing daily view counts.
- **Activity & Resources** -- Shows when the video was last watched and how much bandwidth it has used.
#### Processing Tab
Shows the video's processing history, including when processing started, when it finished, and how long it took.
#### Playlists Tab
Shows which playlists include this video, along with the video's position in each playlist. If the video is not in any playlists, a message tells you so.
---
## Media Assets
The Media Assets section shows additional files generated from your video:
- **Preview Video** -- A short clip that plays when visitors hover over the video thumbnail.
- **Poster Image** -- The main image displayed before the video plays.
- **Animated GIF** -- An animated preview loop.
- **Contact Sheet** -- A grid of frames from throughout the video.
Click on any image to view it full size.
[Screenshot: video-admin-details-media-assets]
---
## Additional Metadata
| Setting | What It Does |
|---------|-------------|
| **Featured** | Check this to display the video in featured sections and homepage carousels |
| **HLS Enabled** | Check this if the video uses adaptive streaming (automatically adjusts quality based on viewer's internet speed) |
| **CDN Distributed** | Check this if the video files are hosted on a content delivery network |
| **Original File Deleted** | Shows whether the original uploaded file was removed after processing (display only, not editable) |
---
## Storage and File Locations
### Storage Server
Shows where the video's files are currently stored, including:
- The server name and type
- The server group it belongs to
- The server's health status (shown as a colored indicator: green for healthy, amber for warning, red for problems)
- The total number of files stored for this video
### Moving Files to a Different Server
If you need to move the video's files to a different storage server:
1. Scroll to the **Storage Server** section.
2. In the migration panel, select a destination server from the dropdown. Servers are grouped by server group and show their health status. Servers with problems are disabled.
3. Click **Migrate All Files**.
4. Confirm the migration in the popup.
5. Wait for the process to complete. The button changes to show progress.
6. The page reloads when the migration finishes successfully.
[warning]File migration may take time for large videos and cannot be stopped once started. Make sure the destination server has enough space before starting.[/warning]
### File Paths
The File Paths section lists the web addresses for all of the video's files (main video, poster, preview, animated GIF, contact sheet, streaming playlist, and sprite files). Click any link to open it in a new browser tab and verify the file is accessible.
---
## Settings and Options
### Fields That Affect Your Public Site
Changes you make on this page directly affect what visitors see on your site:
| Setting | What Changes on Your Site |
|---------|--------------------------|
| **Title** | Appears on video cards, the player page, and search results |
| **Description** | Shown on the video player page and used in search indexing |
| **Status** | Only Active videos appear on your site |
| **Access Type** | Controls who can watch: everyone, members, subscribers, or pay-per-view |
| **Featured** | Featured videos appear in homepage carousels and featured sections |
| **Categories / Tags / Models** | Affect filtering, browsing, related videos, and search results |
| **Main Thumbnail** | The image visitors see when browsing videos |
| **SEO Fields** | Affect how search engines and social media display your video |
| **Schedule Dates** | Videos only appear within the scheduled date range |
| **Price / Currency** | The cost shown to visitors for pay-per-view videos |
| **Chapters** | Appear as clickable markers on the video player timeline |
---
## Tips for New Users
[tip]
- Start by setting the **Title**, **Description**, **Categories**, and **Main Thumbnail** for each video. These are the most important fields for attracting viewers.
- Use the **Featured** checkbox sparingly. Featuring too many videos dilutes the impact of your homepage carousels.
- Fill in the **SEO fields** (Meta Title and Meta Description) for your most important videos to improve search engine visibility.
- Use **Chapters** on longer videos to help viewers find the parts they are interested in.
- Check the **User Reports** section regularly to address any issues visitors have flagged.
- Use **Admin Notes** to keep track of any decisions or changes you make so other administrators can see the context.
[/tip]
---
## Troubleshooting
### Video not playing in the preview player
**What you see:** The player shows a black screen or an error message.
**How to fix it:**
1. Scroll down to the **File Paths** section and click on the **Main Video** link.
2. If the link does not load, the video file may not be available on the storage server. Check the **Storage Server** section for the server's health status.
3. If the video has **HLS Enabled** checked, try unchecking it temporarily to see if the standard video file plays instead.
4. If the problem persists, the video may need to be reprocessed. Go to **Admin Panel > Content > Videos**, find the video, and check its processing status.
### Changes do not seem to be saving
**What you see:** You edit a field but the value reverts or does not appear to stick.
**How to fix it:**
1. Refresh the page and check whether the change actually saved. Auto-save works in the background and the value may have been saved even if you did not see a confirmation.
2. If the change is truly not saving, your session may have expired. Log out and log back in, then try again.
3. Make sure you are clicking outside the field after editing. Changes save when you leave the field, not while you are still typing.
### Thumbnail buttons are grayed out
**What you see:** The green **M** (set main) and red **D** (delete) buttons on a thumbnail are faded and not clickable.
**How to fix it:** This happens when a thumbnail's record is incomplete. The thumbnail image is visible but cannot be managed through these buttons. Try reprocessing the video to regenerate the thumbnails properly.
### Chapters not loading
**What you see:** The Chapters section shows a loading message that never goes away, or no chapters appear even after adding them.
**How to fix it:**
1. Click the **Refresh** button in the Chapters section to reload the chapter list.
2. If the problem continues, refresh the entire page.
3. If chapters still do not appear, contact your system administrator to verify the chapters feature is set up correctly.
### Video stuck in Processing status
**What you see:** The video status shows **Processing** and never changes to **Active**.
**How to fix it:**
1. Check the **Processing** tab in the Analytics section to see if a start time was recorded.
2. If the video has been processing for an unusually long time (more than an hour for a standard video), contact your system administrator. There may be an issue with the video processing system.
### Storage migration fails
**What you see:** You try to migrate files to a different server but get an error message.
**How to fix it:**
1. Make sure the destination server shows a green (healthy) or amber (warning) status. Servers with red (critical) or gray (unknown) status cannot be selected.
2. Verify that the destination server has enough storage space for the video files.
3. Try again after a few minutes. The issue may be temporary.
4. If the problem persists, contact your system administrator.
---
## Related Pages
| Page | When to Use It |
|------|---------------|
| **Video Management** | To see your full list of videos, search for videos, or perform bulk actions |
| **Video Upload** | To add new videos to your site |
| **Categories** | To create or manage the categories you assign to videos |
| **Models** | To manage model/performer profiles in detail |
| **Storage Servers** | To view and manage all your storage servers and their health status |
---
## Version History
| Version | Date | Changes |
|---------|------|---------|
| 1.0.0 | 2026-02-04 | Initial user-friendly guide created |