Description Templates

Check out this tutorial about creating eBay description templates in the Alpha interface.


Understanding Description Templates

Description Templates let you create reusable listing templates so you don’t have to write a new description each time you want to sell something on a channel. Templates ensure that you give your clients consistent information across listings because your information is premade.

Templates work by sending HTML-formatted documents with product information and company branding. The Description Template appears on the listing directly below the item specifics.

You can create multiple read-to-use description templates for all your selling needs. For example, you can create separate templates for different types of products, or for different seasons to showcase seasonal information.

It is important to note that kits have their own template instructions, so please see below for those steps.

You can easily view and manage all of your premade templates in Sellercloud. On this page, you can view information like:

  • Template name
  • Kit template
  • Master template
  • Created on date
  • Created by user
  • Modified on date

To access the Description Template page in both interfaces:

  • Open a Company > Toolbox > Description Template

From this page, you can also perform actions such as:

  • Click Delete to delete a template
  • Click Edit to edit a preexisting template

Creating a new template

If you are using another description tool, like Frooition, you must create and assign a blank description template to be able to post the item from Sellercloud. Once posted, the correct template must be assigned to the listing on the channel.

When you create a template, you can enter two types of data, static or dynamic.

  • Static Data: Template content that does not change among products; for example, a company logo or contact information. Static content can be entered as text, and formatted with the tools on the toolbars. It can also be entered as HTML or imported from an HTML program like DreamWeaver, so you have full control of the editor and can include your brand in the product description.
  • Dynamic Data – Content that is unique to each product. Each description template is defined in HTML like a webpage, and has placeholders to enter product-specific details. Placeholders in the template are replaced with product information as the listing is published. For example, the #?TopTitle?# placeholder will grab the eBay listing title of the product to which the template has been applied, and include it in the description. Inserting #?LongDescription?# will grab the long description on the product detail page. The content will appear in the way it is placed on the template.
    • Custom Columns can be used as placeholders. For example, if there is a user-defined field Age Rating, this can be placed in the description template as #?AGERATING?#. The actual columns can be added by the System Administrator or Sellercloud Support and set up in the Custom Column page under the Setting Tab. After you complete the fields on the individual product properties pages, you can add it to the description template by referencing the Custom Column as a placeholder.
    • Custom Tags can also be created and referenced with placeholders in the template.
Custom tags are a great way to apply static information. For example, if you have numerous templates and want to apply a logo across all templates, you can create a custom tab as a placeholder that references a logo. Now all you need to do is enter that placeholder into the template and the logo will be displayed.
Click here to learn how to create new description templates in Sellercloud’s Alpha and Delta interfaces.
  1. Open a Company > Toolbox > Description Template.
  2. Click Create New Template.
  3. Select Single Product Template or Kit Product Item TemplateOptional: Check/uncheck Show Simple Editor to view placeholders. Placeholders are explained below.
    1. If you choose Kit Product Item Template, you will have three editors to work  with. See Understanding kit templates to learn more.
  4. Enter Template Name.
  5. Optional: Select Master Template from the dropdown menu. Master templates are explained below.
  6. Enter your Static Data or Dynamic Data.
    1. You can input placeholders by searching and choosing from the list on the right, or by clicking Insert Code Snippet and scrolling for the correct placeholder. You can also choose to write your text without placeholders.
  7. Click Preview to preview your template.
  8. Click Save.

Understanding Master Templates

When creating Description Templates, some information may be overlap between products. For example, your header and footer information may all be identical. This is when you create a Master Template.

A master template acts as a “parent” to your child, description templates. You can add the master template to your description template when creating a description template by selecting the correct Master Template from the dropdown menu.

You can easily manage all your master templates from your Company Settings. On the Manage Master Templates page, you can view, delete, and edit your premade templates.

To access the Manage Master Templates page in both interfaces:

  • Open a Company > ToolboxDescription Master Template.
    • To edit a template, click Edit.
    • To delete a template, click Delete.
Click here to learn how to create a master template in Sellercloud’s Alpha and Delta interfaces.
For your information to connect, you must add the placeholder #?TemplateContent?# into the Master Description Template field.
  1. Open a Company > Toolbox > Description Master Template.
  2. Click Create New Template.
  3. Add your template information. You can input placeholders by searching and choosing from the list on the right, or by clicking Insert Code Snippet and scrolling for the correct placeholder. You can also choose to write your text without placeholders.
  4. Click Preview to preview.
  5. Click Save.

Managing description templates

Description templates can be attached directly to products or set as default templates per-company.

Click here to learn how to attach a template to a product in Sellercloud’s Alpha and Delta interfaces.

