> ## 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. # Photo albums > Choose photos from your media library, put them in order, and show the album in any gallery section. Show a hand-picked set of photos, in the order you want, on any page. Build the album once from your media library, then show it in a Gallery section. **Who can do this:** Contributors, Editors, Admins and Owners can build and change albums. Publishing them needs an Editor, an Admin or an Owner. ## Before you start * Upload your photos to the media library first, or upload them while you pick. See [Media library](https://docs.fetchski-attract.com/guides/media/media-library.md). * Give each photo alt text in the media library. The album uses it for screen readers and as the photo's caption in the full-size photo viewer (the lightbox) that opens when a visitor chooses a photo. * Set a focal point on photos with a clear subject. Gallery layouts that crop a photo keep that spot in view. * To show the album on a page, add a Gallery section too. See [Gallery](https://docs.fetchski-attract.com/guides/sections/gallery.md). ## Build an album **1. Open the list** Press ⌘K (Ctrl+K on Windows) and choose **Photo Albums** under **Manage**. You can also press G, then L. **2. Start a new album** Choose **New Photo Album**. The editor opens on the **Basics** tab. **3. Name it** Type a **Title**, such as "Summer play days". Add a **Description** if you like. It's a note for your team, and Gallery sections don't show it. **4. Choose the photos** Under **Photos**, choose **Browse Images**. Select every photo you want, then choose **Select Images**. You can upload new photos from the same window. ![The image chooser opened from an album's Photos field, with 6 photos of puppies at play selected (check marks visible) and the confirm button ringed.](https://mintcdn.com/fetchski-attract-api/MsE85fjBwOCKqNGh/images/cms/guides/content/photo-albums/guides-content-photo-albums-browse-light.png?fit=max\&auto=format\&n=MsE85fjBwOCKqNGh\&q=85\&s=0069a2b2428f41da5776cc805da01703) Pick the album's photos from your media library. **5. Put them in order** Back in the editor, drag the photos into the order you want. Galleries show them in this order. ![The album editor on the Basics tab: Title "Summer play days", a one-line Description, and the Photos field holding 6 photos in order, one being dragged.](https://mintcdn.com/fetchski-attract-api/MsE85fjBwOCKqNGh/images/cms/guides/content/photo-albums/guides-content-photo-albums-basics-light.png?fit=max\&auto=format\&n=MsE85fjBwOCKqNGh\&q=85\&s=cb41102734530817a0cd9f760485f5f1) Drag the photos into the order your gallery shows. **6. Save it** To finish later, open **More save options** (the arrow next to the main button) and choose **Save Draft**. When it's ready, choose **Publish**. Contributors choose **Submit** instead, and an Editor publishes it. ## Show it on a page In a **Gallery Preview** or **Gallery (Full)** section, open the **Gallery** tab. Set **Photo source** to **Photo Album (hand-picked, hand-ordered)**, then choose your album under **Album**. The same album can appear in any number of sections, on any number of pages. When you change the album and publish it, every section that shows it updates. See [Gallery](https://docs.fetchski-attract.com/guides/sections/gallery.md). ## Keep its photos filed in a folder Keep your media library tidy by filing each album's photos in one folder. You set this on the album's **Organize** tab. * **Keep photos organized in a folder**: on by default. When you publish, photos in the album that aren't in any folder yet move into the album's folder. * **Album folder**: the folder those photos move into. Leave it empty and Attract makes one for you, inside the **Albums** folder of your media library. Or choose any folder you already have. ![The album editor on the Organize tab: Keep photos organized in a folder on, and the Album folder "Summer play days" chosen.](https://mintcdn.com/fetchski-attract-api/eK8pBpUam_xD3uEM/images/cms/guides/content/photo-albums/guides-content-photo-albums-organize-light.png?fit=max\&auto=format\&n=eK8pBpUam_xD3uEM\&q=85\&s=dca9c6461374af338a57d595248dcc70) Each album can keep its photos in its own folder. Filing never undoes your own choices: * Photos you've already filed in another folder stay where they are. * Taking a photo out of the album doesn't move it back. * If you change the folder later, only photos filed from then on go to the new one. See [Folders](https://docs.fetchski-attract.com/guides/media/folders.md) to learn more about folders. ## Make an album from a folder Already have a folder of photos? Turn it into an album in a few clicks. **1. Press ⌘K (Ctrl+K on Windows) and choose Images under Manage** **2. Find the folder, open its Folder actions menu, and choose Create album from folder…** **3. Type an Album title and choose Create album** You'll see "Draft album “…” created." The new album is a draft holding the photos directly inside that folder, oldest upload first, up to 500. Photos in subfolders aren't included. Open it in **Photo Albums**, put the photos in order, then publish it. ![The Create album from folder prompt over the Images manager, Album title "Training class graduates", the lede naming the folder and its 12 images.](https://mintcdn.com/fetchski-attract-api/MsE85fjBwOCKqNGh/images/cms/guides/content/photo-albums/guides-content-photo-albums-from-folder-light.png?fit=max\&auto=format\&n=MsE85fjBwOCKqNGh\&q=85\&s=c6309b732c02b902e89fb373633f5f18) Turn a folder of photos into a draft album. ## What happens next A published album shows in every Gallery section that uses it. Visitors never see drafts. If you later archive or delete a photo the album uses, the album's editor shows a missing-images notice so you can replace it. See [Broken media](https://docs.fetchski-attract.com/guides/media/broken-media.md). ## Troubleshooting > [accordion] My album isn't in a gallery section's Album list > > Check the section's **Photo source** is **Photo Album (hand-picked, hand-ordered)**. The **Album** choice only shows for that source. Also check the album is published. > [accordion] A photo has no caption in the lightbox > > Captions come from each photo's alt text. Open the photo in the media library, add alt text, and save. > [accordion] This folder is managed automatically and cannot become an album > > The **Albums**, **Photo Feeds**, **Pages & Posts** and **FetchskiAI references** folders are looked after by Attract. Choose a folder you made yourself. > [accordion] The album “…” already uses this folder > > Each folder belongs to one album. Open that album instead, or choose a different folder. ## Related > [card] [Gallery](https://docs.fetchski-attract.com/guides/sections/gallery.md) > > show an album on a page, in 8 layouts. > [card] [Photo feeds](https://docs.fetchski-attract.com/guides/content/photo-feeds.md) > > fresh photos pulled in on a schedule instead of hand-picked. > [card] [Folders](https://docs.fetchski-attract.com/guides/media/folders.md) > > organize your media library. > [card] [Archive, restore and delete](https://docs.fetchski-attract.com/guides/content/archive-restore-delete.md) > > retire albums you no longer need. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.