> This page is for version v1.3 (default).
> For other versions, use one of these documentation indexes:
> - v1.3 (default): https://docs.twelvelabs.io/v1.3/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.twelvelabs.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.twelvelabs.io/_mcp/server.

# Visualize embeddings

> Visualize semantic relationships between video clips and text queries in a 2D space.

Use the Playground to analyze semantic relationships between your video content and text queries. The visualization displays up to 500 clips from your selected index as interactive data points in a two-dimensional space. Dots that cluster together indicate content with similar characteristics. Each dot in the visualization has a distinct color:

* **Light green**: Represents video clips.
* **Dark green**: Indicates the currently selected video clip.
* **Orange**: Represents your text query

When you enter a text query, its position relative to video clips indicates semantic similarity - clips positioned closer to your query are more semantically similar to the text you entered.

# User interface

The following image shows the user interface and the key elements you can use to interact with the visualization:

![](/_fern-img/e213eba0ed4a7a425cbe744d84d6fbdbff58f2fa2e3d904b1c12161a9a644990.webp)

1. **Visualization area**: Displays dots representing video clips and the embedding for your text query.
2. **Create a text embedding**: Use this text field to enter your text query. Note that your text cannot exceed 77 tokens. The token count is displayed at the bottom.
3. **View controls**: Use these buttons to adjust the visualization:
   * Zoom in
   * Zoom out
   * Fit: Reset the view to show all points
4. **Legend**: Shows what the different colors represent.
5. **Selected embedding**: Shows detailed information about the selected embedding. including a video player.

# Typical workflow

Follow the steps below to explore semantic relationships in your video content:

1. From the [Indexes](https://playground.twelvelabs.io/indexes) page, select an index.
2. Choose the **Embed** tab
3. Enter a text query to find relevant video segments.
4. Explore relationships by:
   * Observing clusters of similar content
   * Adjusting the view to focus on specific areas using the buttons in the **View controls** area or your mouse.
   * Selecting dots to preview video segments
5. View the code to implement similar functionality in your application.