Alpha interface

  1. Open a product > Toolbox > *Channel* Properties.
  2. Scroll to find Description Template > Select your template from the dropdown menu.
  3. Click Save.

Delta interface

  1. Open a product > Toolbox > *Channel* Properties.
  2. Click Edit > Listing Details > Description Template > Select your template from the dropdown menu.
  3. Click Save.
Click here to learn how to choose a default template in both interfaces.
  1. Open a Company > Toolbox > Description Template > Select your template from the dropdown menu.
    • For kit templates, click Description Template (Kit Products) > Select your template from the dropdown menu
Click here to learn how to upload a template in both interfaces.
  1. Open a Company > Toolbox Description Template.
  2. Next to Upload Template, click Choose File > Select your file > Click Upload Template.

Defining placeholders

Placeholders are HTML snippets that can pull content from the product summary page. You can use placeholders to simply copy and paste information, which saves you time and ensures your information is correct. While these eBay templates and eBay placeholders are similar to Sellercloud’s e-mail templates and email placeholders, they are different and should not be confused.

Common placeholders are available on the right side of the description template editor, but you can access a full list of placeholders from the Insert Code Snippet dropdown on the template editor’s menu bar.

Click below to see a list of placeholders and definitions.

Placeholders
PLACEHOLDER DESCRIPTION
 #?TopTitle?# eBay listing title.
#?LongDescription?# Inserts the HTML description of the product.
#?ItemIncludesDescription?#
#?ProductSpecificName1?#

#?ProductSpecificValue1?#

To populate Item Specifics in your eBay template, Name and Value. Up to 35.
#?ProductSpecifications?# Will create a table with all Item Specifics.
#?CSSGallery?# Shows the main image with a gallery of thumbnails of the other images, revealing other images when hovering over thumbnails. There are some Client Settings to control thumbnail size and position (eBay Gallery Thumbnail Position, Alignment, Image Size)
#?ListingSubTitle?#  eBay Subtitle.
#?ListingShortTitle?#  eBay Short Title.
#?BrandLogo?# Logo image of the product’s manufacturer as defined in the manufacturer profile.
#?BrandDescription?# Description of the product’s manufacturer as defined in the manufacturer profile.
#?ManufacturerURL?# URL of the product’s manufacturer as defined in the manufacturer profile.
#?ListPrice?# MSRP or “Regular Price”
#?BuyItNowPrice?# Price from the eBay listing.
#?StartPrice?#
#?ProductBullet?#

#?ProductBullet2?#

#?ProductBullet3?#

#?ProductBullet4?#

#?ProductBullet5?#

Populates with the Amazon Bullet points 1-5.
#?OtherAttributes1?#

#?OtherAttributes2?#

#?OtherAttributes3?#

#?OtherAttributes4?#

#?OtherAttributes5?#

Populates with the Amazon Other Attributes 1-5.
#?AmountDifferenceBetweenListPriceAndFixedPrice?# Calculates the dollar amount difference between the list price and BuyItNowPrice.
#?PercentageDifferenceBetweenListPriceAndFixedPrice?# Calculates the percent difference between the list price and BuyItNowPrice.
#?MagentoAttribute_Name_attributeName?#

#?MagentoAttribute_attributeName?#

Replaces “attributeName” with attribute code name in Magento Admin to place the front name in templates.

For example, #? MagentoAttribute_Name_color?# will place “Color” in the template.  Replace “attributeName” with attribute code name in Magento admin to pull value. For example,  #?MagentoAttribute_color?# will place “Blue” in the template.

