Image Archive: Upload, Organize, and Reuse Your Images

The image library is a single, centralized location where you can store all your images so you can reuse them throughout your entire online store. Instead of uploading the same image over and over again, you upload it just once and retrieve it wherever you need it. This is especially useful during seasonal changes: when it’s time to switch the homepage from summer to winter, you can simply pull up last year’s images instead of starting from scratch.

At the same time, you can now insert images directly into your text. An “Insert Image” button in the text editor lets you place an image right in the middle of a product description, a page, a blog post, or a campaign text—just like you’re used to in a word processor.

How to Find the Image Library

You’ll find the Image Library in the admin panel under Design → Image Library. Here you’ll see all the images you’ve added to the library, organized in a clear gallery with folders listed in the menu on the left.

Upload Your Images

You can upload images in two ways:

• Drag and drop. Drag one or more image files from your computer into the upload field.
• Click and select. Click the upload field and select the images in the file browser. You can select multiple images at once.

If you want to place the images directly into a specific folder, select the folder from the menu on the left before uploading. The upload field shows which folder the images will be placed in.

Organize into folders

Folders help you keep track of your images, for example, by season or campaign. In the menu on the left, you can:

• Create a folder using the "New Folder" button. The folder will remain even if it’s empty, so you can create it first and upload to it later.
• Rename or delete a folder using the three dots next to the folder.
• View the number of photos in each folder directly in the menu.
• Search for an image by name or description.

When you delete a folder, the images are not deleted. They are simply moved out of the folder and remain in the archive under "All."

Edit, move, and organize

Click the pencil icon on an image to edit it. Here, you can add alt text (a description of what the image shows), move it to a folder, or delete it. You can also copy the image’s URL if you need to use it elsewhere. If you click on the image itself instead, it will be selected (see the section on managing multiple images below).

If you need to manage multiple images at once, select them (click on the images or use “Select All”) and use the action bar at the bottom to move them to a folder or delete them all at once.

Insert an image into a text

When editing a product description, a page, a blog post, or text for a category, campaign, or landing page, you’ll find an image button in the text editor’s toolbar. Here’s how:

1. Place the cursor where you want the image to appear, and click the image button.
2. The image library will open. Select an image or upload a new one directly in the window.
3. Select a size (small, medium, large, or very large) and click “Insert Image.”
4. If you want the image centered or aligned to the left or right, select it in the text and use the alignment buttons in the toolbar.

The image is inserted as a link to the gallery, so you don’t need to upload it again. You can use the same image as many times as you like.

Images are automatically optimized

You don’t need to worry about file sizes. Shoporama optimizes the images for you:

• When you insert an image, you select a size (e.g., medium at 800px), and the image is delivered in that exact size, not in the original’s full resolution.
• Images are delivered in the modern WebP format, which results in smaller file sizes.
• The resized images are cached so they load quickly on subsequent visits.

This means that even a large original image won’t slow down your product description, because only the selected size is downloaded. To learn more about how Shoporama handles quality and format, see Image Quality and Image Format and Optimizing Images for Mobile.

For developers: image adjustment in custom themes

This section is only relevant if you’re building or customizing your own theme.

When an image is aligned in the editor, a CSS class is applied to the image: aligncenter, alignleft, or alignright. Shoporama’s built-in themes style these classes so that the alignment works out of the box. If you’re building your own theme that strips inline styles from the HTML, you’ll need to add CSS for these classes yourself, for example:

.aligncenter { display: block; margin-left: auto; margin-right: auto; }
.alignleft { float: left; margin: 0 1rem 0.5rem 0; }
.alignright { float: right; margin: 0 0 0.5rem 1rem; }

For developers: manage the archive via REST and AI (MCP)

The archive’s features can also be managed programmatically:

• REST API. You can list images, upload them (from a public URL or as base64), assign a folder or description to an image, and create, rename, or delete folders. Images are located under /library-image and folders under /library-folder. Large images are automatically scaled to a maximum of 2000px and served as WebP, just like in the admin panel.
• AI (MCP). The same functions are available as AI tools (e.g., library_image_create and library_folder_create), so an AI assistant can manage images for you. The tools can be enabled or disabled under Integrations → Manage the Store with AI (the "Customize Tools" button) in the "Image Library" domain.

Note: Only the archive’s own functions are available via the API. Inserting an image into text is done in the text editor.

Frequently Asked Questions

Do I have to upload the same image again every time I want to use it?

No. You upload the image once to the archive and retrieve it wherever you need it. That’s the whole point of the archive. For example, you can reuse last year’s spring photos without having to upload them all over again.

Do I need to create the folder first, or can I move images as I go?

Both methods work. You can create a folder using “New Folder” and upload to it, or you can select photos afterward and move them to a folder via the action bar. The same option is also available when you edit a single photo.

Can I select multiple photos at once?

Yes. Click on the images you want to select, or use “Select All.” An action bar will then appear at the bottom where you can move or delete them all at once.

How do I center an inserted image or make it smaller?

When you insert the image, choose a size (small, medium, large, or very large). If you want to center it or align it to the side, select the image in the text and use the alignment buttons in the editor’s toolbar.

Do images automatically get alt text, and does that matter for SEO?

You write the alt text for each image yourself, and it’s used when the image is displayed. Good alt text helps both screen readers and Google Image Search, so it’s worth filling out.

Do large images slow down my page?

No. You choose the image size when you insert it, and it’s delivered as a compressed WebP file in that exact size. If you select “small,” the page only loads a small file, so the loading speed remains fast—even on mobile.

Is the image library shared across my stores?

No. Each online store has its own private image archive. If you have multiple stores, they cannot see each other’s images or folders.

What happens if I delete an image from the archive?

The image is removed. If it was embedded in text somewhere, it will disappear there as well, so only delete images you’re sure aren’t in use. Moving or renaming folders, on the other hand, is completely safe, as images are never deleted when you do that.

Does image alignment work in my own custom theme?

In Shoporama’s built-in themes, the alignment works right out of the box. If you’re building your own theme, you may need to add CSS for the three alignment classes (see the “For Developers” section above).

If you have any questions about the Image Library, feel free to email support@shoporama.dk.