# Media File Settings


Before publishing a media file, you need to configure its basic parameters: name, description, poster, tags, privacy, and other settings. These parameters affect the video's visibility in search engines, ease of search in the catalog, and content accessibility for viewers.

## Who this article is for

* **Content managers** — need to configure video metadata for SEO and easy search
* **Project administrators** — need to configure privacy and video access
* **Marketers** — need to optimize video for search engines and social media
* **Course creators** — need to configure access to learning materials

> **Информация:**

To start configuring a file, double-click it in the project catalog.



## Basic parameters

The **"General"** tab includes the following parameters:

1. **Name and description.** By default, the name is taken from the original file. You can change it and add a description to help with SEO.
2. **Poster**, or video thumbnail. This can be an uploaded image or a selected frame.
3. **Tags** — keywords for easier search and filtering.
4. **Privacy settings.** Control access to the video and the ability to embed it on external sites.
5. **Player selection. By default, the standard Kinescope player is used, but you can fully customize it.**
6. **File versions.** Track and manage video replacements without re-embedding video or changing links.
7. **Sharing access to files.**

 ![General media file settings tab](images/cvm-settings-general-01.webp)

## **Name, subtitle, and description**

### **Name**

The name should be concise but informative. It helps viewers understand the video's content and affects visibility in search engines.

* The **"Name"** field cannot be empty. If left empty, Kinescope will keep the original file name.
* The name must not exceed 140 characters.

> **Информация:**

We recommend using clear and concise titles to make search easier.



### **Subtitle and description**

The subtitle complements the name and clarifies the video topic, while the description helps viewers and search engines understand what the video is about.

* The subtitle is limited to 140 characters.
* Use keywords in the description to improve SEO.

Click **"Save"** to finish editing.

**Auto-generate description (beta)**

This feature automatically generates a description based on the video content. It is currently in open beta testing. To participate, write to **the support chat within the Kinescope interface.**

## **Selecting a poster**

The poster is a key visual element of the media file. It appears everywhere the video is published: in search results, on video pages, and in link previews.

By default, Kinescope automatically selects a poster. For videos longer than 30 seconds, the system picks a frame from the first scene change after the 30-second mark. If no such frame is found, the 25th frame is used. However, this choice doesn't always reflect the video's essence, so you can upload your own poster or select a suitable frame from the video. To do this, open the **"Add poster"** dropdown and select **"Upload poster"** or **"Select frame"**.

 ![Selecting a frame from the video for a poster](images/cvm-settings-poster-02.webp)

### **Uploading a poster**

If you want to upload a custom poster image:

1. Click **"Add poster"** → **"Upload poster"**.
2. In the window that opens, upload an image from your computer.
3. Click **"Save"**.

> **Информация:**

*The poster must be in JPEG, PNG, GIF, or SVG format with a maximum resolution of 4096×2160 pixels and file size up to 10 MB.*



To make the poster look good, make sure the poster's aspect ratio matches the video's — you can find the video's aspect ratio in the **"Files"** tab.

### **Selecting a frame from the video**

You can also select a frame from the video itself to use as a poster:

1. Click **"Add poster"** → **"Select frame"**.
2. A player with frame selection opens.
3. Play the video to the desired moment and pause it.
4. Click the **"Frame"** field. Use the up and down arrow keys to navigate between frames to find the right one.
5. Click **"Save poster"** to confirm your selection.
6. Click **"Save"**.

## **Downloading video posters from Kinescope via direct links**

You can download posters from Kinescope videos via direct links. Posters are available in different formats (JPG and WEBP) and different sizes.

### **Downloading a poster in standard size**

If you need a poster in standard (default) size, use the following link format: **JPG:** `https://kinescope.io/<video_link>/poster.jpg`

**WEBP:** `https://kinescope.io/<video_link>/poster.webp`

Simply open the desired link in a browser or use right-click → **"Save image as..."**.

### **Downloading a poster in a specific size**

If you need a poster in a specific size, replace **{size}** in the URL with one of these values:

* **xs – extra small poster**
* **sm – small poster**
* **md – medium poster**
* **lg – large poster**

> ### **Examples:**
>
> **Small poster (sm) in JPG format:**  `https://kinescope.io/<video_link>/poster/sm.jpg`
>
> **Medium poster (md) in WEBP format:** `https://kinescope.io/<video_link>/poster/md.webp`

## **Tags**

### **What are tags?**

Tags help structure media files and improve their search visibility. For example, a video about growing oranges might have the tags "oranges", "trees", "gardening".

### **Adding tags**

