Add a New Collection

Want to create a new product family on the website? This guide walks you through setting up a master family collection in SharePoint so it displays on the Our Collections page.

What you'll accomplish: Create a new collection folder with the main collection image that represents the product family.

Time required: 5-10 minutes

What you need:

  • Access to SharePoint (Marketing Assets for 2023 directory)

  • Collection image file (1400 x 686 px, JPG/JPEG or WEBP)

  • The official family collection name

Where You're Working

SharePoint Directory:

Documents / Website assets / Collection placeholder images

All family collection folders live here. This is where the backend system looks to map collection data across Business Central and SharePoint.

Step 1: Create the Collection Folder

Navigate to the Collection placeholder images folder and create a new folder.

Naming convention:

  • Format: [Family Name] + Collection

  • Example: Sorrento Collection

  • Uppercase or lowercase doesn't matter to the system

Important: The folder name must be exact and spelled correctly. This is what triggers the backend system to create the collection.

Collection placeholder images directory showing family collection folders

Common Naming Examples:

  • ✅ Belluno Collection

  • ✅ Toscana Collection

  • ✅ Verona Collection

  • ❌ Belluno (missing "Collection")

  • ❌ Belluno collection (lowercase is fine, but be consistent)

Step 2: Add the Main Collection Image

Upload the image that represents this collection to the folder you just created.

Image Requirements:

Dimensions:

  • Width: 1400 px

  • Height: 686 px

  • These dimensions are required - other sizes will be auto-rejected

File Types:

  • JPG/JPEG

  • WEBP

  • No other formats accepted

File Naming:

  • Name the file after the family name

  • Examples: sorrento.jpg, belluno.jpeg, toscana.webp

  • Uppercase or lowercase doesn't impact the system

  • Must match the family name (not the full folder name)

Collection folder with correctly named image file (collection name + .jpg)

Note about DPI: DPI only applies to printing and is not applicable to digital files for the website.

Step 3: Verify Your Setup

After uploading, your folder structure should look like this:

Checklist:

What Happens Next

Once you create the folder and upload the image, the backend system:

  1. Detects the new folder as a triggered event

  2. Validates the image meets requirements

  3. Maps the collection data across SharePoint and Business Central

  4. Syncs the collection to the website

Sync timing: Typically 10-15 minutes. Refresh the Our Collections page to see your new collection.

Important Notes & Common Issues

Auto-Rejection Notifications

You'll receive an email notification if:

  • Image dimensions don't match 1400 x 686 px

  • File type is not JPG/JPEG or WEBP

  • File name doesn't follow the naming convention

What to do: Delete the incorrect file and re-upload a corrected version. See troubleshooting below.

Incorrectly Named Folders

If you create a folder with the wrong name or spelling:

Don't rename it. Renaming doesn't trigger a new event in SharePoint.

Instead:

  1. Delete the incorrectly named folder

  2. Create a new folder with the correct name

  3. Upload your image to the new folder

This ensures only matching family collection folders and Business Central entries get added to the database and website.

Incorrect Image Files

If you uploaded the wrong image or it has incorrect dimensions/naming:

  1. Delete the current file from SharePoint

  2. Re-upload the corrected image file

Don't try to replace or rename in place. Delete first, then upload the correct file.

Troubleshooting

Issue: Collection not showing on website after 15 minutes

Solutions:

  • Verify folder name includes " Collection" at the end

  • Check image dimensions are exactly 1400 x 686 px

  • Confirm image file type is JPG/JPEG or WEBP

  • Ensure image file name matches the family name

  • Check for auto-rejection email notification

Issue: Received auto-rejection email

Solutions:

  • Read the email. It tells you what's wrong

  • Delete the rejected file from SharePoint

  • Fix the issue (resize image, rename file, convert format)

  • Re-upload the corrected file

Issue: Need to rename an existing collection

Solutions:

  • See the guide: Update a Collection for name change workflow

  • Short version: Create new folder with new name, move assets, delete old folder

Related Guides

Need to configure the Business Central side? Collections also need setup in BC to map products correctly. See the Business Central guides for attribute configuration.

PreviousUnderstanding the Backend AutomationNextUpdate a Collection