emfasemfas

Uploading images

Upload product images to Emfas individually or in bulk

Product images are a core part of your catalog. You can upload images to Emfas directly from your computer, either one at a time or in bulk. Once uploaded, images are automatically matched to your products and can be used for AI content generation, alt text, and more.

Uploading images to a single product

To add images to a specific product or variant:

  1. Open a product in the catalog
  2. Click the image area on the product page
  3. Select one or more image files from your computer
  4. The images are uploaded and attached to that product

This is the quickest way to add images when you're editing an individual product.

Bulk uploading images

When you need to upload images for many products at once, use the bulk upload feature. This lets you upload a batch of image files and automatically match them to the right products based on filenames.

Accessing bulk upload

  1. Go to the Assets section in the sidebar
  2. Click Upload in the top right corner

Preparing your files

Name your image files using the ID of the product or variant they belong to. Emfas matches files to products based on the filename.

File naming format: {ID}.jpg or {ID}_{number}.jpg

FilenameWhat it matches
SKU123.jpgMatches the product or variant with ID "SKU123"
SKU123_1.jpgFirst image for "SKU123"
SKU123_2.jpgSecond image for "SKU123"

The numeric suffix (_1, _2, etc.) controls the image order without affecting which product the image matches to.

Matching modes

Emfas supports two ways to match files to products:

ModeHow it works
Entity IDs (default)Matches filenames to product, variant, or SKU IDs
Attribute searchMatches filenames by searching a specific field's values

Entity IDs is the most common approach. It uses the lookup order SKU → Variant → Product to find the right match.

Attribute search is useful when your filenames don't correspond to IDs but instead match values in a specific field (like an internal reference code).

Uploading a ZIP file

Instead of selecting individual files, you can upload a single ZIP file containing all your images. Emfas automatically extracts the contents and processes each image file individually.

This is convenient when you have a large batch of images organized in a folder on your computer.

ZIP file contents

Emfas extracts all image and video files from the ZIP and ignores system files like .DS_Store. Subfolder structure inside the ZIP is flattened — only the filenames matter for matching.

Upload settings

Before starting the upload, you can configure two optional settings:

SettingWhat it does
Auto-connect to media fieldsAutomatically connects uploaded images to your products' image attributes after upload
Reorder all imagesSorts all images (including previously uploaded ones) alphabetically by filename

These settings are remembered between upload sessions so you don't need to configure them each time.

Auto-connect

Enable auto-connect if you want uploaded images to immediately appear in your products' image fields. Without this, images are uploaded as assets but need to be manually connected to media attributes.

Reviewing matches

After selecting your files, Emfas shows you which products each file matched to. Review the matches before confirming the upload to make sure everything looks correct.

If a file doesn't match any product, it will be flagged so you can check the filename or adjust your matching settings.

Supported file formats

TypeFormats
ImagesJPEG, PNG, WebP, SVG, GIF
VideoMP4

After uploading

Once your upload is complete, you can:

  • View all uploaded assets in the Assets section
  • Use image to text to generate content from the uploaded images
  • Create a proposal directly from the upload results to generate AI content for the newly uploaded products
  • Browse your catalog and filter by products with images

Generate content from new images

After a bulk upload, Emfas offers to create a proposal for the affected products. This is a quick way to generate descriptions, alt text, and other content based on the new images.