1. In the media file settings, find the **"Tags"** field and click **"Add tag"**.
2. In the dialog that appears, enter tags one by one, pressing Enter after each one. You can also click **"Create new tag"** to add it to the collection.
3. If a tag you enter already exists, it will be suggested in a list. Click the relevant option to add it.
4. When your tag list is complete, click **"Add"** to save them.
5. Click **"Save"** to confirm. To remove a tag, click the "×" next to it.

### **Managing tags via the tag manager**

The tag manager in Kinescope lets you view, add, edit, or delete tags. To access it:

* Open the **"Tags"** dialog in the media file settings → **"Tag manager"**.

 ![Tag manager in media file settings](images/cvm-settings-tags-01.webp)

* Or hover over your avatar → **"Settings"** → **"Tags"**.

 ![Accessing the tag manager from profile settings](images/cvm-settings-tags-02.webp)

### **Adding a new tag**

1. Click **"New tag"**.
2. Enter the tag name and click **"Add"**.

### **Editing tags**

To modify an existing tag:

1. Click the **"Edit tag"** icon next to it.
2. Make changes and confirm.

 ![Editing a tag in the tag manager](images/cvm-settings-tags-03.webp)

> **Внимание:**

*All changes apply to all linked media files.*



### **Archiving and deleting tags**

Unused tags can be archived or deleted:

1. Click the **"Archive tag"** icon.
2. Choose the action: send the tag to the archive or delete it permanently.

 ![Archiving and deleting tags](images/cvm-settings-tags-04.webp)

Archived tags can be restored via the **"Archive"** tab → **"Restore tag"**.

 ![Tag archive tab in the tag manager](images/cvm-settings-tags-05.webp)

> **Внимание:**

Archiving or deleting a tag removes it from all linked media files.



### **Viewing media files linked to a tag**

To see media files linked to a specific tag:

1. Click the number in the **"Media"** column next to the tag.
2. A list of all files linked to that tag will open.

 ![Media files linked to a tag](images/cvm-settings-tags-06.webp)

## **Managing media file privacy settings**

### **Privacy settings overview**

Privacy settings in Kinescope let you precisely control who can view your media files and where. You can control access to your files and regulate their embedding, as described below.

### **Managing view access**

To configure access settings, open the **"Who can view?"** field in the privacy settings and choose one of five levels:

* **Everyone** — access is open to all users regardless of how they're viewing.
* **Users with a private link** — access only via a unique link that is created automatically.
* **Users with a password** — viewing requires entering a password you set.
* **Users with unique codes** — viewing only for people you give a code to; useful for paid webinars and private screenings without registration.
* **Users by work email (e-mail domain)** — viewing is available for users from an allowed email domain.

 ![Video access settings in privacy configuration](images/cvm-settings-privacy-01.webp)

### **Private link**

1. Select the access level **"Users with a private link"**.
2. Click **"Save"**.
3. If needed, refresh the link using the refresh icon.

### **Password access**

1. In settings, select **"Users with a password"**.
2. Set a password and confirm changes with the **"Save"** button.

### **Access by unique codes**

Unique codes limit viewing to people you give a code to — handy for webinars and private screenings without sign-up. Under **"Privacy"**, in **"Who can view?"**, select **"Users with unique codes"**, then **"Manage codes"**: generate a batch, download the file, and share the video link and codes with viewers.