#?PartsCompatibilityGrid?# Display the part compatibility chart for eBay Motors items. Additionally, the following tags can be defined in CSS classes to beautify the HTML
#?EBayItemConditionName?# eBay condition name selected on the eBay Properties page.
#?ProductConditionInHouseName?# Product condition name used internally in SellerCloud. Read about product conditions here.
#?Variation1Price?# Pulls price for variation of Matrix parent. Up to 19.
#?Variation1FixedPriceQty?# Pulls Qty for variation of Matrix parent. Up to 19.
#?Variation1Dimension?# Pulls Dimension for variation of Matrix parent. Up to 19.
#?Variation1DimensionValue?# Pulls Dimension Value for variation of Matrix parent. Up to 19.
#?RelatedProducItemID1?# Pulls the SKU of the first related item. Similarly, you can change to RelatedProducItemID2 to pull information from the second related product.
Image-related placeholders
#?DescriptionDefaultImage?# Main Description image grabs the entire image HTML tag.
#?DescriptionDefaultImageURL?#  or #?ImageFileMedium?# Shows the URL of the main image of the product.
#?OtherImage01?” Shows additional images of the product. For example, you could show the condition of the product. Up to 20.
#?SupplementalImage01?# Creates a full image tag of the first product image marked supplemental.
#?SupplementalImage02?#
#?SupplementalImageURL01?# URL of the image. Corresponds to the count of images, not their numbers. If your images are numbered as 1,5,9, the placeholders should be #?SupplementalImageURL01?#, #?SupplementalImageURL02?#, #?SupplementalImageURL03?#.
#?ImageFileMediumResized?# Resized main product image, with maximum dimensions defined in the Client Settings. If the image is rectangular with a width greater than height, it will set the width to the maximum dimension defined in the Client Settings, and then calculate the height so the image stays to scale.
#?SupplementalImageResized01?#
#?HostedImageURLOnlyDescription?# URL of the main image if using third-party hosting, such as Flickr.
#?HostedImageURL01?# URL of the supplemental image if using third-party hosting.
Kit-related placeholders
#?KitIncludesGallery?#  Images’ list of all child items.
#?KitIncludesGalleryNotMainItem?# Images list of all child items (excluding main item).
#?KitIncludesNotMainItem?# Product names of all child products (excluding main item).
#?BundledItemsDetail?#
#?BundledItemsDetailNotMainItem?# References tags in bottom editor, excluding the main item.
#?KitMainItemIncludes?#
#?KitMainItemDescription?#  Description of the main item.
#?KitMainItemCustomProductSpecific?#
#?KitIncludesDescriptionImage01?# Pulls the description image. Up to 40.
#?KitIncludesShortTitle01?# Populates with the product’s Short Title. Up to 40.
#?KitIncludesItemQtyCurrent?# Displays the kit components with their quantity in kit.

Editing the HTML

Click here to learn how to embed YouTube Videos in Description Templates.

Youtube videos can be embedded into the HTML of an Long Description and then sent to eBay in the description template..

You can use any of the following HTML. Replace the video link with the link to your video.

Version 1

<object width="560" height="315">
        <param name="movie" value="https://youtube.googleapis.com/v/qdqRu2BDbKc?&autoplay=1&version=2&fs=1"</param>
        <param name="allowFullScreen" value="true"></param>
        <param name="allowScriptAccess" value="always"></param>
        <embed src="https://youtube.googleapis.com/v/qdqRu2BDbKc?&autoplay=1&version=2&fs=1"
          type="application/x-shockwave-flash"
          allowfullscreen="true"
          allowscriptaccess="always"
          width="560" height="315">
        </embed>
        </object>

Version 2

        <object width="560" height="315"><param name="movie"
         value="http://www.youtube.com/v/qdqRu2BDbKc?fs=1&hl=en_US"><param
         name="allowFullScreen" value="true"><param
         name="allowscriptaccess" value="always">
        <embed src="http://www.youtube.com/v/qdqRu2BDbKc?fs=1&hl=en_US"
         type="application/x-shockwave-flash" allowscriptaccess="always"
         allowfullscreen="true" height="385" width="640"></object>
Click here to learn how to replace image URLs in HTML descriptions.

Sometimes, when a company is moving over to Sellercloud from another system, they have to change the hosting of all the images so that when they cancel their subscription the images aren’t lost. We developed a small application for this purpose and it can take all the HTML descriptions and download the related images and replace the URLs in the HTML.

  1.  Install the Interop file depending on your version of Microsoft Excel
  2.  Export the current descriptions and paste them into the Excel file named HTMLBlocks.xls
  3. Place the original HTML descriptions into the column named HTML
  4. Open the configuration file named ImageDownloader.exe.config and set values for FolderPath, for where the images will be saved and NewBaseURL for the new url that will appear in the descriptions.
  5. Upload the images to a place corresponding to the base URLs and upload the HTMLNew column to revise the descriptions in SellerCloud using Bulk Update Products.

Attachments:

ImageDownloader-source.zip

ImageDownloader-executables.zip


Understanding kit templates

Kits use a different type of Description Template. Kit templates have three HTML editors:

  • The top HTML editor is used to hold the main HTML information and it has placeholders that refer to the bottom editors (#?BundledItemsDetail?# or #?BundledItemsDetailNotMainItem?#). You can set these placeholders where you want to have that component information appear. All formatting and branding is configured in the top template.
  • The middle HTML editor is used to style the kit component squares/image gallery. It is referenced in the top editor by the tag #?KitIncludesGallery?#See an example of the editor in HTML.
  • The bottom HTML editor is called the Kit Item Template. In this template, you enter placeholders that refer to individual products, like #?TopTitle?# and #?LongDescription?#. The placeholders entered here must be referenced in the top editor by the placeholder #?BundledItemsDetail?# or #?BundledItemsDetailNotMainItem?#.

Was this article helpful?

Related Articles