> ## Documentation Index > Fetch the complete documentation index at: https://docs.fetchski-attract.com/llms.txt > Use this file to discover all available pages before exploring further. # The media library > Upload your photos, videos and documents once, then use them on any page. Upload a photo, video or document once, then use it on any page, post or album. Your files live in the media library. Change an image's details, such as its alt text, and every page that uses it shows the change. **Who can do this:** Contributors, Editors, Admins and Owners. Publishing a new video needs an Editor, Admin or Owner. **AI Image Generation** is for Editors, Admins and Owners. ## Before you start * Sign in to your site. * The library has 3 parts, each with its own window: **Images**, **Videos** and **Files** (documents such as PDFs). * Each part can be sorted into folders. See [Folders](https://docs.fetchski-attract.com/guides/media/folders.md). ## Open the library Open the command palette (⌘K, or Ctrl+K on Windows) and choose **Images**, **Videos** or **Files**. Or use a [shortcut](https://docs.fetchski-attract.com/guides/get-started/toolbar-and-command-palette.md#keyboard-shortcuts) while you're not typing in a box. Press **G**, let go, then press **I** for Images, **V** for Videos or **F** for Files. The window opens as **Manage Images**, **Manage Videos** or **Manage Files**. On the left is the folder list. In the middle are your folders and files. ![The Manage Images window: the folder list on the left (Library, Daycare, Events, Training, then All media).](https://mintcdn.com/fetchski-attract-api/l0eBwtzJpLtH9LWE/images/cms/guides/media/media-library/guides-media-media-library-images-window-light.png?fit=max\&auto=format\&n=l0eBwtzJpLtH9LWE\&q=85\&s=744468604982143ac8a8a72a8645d19c) The Images window opens on Library: your folders first, then anything not in a folder. ## Find a file * **Library** at the top of the folder list shows your folders, then the files that aren't in any folder, under **Unfiled**. * Choose a folder to see what's in it. The path above the grid shows where you are, such as **Library › Events › Summer splash day**. Choose any part of the path to go back up. * **All media** at the bottom of the folder list shows every file in one list, whatever folder it's in. * To search, type in the search box. You search the folder you're in and the folders inside it. Choose **Search everywhere** to search the whole library. ## Upload images **1. Open the folder** In **Images**, open the folder the new images belong in. To leave them out of any folder, stay on **Library**. **2. Add the files** Drag your images onto the **Drop new media here** box. Or choose the box to browse your computer. **3. Wait for the upload** Each image appears in the grid when it's ready. It's saved in the folder you were viewing. ![The Events folder open in Manage Images, with three photos being dragged onto the Drop new media here box, which is highlighted.](https://mintcdn.com/fetchski-attract-api/l0eBwtzJpLtH9LWE/images/cms/guides/media/media-library/guides-media-media-library-upload-light.png?fit=max\&auto=format\&n=l0eBwtzJpLtH9LWE\&q=85\&s=ba95e276ffaccd1a1fc0416437c666ca) Drop images into the folder you're viewing. ## Add a video or a file Videos and files are added one at a time, each with its own details. **1. Open Videos (or Files) and choose New Video (or New File)** **2. Give it a title and choose the file** Videos take **mp4** or **webm** files. For a background video, keep the clip short and muted, ideally under 10 MB. **3. For a video, add a Poster / fallback image** Visitors see it while the video loads. Visitors who've asked their device to reduce motion see it instead of the video. **4. To put it in a folder, choose one under Folder (on the Basics tab for a video, the Organize tab for a file)** **5. Finish it** * **A file**: save it. It's ready to choose in any section straight away. * **A video**: choose **Publish**. A video is a draft until it's published, like a page, and you can choose it in a section once it's published. Contributors choose **Submit** instead, for an Editor to publish. ![The new video window with a title ("Puppy playtime"), the Video file chosen, a Poster / fallback image added and the Folder set to Daycare.](https://mintcdn.com/fetchski-attract-api/l0eBwtzJpLtH9LWE/images/cms/guides/media/media-library/guides-media-media-library-new-video-light.png?fit=max\&auto=format\&n=l0eBwtzJpLtH9LWE\&q=85\&s=2bbaf4702db9131cef029f8fbbab7c1c) A video with its poster image, filed in a folder. ## Edit an image's details Choose an image in the grid to see its details on the right, then edit them. Save your changes in the panel when you're done. * **Alt Text**: a short description of the picture for people who use screen readers. Describe what matters, such as "Two puppies playing tug-of-war on the lawn". Every image that carries meaning needs one. * **Credit** and **Credit URL**: who took the photo, and a link to them. * **Folder** (on the **Organize** tab): the folder the image lives in. * Tags: choose images, then **Tag** to group them by topic. The tags are listed under the folders, so you can filter by them. Images have no draft. Once you save, the change shows straight away on every page that uses the image, including published ones. ![One image selected in Manage Images, with its details open on the right: Alt Text filled in ("Two puppies playing tug-of-war on the lawn"), Credit filled in.](https://mintcdn.com/fetchski-attract-api/VHp0B0s1nBbMi7JQ/images/cms/guides/media/media-library/guides-media-media-library-image-details-light.png?fit=max\&auto=format\&n=VHp0B0s1nBbMi7JQ\&q=85\&s=c3b2fc0787781e6f93287ccd160de4f7) Alt text describes the picture for people who can't see it. ## Crop an image or set its focal point Cropping happens where the image is used, so the same photo can be cropped differently on two pages. **1. On the page, choose Edit in the edit bar and open the section that holds the image** **2. Select the image and choose Image Adjustments** The **Adjust Image** window opens. **3. Drag the crop box, or type sizes under Crop & Size (px)** **4. Drag the dot to the most important part of the picture** That's the focal point. When the image is trimmed to fit a small screen, that part stays in view. **5. Save, then publish the page** ![The Adjust Image window over a page, with a crop box on a dog photo and the focal-point dot on the dog's face.](https://mintcdn.com/fetchski-attract-api/VHp0B0s1nBbMi7JQ/images/cms/guides/media/media-library/guides-media-media-library-adjust-image-light.png?fit=max\&auto=format\&n=VHp0B0s1nBbMi7JQ\&q=85\&s=c3bf148c2acc6e176ecbb9cb1b7659aa) Crop the photo and mark what must stay in view. ## Make an image with FetchskiAI Describe a picture and have FetchskiAI make it: in **Images**, choose **AI Image Generation**. The image you keep is saved to your library like any upload. See [AI image generation](https://docs.fetchski-attract.com/fetchskiai/image-generation.md). ## Move, archive or delete * **Move to folder…**: choose files, then choose **Move to folder…** to file them somewhere else. See [Folders](https://docs.fetchski-attract.com/guides/media/folders.md). * **Archive**: take files out of the library without deleting them. You can restore them later. * **Delete forever…**: remove files for good. Editors, Admins and Owners can do this. If another item in the library uses the same stored file, that file is kept for it. See [Archive, restore and delete](https://docs.fetchski-attract.com/guides/content/archive-restore-delete.md). Before you archive or delete a file that a page still uses, read [Archive, restore and delete](https://docs.fetchski-attract.com/guides/content/archive-restore-delete.md). The page shows a gap where the file was, and the CMS flags it as [broken media](https://docs.fetchski-attract.com/guides/media/broken-media.md). ## What happens next Uploaded images and files are ready to use straight away. Choose them in any section's image or file field. A new video needs publishing first. Visitors see a file on your site once a published page uses it. > [!WARNING] > > The media library is for your site, not for private storage. After you archive a file, it can stay reachable at its web address until it's deleted forever. Don't keep private documents in the media library. ## Troubleshooting > [accordion] This file is too large > > Each kind of file has a size limit. When a file is bigger, the upload stops. You see a message such as "This file is too large (max 15 MB for images)." The message names your site's limit for that kind of file. > > Make the file smaller and upload it again. For photos, export them at a web size (2000 pixels wide is plenty). If you need a higher limit, contact Fetchski Support. > [accordion] I can't find an image I uploaded > > It's probably in a different folder. Choose **All media** to see every image at once, or search and choose **Search everywhere**. > [accordion] I don't see AI Image Generation or Delete forever… > > These are for Editors, Admins and Owners. Ask an Admin if you need them. ## Related > [card] [Folders](https://docs.fetchski-attract.com/guides/media/folders.md) > > sort your library into folders. > [card] [Broken media](https://docs.fetchski-attract.com/guides/media/broken-media.md) > > fix pages that point at a missing image. > [card] [Archive, restore and delete](https://docs.fetchski-attract.com/guides/content/archive-restore-delete.md) > > tidy the library safely. > [card] [AI image generation](https://docs.fetchski-attract.com/fetchskiai/image-generation.md) > > make new images with FetchskiAI. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.