> ## Documentation Index
> Fetch the complete documentation index at: https://aspect.inc/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Embed videos

> Add an Aspect video player to another website using a share link.

Aspect videos can be embedded on another website so visitors can watch without leaving the page.

Embedding is available for individual videos that can be previewed in the browser.

<iframe src="https://app.aspect.inc/share/56bcc152-bd68-429b-8204-ba67d12f9789/embed?controls=true&autoplay=false&loop=false" title="Sharing and embedding links" style={{ width: "100%", aspectRatio: "16 / 9", border: 0, borderRadius: "12px", overflow: "hidden", display: "block", background: "#000" }} allow="fullscreen; picture-in-picture" loading="eager" allowFullScreen />

There are two ways to embed an Aspect video:

* [**Embed with code**](#embed-with-code): Copy the iframe embed code from Aspect and paste it into an HTML or custom embed block.
* [**Embed with a link**](#embed-with-a-link): Paste the Aspect embed link into a platform that supports external video URLs or link previews.

## How video embedding works

An embedded video uses the Aspect browser player.

The player loads the browser-playable version prepared by Aspect during indexing. It does not load or change the untouched original file.

The embed is connected to an Aspect share link. The link controls access to the shared video.

## Before embedding a video

Confirm that:

* The video has finished uploading.
* Aspect has prepared a browser preview.
* The video plays correctly in the Aspect viewer.
* You selected the correct asset and version.
* The share link is active.
* The share-link permissions are appropriate for the website's audience.
* The video is approved for publication.

## Embed with code

<iframe src="https://app.aspect.inc/share/00418fc2-477b-4808-8ca8-dd6d96a7eaa0/embed?controls=true&autoplay=false&loop=false" title="Copy Aspect embed code" style={{ width: "100%", aspectRatio: "16 / 9", border: 0, borderRadius: "12px", overflow: "hidden", display: "block", background: "#000" }} allow="fullscreen; picture-in-picture" loading="eager" allowFullScreen />

Copy the iframe embed code from Aspect and paste it into an HTML or custom embed block.

1. Open the individual video in Aspect.
2. Open the sharing controls.
3. Create a new share link or select an existing one.
4. Review the link's permissions and protections.
5. Open the available embed option.
6. Copy the embed code provided by Aspect.
7. Open your website editor or content management system.
8. Add an HTML or embed block.
9. Paste the Aspect embed code into the block.
10. Preview the webpage and test playback.
11. Publish the webpage when everything works correctly.

The exact name of the embed field depends on the website platform you use. It may be labeled Embed, HTML, Custom HTML, Code, Video embed, or External media.

## Embed with a link

Use this option when the website accepts a video URL, link preview, or external-media link instead of HTML code.

<iframe src="https://app.aspect.inc/share/00418fc2-477b-4808-8ca8-dd6d96a7eaa0/embed?controls=true&autoplay=false&loop=false" title="Embed an Aspect video with a link" style={{ width: "100%", aspectRatio: "16 / 9", border: 0, borderRadius: "12px", overflow: "hidden", display: "block", background: "#000" }} allow="fullscreen; picture-in-picture" loading="eager" allowFullScreen />

1. Open the individual video in Aspect.
2. Open the sharing controls.
3. Create a new share link or select an existing one.
4. Review the link's permissions, password, expiration, and watermark settings.
5. Copy the share link.
6. Open your website editor or content management system.
7. Add a video, external media, URL, or link-preview block.
8. Paste the Aspect share link into the URL field.
9. Preview the webpage and test playback as a visitor.
10. Publish the webpage when playback and access work correctly.

If the platform displays only a clickable link instead of a player, use the embed-code method or confirm that the platform supports external video links.

## Choose the correct share link

<Note>
  Choose the option that best fits the platform where you are publishing. Use the embed code when the platform accepts HTML or custom embed blocks. Use the share link when it only supports URLs, link previews, or external media. Preview the result to confirm that playback and access permissions work as expected.
</Note>

Create a separate share link for a public embed instead of reusing a private review link.

Before copying the embed code, check:

* Whether downloading is allowed
* Whether metadata is visible
* Whether earlier versions are visible
* Whether the link has a password
* Whether the link has an expiration date
* Whether watermarked playback is enabled

The share-link settings remain separate from the website where the player is embedded.

Learn more in [Sharing and permissions](/docs/share-and-present/sharing-and-permissions).

## Password-protected videos

A share link can be protected with a password.

Before embedding a password-protected video, test the complete experience as a visitor. Make sure the protection is appropriate for an embedded player and that recipients know how to obtain the password.

Do not place a password directly on a public webpage next to the protected video.

## Expiring embeds

A share link can have an expiration date.

If the video should remain available on the website, make sure the link does not expire unexpectedly.

Use expiration for:

* Temporary campaign pages
* Limited review periods
* Event pages
* Short-term presentations
* Time-sensitive announcements

Review expiration dates before publishing or updating the webpage.

## Watermarked playback

Watermarking can be enabled through the share-link settings.

Use watermarked playback when sensitive video needs a visible playback identifier. Review the link's **Downloads** permission separately if recipients should not receive the source file.

Test the embedded player after enabling watermarking. Learn how to [create and configure a watermark](/docs/share-and-present/watermarking).

## Test the embedded player

Always test the final webpage before sending it to visitors.

Check that:

* The correct video appears.
* The player loads.
* Playback starts normally.
* The full player is visible.
* The video is not cut off by the page layout.
* Fullscreen playback works when available.
* The player works on desktop and mobile.
* The link has not expired.
* Password protection works as expected.
* The intended permissions are active.

Test the webpage in a private browser window when possible. This helps you see the page as someone outside your Aspect workspace would see it.

## Update access to an embedded video

The embedded player depends on its Aspect share link.

Open the video's sharing controls when you need to:

* Review the link
* Change its permissions
* Add or update a password
* Change its expiration date
* Disable the link
* Delete the link

Changes to the share link affect access to the shared video.

<Warning>
  Turning the share-link toggle off and back on in Aspect does not force an external website to refresh. The toggle changes the link's access state, but it does not change the embed code, reload a page that is already open, or clear caching managed by the website or visitor's browser.

  After changing the toggle, reload the published webpage and test it in a private browser window. If the website uses page or CDN caching, you may also need to republish the page or clear that cache before visitors see the updated access state.
</Warning>

## Disable an embed

To stop access temporarily, disable the share link used by the embed.

You can enable the link again later if the video should return.

## Permanently revoke access

Delete the share link when the embed should no longer provide access to the video.

After deleting the link, remove the embed code from the external website as well.

## Embed on a website builder

Most website builders provide an embed or custom HTML block.

The general workflow is:

1. Add an embed block to the page.
2. Paste the code provided by Aspect.
3. Save the page.
4. Preview the result.
5. Adjust the block or container if the player does not fit.
6. Publish the page.

Refer to your website platform's documentation if it blocks external embeds or requires additional approval for custom code.

## Troubleshoot an embed

### The player does not appear

Check that:

* The embed code was copied completely.
* The code was pasted into an embed or HTML block.
* The share link is active.
* The video can be previewed in Aspect.
* The website platform allows external embedded players.

### The video is unavailable

Check whether:

* The share link was disabled.
* The share link was deleted.
* The link reached its expiration date.
* Password protection was added or changed.
* The underlying asset is still available.

### The player is cut off

Review the size of the embed block or its surrounding page container.

The available sizing controls depend on the website platform.

### The wrong video appears

Return to Aspect and confirm that the embed was created from the correct individual video and share link.

Create a new embed if the wrong asset was selected.

## Embedding and viewer tracking

Do not use an embedded player as proof that a specific person watched the video.

Aspect does not identify passive viewers of an unauthenticated share link.

Use comments, replies, or another explicit response when you need someone to confirm that they reviewed the content.

## Best practices

* Embed only approved videos.
* Confirm that you selected the correct version.
* Create a dedicated share link for the embed.
* Review permissions before publishing.
* Avoid exposing internal metadata.
* Test the embed as an external visitor.
* Check desktop and mobile playback.
* Review expiration dates.
* Use password protection for sensitive content.
* Disable or delete the link when access should end.
* Remove outdated embed code from the external website.
* Do not claim individual view tracking.

## Related guides

* [Sharing and permissions](/docs/share-and-present/sharing-and-permissions)
* [Collection branding](/docs/share-and-present/collections#brand-a-collection)
* [Collections](/docs/share-and-present/collections)
* [Versioning](/docs/review-and-approve/versioning)