Configuring Product Information and Media

The Product information and Image/video sections determine how your product appears on your storefront. Providing clear product information and high-quality media helps customers understand your products and improves their visibility in search results.

This guide explains how to add a product name and summary, write or generate a product description, and manage product images and videos.

Accessing the Product Settings Page

Before configuring product information and media, open the product settings page:

1. In your SHOPLINE Admin, go to Products.

2. Click Create product to create a new product, or select an existing product to edit.

   

3. Configure the product information and media using the settings described in the following sections.
4. When you're finished, click Save or Update to save your changes.

Configuring the Product Name and Summary

The Name and Summary help customers identify your product and understand its key selling points. Configure the following fields:

• Name: Enter a descriptive product name that may include the brand, model, product type, color, or other identifying details. For the best display and search performance, keep the name under 70 characters.
• Summary: Enter a brief overview of the product's key features or selling points. The summary may appear in product previews and search results and supports up to 400 characters.

Writing a Product Description

The Description field uses a rich text editor that lets you create and format product descriptions. You can generate content with AI, customize text, insert images and videos, add tables and links, and switch to the code editor for advanced customization.

Editing and Formatting Product Descriptions

The rich text editor supports the following capabilities:

• Format text: Apply headings, font styles, colors, alignment, lists, and block quotes to organize your content.
• Insert media: Add images and YouTube videos directly into the description. For more information, see "Adding Images and Videos to the Product Description" below.
• Insert tables and links: Add tables to organize product information and hyperlinks to direct customers to additional resources.
• Edit source code: Click the <> icon to switch to the code editor and add or edit custom HTML, CSS, or JavaScript.
• Use full-screen mode: Click the Full Screen icon to expand the editor while writing long descriptions.

Tips for Writing Product Descriptions

Follow these best practices when writing product descriptions:

• Avoid keyword repetition: Instead of repeating keywords already used in the product name, use long-tail keywords, variants, or synonyms.
• Highlight product value: Include important selling points such as product benefits, service guarantees, warranties, or promotional offers.
• Keep the content easy to scan: Use headings, short paragraphs, and bullet lists whenever appropriate.

Generating Product Descriptions with AI

The Automatic writing feature uses AI to generate product descriptions. The first time you use it, you'll be prompted to accept its terms of use.

To generate a description with AI:

1. Click the sparkle icon at the left of the Description toolbar to open Automatic writing.

   

2. In Product functions or keywords, describe the product's function or features (up to 1,000 characters). The more specific your input, the better the result.

3. Choose a tone from the dropdown. Six options are available:

   

• Professional: States facts plainly, with minimal descriptive language.
• Helpful: Uses customer-oriented language.
• Persuasive: Uses motivational language.
• Bold: Uses encouraging, confident language.
• Funny: Uses light-hearted, quirky, or casual language.
• Delicate: Uses a style typical of light luxury products.

4. Click the arrow icon to generate a description.

5. Review the result. Click Rewrite to generate a different version.  

   

   To rewrite part of an existing description, select the text you want to edit, click the sparkle icon, review the AI-generated suggestion, and then click Enter to replace the selected text with the suggestion.

   

   Note: You can rate each AI-generated result as Helpful or Unhelpful to help improve future AI-generated descriptions.

6. Click Enter to add the generated text to the Description field, or Cancel to dismiss it.

Adding Images and Videos to the Product Description

In addition to text, the Description editor lets you insert images and videos directly into your product description.

Adding Images

In the toolbar, add images in the following ways:

• Insert an image by URL: Click the Insert/Edit Image icon. In the General tab, enter the image URL in the Source field, optionally configure the image's Alternative description, Width, and Height, then click Save.

  

• Upload an image: Click the Insert/Edit Image icon, open the Upload tab, then drag and drop an image into the upload area or click Browse For An Image to select a file from your computer.

  

• Bulk upload images: Click the Bulk Upload icon, then hold the Shift key while selecting multiple images from your computer. After the upload is complete, the images are inserted into the description in the order they were selected.

  

• Insert an image from the File Library: Click the File Library icon, select Image from the File type dropdown, choose the images you want to insert, and click Complete.

  Note: Images selected from the File Library support a maximum file size of 20 MB and a maximum resolution of 35 MP.

  

After inserting an image, you can click the image, then click the Go to editor icon to:

