Media analysis
Media analysis is what Focal reads from an image or video on its own, without anyone asking: a short summary of what the asset shows, the text that appears in it, a transcript of what is said, the music that plays, and its main colors. Focal runs it in the background when an asset is added to a space, and shows the results in the asset view’s AI Analysis panel.
Use media analysis to see what an asset contains before you play it through, to find the exact line or on-screen text in a video, or to check which song a cut uses. Nobody has to fill anything in. The same analysis is what Media tagging and Boards autofill read when they fill in fields for you.


Open the AI Analysis panel
The AI Analysis panel is a tab in the sidebar of the asset view, the full-screen view an asset opens in. It holds everything media analysis found for the asset you are looking at.
- Open Assets in the sidebar.
- Click an asset to open it in the asset view.
- In the row of buttons at the top right, click the sparkles button, AI Analysis.
The panel lists up to four sections, top to bottom: Summary, Music, Transcript and Text. Music appears only when a song was recognized. While Focal is still analyzing a new asset, its results are not there yet.
The Asset library article describes the asset view’s other tabs.
Read an asset’s summary
The summary is a short description of what an image or video shows, written by AI. It sits at the top of the AI Analysis panel under Summary.
The summary describes what is visible: the setting, any people, brand and product names, logos and prominent text. By default it leaves out audio and speech on purpose; what is said in a video appears in the transcript instead. The panel shows the first paragraph of the description, the short overall summary.
What the summary covers is set by the space’s media analysis prompt. A space owner can edit that prompt in AI settings to steer it, for example to always name the product or the format.
Find text in an image or video
Text recognition, also called OCR, picks out the words that appear in an asset: headlines, captions, labels, product names, text in screenshots. The results are listed in the AI Analysis panel under Text.
- In an image, Text lists each piece of text found.
- In a video, each piece of text carries the time it appears. Click a line to jump the video to that moment. While the video plays, the line on screen is highlighted.
A long list starts collapsed. Click anywhere in the list, or click the Text heading, to expand it; click the heading again to collapse it. When nothing readable was found, the section says so.
Read a video transcript
A transcript is a written record of what is said in a video, split into timed lines. It is listed in the AI Analysis panel under Transcript.
- Open a video in the asset view.
- Click AI Analysis.
- Read the lines under Transcript. Each line shows the time it starts.
- Click a line to jump the video to that moment.
While the video plays, the line being spoken is highlighted. A long transcript starts collapsed; click it, or click the Transcript heading, to expand it. A video with no speech has no transcript, and neither does any image, since images have no audio.
Find the music in a video
Music recognition listens to a video’s soundtrack and names the song it finds. The result is shown in the AI Analysis panel under Music.
The Music section shows the track’s title and artist, and the album and release date when they are known. When the recognition service has cover art, it appears beside the track; clicking the cover opens the song on Shazam.
Music appears only for videos, and only when a song was recognized. A video with no music, or with music that could not be matched, has no Music section at all. Use it to check which track a cut uses before you publish it, for example when licensing matters.


See an asset’s colors
Color analysis measures the main colors in an asset. Unlike the other results, the colors are shown on the Info tab of the asset view, not on AI Analysis.
- Open an asset in the asset view.
- Click the Info button, next to AI Analysis.
- Find File colors.


File colors is a strip of color blocks. Each block is one of the asset’s main colors, and its width shows how much of the asset that color covers. Colors are read from the asset’s preview image, and when a new version replaces the asset they are read again from the new one.
When media analysis runs
Media analysis runs by itself; there is no button to start it. Focal analyzes an asset when:
- the asset is added to the space, by uploading it or through an integration that syncs files into Focal;
- a new version replaces the asset. Focal analyzes the asset again from the new version.
Analysis starts once the upload has finished and Focal has processed the asset.
Which file types get what
Media analysis reads images and videos. Each kind of result applies to the file types that can contain it:
| Result | Where it shows | Images | Videos |
|---|---|---|---|
| Summary | AI Analysis → Summary | Yes | Yes |
| Text in the asset | AI Analysis → Text | Yes | Yes, with times |
| Transcript of speech | AI Analysis → Transcript | No | Yes |
| Music | AI Analysis → Music | No | Yes |
| Colors | Info → File colors | Yes | Yes |
Videos longer than 10 minutes or larger than 500 MB are skipped: they get no summary, text, transcript or music. Assets in other formats, such as ZIP or DOCX, are not analyzed either. Their AI Analysis panel shows no summary, and its sections show no transcript or text, without an error.
Change what media analysis writes
Media analysis is on in every space and has no switch. What the summary says about images and videos is set by the Media Analysis Prompt in AI settings, under Space Settings → Automations. See AI settings for how to edit it.
Only space owners and organization admins can open space settings.
Who can see media analysis
Media analysis follows access to the asset. Everyone who can open an asset in the asset view can read its AI Analysis panel and its File colors; there is no separate permission for it. Reading the analysis changes nothing, so it is available at every access level.
Changing what media analysis does is limited to space owners and organization admins, who can edit the media analysis prompt in AI settings. See Roles and permissions for what each role can do in a space.