Skip navigation

Media File Settings

Updated: 08.05.2026
Open as Markdown

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
General media file settings tab

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
Selecting a frame from the video for a poster

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

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
Tag manager in media file settings

  • Or hover over your avatar → “Settings”“Tags”.

Accessing the tag manager from profile settings
Accessing the tag manager from profile settings

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
Editing a tag in the tag manager

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
Archiving and deleting tags

Archived tags can be restored via the “Archive” tab → “Restore tag”.

Tag archive tab in the tag manager
Tag archive tab in the tag manager

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
Media files linked to a tag

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
Video access settings in privacy configuration

  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 (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
Embedding domain settings for a media file

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.
  1. If a domain already exists, the system will suggest it in a list. Click the relevant option to select it.
  2. 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 .

Customize player for a media file
Customize player for a media file

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 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
Sharing access options for a media file

  • 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 ).
  • Users with unique codes: share the video link and the codes from your downloaded batch (see Access by unique codes ).
  • Users with a private link: use the unique private link available in the privacy settings (see 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 — create projects and folders to structure your content
  2. Embedding — adding video to your website
  3. Customize the player — adapt the player’s appearance to your brand
  4. Add subtitles and chapters — improve accessibility and navigation in video
  5. Set up 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!