• Update the ALT attribute to describe the image for accessibility and SEO.

  Note: Updating an image's ALT attribute inside the editor only changes that image in the product description. It doesn't update the original file stored in the File Library.

• Crop the image using Free crop, Square, or 4:3.
• Flip the image Horizontal or Vertical.
• Rotate the image to the Left side or Right side.
• Download the image.

Adding Videos

In the toolbar, add images in the following ways:

• Embed a YouTube video: Click the YouTube Video icon, paste the YouTube video URL, and click Confirm.

  

• Insert a video from the File Library: Click the File Library icon, select Video from the File type dropdown, choose the video you want to insert, and click Complete.

  

If you insert a video from the File Library, you can click the video, then click the Go to editor icon to:

• Update the Video cover. 
• Edit the Alt text.
• Download the video.

Adding Images and Video

Use the Image/video section to upload and manage the images and videos displayed on your product page.

Adding Images

Before uploading images, make sure they meet the following requirements:

• Supported formats: .jpg, .png, .webp, and .gif
• Maximum resolution: 35 MP
• Recommended width: 1,600 px or wider
• Recommended file size: Under 4 MB for optimal performance
• Maximum file size: 20 MB 

You can add product images in the following ways:

• Upload images: Click the + icon, then select image files from your computer.

  

• Drag and drop files: Drag and drop image or video files from your computer into the upload area.

• Add from the File Library: Click Add from file library, select Image from the File type dropdown, choose the images you want to insert, and click Complete.

  

After inserting an image, click the Expand icon on the image to:

• Update the ALT attribute to describe the image for accessibility and SEO.

  Note: Updating an image's ALT attribute inside the editor only changes that image in the product description. It doesn't update the original file stored in the File Library.

• Add a Caption description.
• Crop the image using Free crop, Square, or 4:3.
• Flip the image Horizontal or Vertical.
• Rotate the image to the Left side or Right side.
• Download the image.

Managing Images

After uploading images, you can change their display order, edit them, or remove them.

• Change the cover image: The first image uploaded becomes the product's cover image, which is displayed in your product list and collections. To change it, drag another image to the first position using the six-dot handle.
• Preview and edit images: Click an image to preview it at full size. From the preview window, you can crop, rotate, or flip the image. You can also add ALT text to improve accessibility and search engine optimization (SEO).
• Delete images: Select an image and click Delete to remove it.

Adding Videos

Before uploading videos, make sure they meet the following requirements:

• Supported format: .mp4
• Maximum file size: 20 MB

You can add product videos in the following ways:

• Embed a YouTube video: Click Add video URL, paste the YouTube URL, and click Confirm.

  

• Add from the File Library: Click Add from file library, select Video from the File type dropdown, choose the desired video files, and click Complete.

  

After inserting a video, click the Expand icon on the video to:

• Update the Video cover.
• Edit the Alt text.
• Add a Caption description.
• Download the video.

Troubleshooting Video Display and Playback Issues

If a video has been successfully added but appears as a blank screen, keeps loading, or fails to play on your storefront, try the following:

• Check the YouTube video settings: If you added the video using a YouTube URL, make sure that:
  • The video is set to Public or Unlisted. Private videos cannot be embedded.
  • The video has not been deleted or removed.
  • The video owner has enabled embedding.
  • The video is not subject to copyright or regional restrictions. Some videos may not be available for embedded playback in certain countries or regions.
• Wait for the video to finish processing: After a video is uploaded, the system may need some time to process it. During this time, the video may not load properly. Wait a few moments, then refresh the page and try again.
• Rule out browser caching issues: Try a hard refresh (Ctrl + F5 on Windows or Command + Shift + R on Mac), or open your storefront in an incognito/private browsing window.
• Check your theme or custom code: Third-party themes or custom code, such as CSS or JavaScript, may affect video display or playback. Temporarily switch to a SHOPLINE official theme to check whether the issue is related to your current theme or custom code.

If the issue persists after completing these troubleshooting steps, click the chat icon in the bottom-right corner of your SHOPLINE Admin to contact SHOPLINE Support for further assistance.

Important Notes About Product Information and Media

• Keep the product Name under 70 characters and the Summary under 400 characters for the best display and search results.
• The AI description generator is an early-access feature with daily and monthly usage limits, and it isn't available in the European Union.
• The first image uploaded becomes the cover image shown in your product list and collections — reorder your images if you want a different one to appear first.