For a full walkthrough with screenshots, what viewers see, deleting batches, and FAQs, see [Video access restrictions](https://docs.kinescope.com/content-protection/access-restrictions/#access-by-unique-codes) (section **Access by unique codes**).

### **Configuring embedding**

Kinescope lets you restrict media file embedding by domain, so you can place content only on trusted websites. This setting is available in the **"Where can the player be shown?"** section and offers three options:

* **Everywhere** — no restrictions.
* **Nowhere** — prevents embedding, but does not restrict access via private link, password, or unique code.
* **On specified domains** — restricts embedding to the specified domains only.

 ![Embedding domain settings for a media file](images/cvm-settings-embed-01.webp)

### **Adding domains**

To allow media file embedding on specific domains:

1. In the privacy settings, find **"Where can the player be shown?"** and select **"On specified domains"**. Then click **"Add domain"** — a data entry window will open.
2. Enter trusted domains one by one in the text field. After each domain, press **Enter** or click **"Create new domain"** to add it to the list.

> **Информация:**

*To allow embedding on all subdomains of a site, specify the third-level domain. For example, for the site "orangetrees.com" add `*.orangetrees.com` and `orangetrees.com`.*



3. If a domain already exists, the system will suggest it in a list. Click the relevant option to select it.
4. When all domains have been selected, click **"Add"**, then **"Save"**.

> **Внимание:**

*Without clicking **"Save"**, changes will not be recorded.*



### **Removing a domain**

To remove a domain from the trusted list:

1. Find the domain in the list.
2. Click the "×" next to it.

### **Managing domains via the domain manager**

Using the **"Domain manager"**, you can add, edit, and delete domains, as well as view their linked media files:

1. Via the **"Domains"** dialog in specific file settings.
2. Via the settings section in the dashboard.

### **Adding a new domain**

1. Click the **"New domain"** button.
2. In the **"Name"** field, enter the domain name.
3. Click **"Add"** to save changes.

### **Editing domains**

1. Click the **"Edit domain"** icon next to the desired domain.
2. In the window that opens, make changes → click "Save".

> **Внимание:**

*Changes to a domain name are automatically applied to all media files linked to it.*



### **Archiving and deleting domains**

If a domain is no longer in use, you can:

* **Archive it** to restore later;
* **Delete it permanently** if it's no longer needed.

To do this, click the **"Archive domain"** or **"Delete"** icon next to the domain. In the dialog box, select the desired action. Archived domains can be restored in the **"Archive"** tab by clicking **"Restore domain"**.

> **Внимание:**

*Deleting or archiving a domain **removes the binding** of all media files linked to it. The files themselves remain intact.*



### **Viewing media files linked to a domain**

1. Click the number next to the domain name in the **"Media"** column.
2. A list of all media files linked to that domain will open.

## **Selecting or creating a player for a media file**

In the "Player" section, you can select a ready-made player template for the video and modify the settings of the selected template. If you change the template settings, they will also apply to all videos using that template.

Getting familiar with player settings is straightforward — [learn more in the section](https://docs.kinescope.com/video-player/).

 ![Customize player for a media file](images/cvm-settings-access-01.webp)

## **Replacing media files**

If you need to update a file while keeping the link, embed code, analytics, tags, poster, privacy settings, and other data unchanged, use the **"Versions"** feature.

### **How to replace a file**

1. In the [catalog](https://app.kinescope.io/video) or via search, find the video you need and double-click its name to open settings.
2. On the **"General"** tab, scroll down to the **"Versions"** section. Click **"Replace file"**, then select **"Upload"** and specify the new version in the popup window.
3. The upload and processing process will start automatically and can be tracked in the **"Versions"** section.

> **Внимание:**

*While the new file is uploading and processing, viewers will continue to see the old version. The update will only take effect after processing is complete.*



After upload completes, the old version is automatically deleted, and the **"Versions"** block shows information about the current file (name, date and time of replacement, name of the user who replaced it).

## **Sharing access to media files**

Kinescope offers two ways to publish: **direct links and embed codes**.

 ![Sharing access options for a media file](images/cvm-settings-access-02.webp)

### **Sharing open access via link**

* Click the **"Link"** button above the media player → **"Copy"**. You can also specify a start time so viewers jump directly to the desired segment.
* Alternatively, use the three-dot menu in the upper-right corner of the settings panel. Select **"Copy link" → "Copy video link"**.

### **When privacy settings are applied**

* **Users with a password**: share the link along with the password set in the privacy settings (see [Password access](#password-access)).
* **Users with unique codes**: share the video link and the codes from your downloaded batch (see [Access by unique codes](#access-by-unique-codes)).
* **Users with a private link**: use the unique private link available in the privacy settings (see [Private link](#private-link)).

### **Publishing files using an embed code**

To embed media on websites and platforms:

1. Click the **"Embed"** button above the media player.
2. Click **"Copy code"** in HTML format.

You can choose:

* **Responsive embed code** for automatically adapting player dimensions.
* **Fixed embed code** if you need strict player dimensions.

Use the additional parameters to configure size and aspect ratio. You can also use the three-dot menu in the upper-right corner of the settings panel and select **"Copy link" → "Copy embed code"** (by default, the fixed embed code is copied).

> **Внимание:**

After configuring all parameters, make sure to click **"Save"**.



## What's next?

After configuring the basic media file parameters, we recommend:

1. **[Organize your media library](https://docs.kinescope.com/catalog-and-video-management/organizing-media-library/)** — create projects and folders to structure your content
2. **[Embedding](https://docs.kinescope.com/video-player/embedding/)** — adding video to your website
3. **[Customize the player](https://docs.kinescope.com/video-player/player-customization/)** — adapt the player's appearance to your brand
4. **[Add subtitles and chapters](https://docs.kinescope.com/catalog-and-video-management/working-with-files/)** — improve accessibility and navigation in video
5. **[Set up content protection](https://docs.kinescope.com/content-protection/)** — restrict video access by domain, password, or authorization

Still have questions? Write to the support chat within the Kinescope interface — our specialists will help!