Media library
What's in the brand's media library, where the assets come from, how to upload and manage them, and how they end up on pages.
The Media library holds the logos, images, and documents for one brand. Nothing crosses between brands, and each has its own library.
Terra draws from this pool when a page needs imagery. An image that isn't in the library is an image the agent cannot put on your site.
What's in it
Four filters run across the top: All, Logos, Images, Documents. The search box next to them filters by the asset's description.
Each tile shows a thumbnail, a label, and a metadata line with dimensions, file size, and when it was added. The label is the asset's description, or the filename in a monospace face when there is no description.
Click a tile to open its detail:
| Field | |
|---|---|
| Type | Logo, Image, Page image, or Document. |
| Filename | The original filename. |
| Dimensions | Width × height, for images. |
| File size | |
| Uploaded | |
| Description | Shown when there is one. |
From there, Open original opens the file itself in a new tab, and Delete removes it.
The library shows the assets you work with: logos, images, images generated for pages, and documents. Iterant also captures things like site screenshots during analysis. Those are system-managed and stay out of this list.
Only the first 100 assets load per view. When there are more, a banner tells you how many are being shown out of the total and asks you to narrow the filter.
Where the assets come from
Assets arrive four ways:
- You upload them. The main route, covered below.
- Brand onboarding. When Iterant analyzes your site it captures your logo into the library, so the agent has real brand marks from day one.
- Terra imports one. During a build, the agent can pull an image from a public URL into the library. Iterant stores the copy, so the page doesn't depend on the original host staying up.
- Terra generates one. When no real asset fits, the agent can generate an image and persist it here. You can reuse or delete it like any other asset.
Imported and generated assets arrive with an agent-written description. A description you type at upload time outranks an automatic one, and a later automatic pass leaves it alone. Descriptions are set when an asset is created and cannot be edited from the library afterwards, so it is worth getting them right on the way in.
Terra will not generate product UI: dashboards, app interfaces, screenshots, metric panels, mockups. Image models hallucinate interface text, and a fabricated screenshot misrepresents your product. For product imagery the agent uses real captured assets from the library and refuses to generate. If a request comes back refused, use a real screenshot from the library or re-brief to non-UI imagery.
Uploading
Press Upload. The dialog takes several files at once, with three things to set:
- Files, one or many. Accepted: PNG, JPEG, WebP, GIF, PDF,
.doc, and.docx, and the file picker won't offer anything else. Each file must be under 10 MB and non-empty. Anything oversized or empty is skipped at selection time with a toast naming it. - Type, one of Logo, Image, or Document, applied to the whole batch. The choice persists between batches.
- Description, optional, up to 255 characters, applied to every file in the batch. Worth filling in: it is what you search on, what shows as the tile's label, and what Terra matches against when it looks for an image for a page. "Founder portrait, outdoors, landscape" is findable;
IMG_4821.jpgis not.
Each file gets its own row with a spinner, a tick, or a cross with the reason inline, and a summary toast reports the batch. Clear files resets the selection, and closing the dialog mid-upload cancels the rest.
Deleting
Use the trash icon on a tile, or Delete in the detail view. Both ask you to confirm: Delete this asset? This cannot be undone. The library has no undo, and Iterant matches assets by their contents, so uploading the same file again is the only way back.
If a published page uses the asset, replace the image in the editor first, then delete the old asset.
How assets get onto pages
Two paths.
Terra picks one. When it needs imagery for a section, the agent searches the library by description and uses the matching asset, with its real URL. If the library has no fit, the agent imports or generates one, and that asset lands back in the library for reuse. Keep descriptions honest and specific so the search finds the right asset.
You pick one in the editor. Select an image on a page and choose Swap image. A picker opens with a Library tab to search and select, and an Upload new tab that uploads a dropped file and selects it in one step. The same picker chooses the social preview image in a page's settings.
Troubleshooting
Last updated on