> For the complete documentation index, see [llms.txt](https://docs.struct.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.struct.com/tutorials/guides/how-to-use-media/how-to-get-started-with-media.md). # How to get started with Media Get an overview of what's available in Media, from working with several assets at once to everything you'll find on an individual asset's page. The Media page is the central hub for storing and managing assets used across your products, such as images, videos, and documents. Opening "Media" takes you straight into this overview, where every asset is listed and ready to be organized, searched, or opened. This tutorial goes through the basics of working in Media, from selecting and acting on assets, organizing them in folders, tagging them, and what you'll find once you open an individual asset. ### Selecting assets Selecting one or more assets reveals a toolbar of actions you can apply to the whole selection at once.
"Bulk update" opens a form where you can update asset tags, internal note, workflow state across every selected asset at the same time, rather than editing each one individually. "Export" downloads the underlying data for the selection, and "Bulk translate" sends the selected assets into the translation flow together. "Create task" lets you assign follow up work on the selection to yourself or a colleague, and "Download as zip" packages every selected asset into a single file you can download.
Under "More actions" you'll find "Move", which relocates the selction to a different folder, "Delete", which removes it entirely, and "Share" covered in [How to use asset transformation and share assets](/tutorials/guides/how-to-use-media/how-to-use-asset-transformation-and-share-assets.md). All of these apply the same way whether you've selected one asset or many. ### Organizing assets in folders As your media archive grows, folders help you keep things structured. To create one, open the "Folders" tab in the side panel and click the "+"-icon
Give the folder folder a name and click Save. You can now click into it and upload assets directly, or move existing ones in from elsewhere in the archives. Subfolders can be created the same way by right-clicking an existing folder and choosing "Create sub folder", letting you nest folders as deep as your archive needs.
#### Private folders Folders can also be made private by enabling "Make folder private" when creating or editing them. Assets placed inside a private folder are no longer available on a public URL and can only be accessed from within the DAM or through the API, making it a good place for material that shouldn't be reachable outside the PIM. ### The asset page Opening an asset takes you to its own page. the "Asset" tab is a fixed part of every asset type, always there, showing the file itself alongside a toolbar of actions.
Beyond that, further tabs can be added under Settings > Data models > Asset types > Model setup, where "Add tab" lets you add one of a few tab types, a "Dynamic tab", freely labeled and structured with whatever sections and fields the asset type needs, the same way tabs are set up on product strutures, an "External tab", which shows external content in an iframe, or an "Asset references" taab, a built-in tab that lists every entity referencing the asset
Whichever tabs are avialable, the right-hand side always shows a few panels about the asset itself. "General information" covers the essentials, who created and last modified it, its file size and resolution, and its Url and CDN url, which can be copied directly from here. Below that "Metadata" shows more technical details read directly from the file.
"Tags" sits between the two. Where folders organize assets by where they belong, tags let you categorize assets across folders, if you have product images spread across several folders, tagging them all with a shared keyword makes it possible to find them all at once, no matter which folder they sit in.
#### The Asset tab The toolbar on the "Assets" tab covers everything you can do to the file itself. "Versions" shows previous versions of the asset, letting you see who replaced the file and when, and roll back if needed.
"Replace" lets you upload a new file in place of the current one, while keeping the same asset, its internal id, tags, and any data already filled on it.
"Rename" changes the asset's filename. By default this only updates the display name, but enabling "Also nename psysical file" renames the file on disk too, which gives the asset a new Url and CDN url and breaks any links using the old ones.
"Hotspots" opens the hotspot tools covered in [How to use hotspots](/tutorials/guides/how-to-use-media/how-to-use-hotspots.md), "Image studio" opens the AI powered editing tools covered in [How to use AI Studio](/tutorials/guides/how-to-use-media/how-to-use-ai-studio.md), and "Download" gets you the file itself.
If the asset was created or edited through AI Studio, an extra "AI source" icon appears in the toolbare. It shows what the asset was created from, along with what was done to it, for example "Edited with prompt", giving you a trail back to the original file.
#### The asset reference tab On this asset type, the "Asset references" tab has a "Product references" section, listing every product the asset is used on, shown as a table with the product's information. It's a quick way to see exacktly where an asset is being used before, for example, replacing it or deleting it.
### Searching for assets Assets can be found using the search bar above the assets. Type in what you're looking for, and the results update as you go.
Assets can also be found by adding a specific field, instead of browsing through folders. Folders can be combined, for example filtering on"Tags" to only showing assets tagged with a specific keyword, while also filtering on "Asset type" to narrow it down further.
{% hint style="info" %} Read more about how to search efficiently [here](/tutorials/guides/how-to-search-efficiently.md) {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.struct.com/tutorials/guides/how-to-use-media/how-to-get-started-with-media.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.