Table of Contents

Rich Content

Rich Content enables you to combine multiple data types—texts, pictures, documents, features, and keywords—into structured, reusable content blocks that can be published across different e-commerce channels and publication formats. Using templates with dynamic placeholders, you can automatically populate content with data from your master records, creating compelling product descriptions and marketing materials.

Key Features

  • Template-based content: Define reusable layouts with dynamic field placeholders
  • Multi-channel publishing: Publish content to different channels (e-commerce platforms, PDF, API)
  • HTML preview: Visually preview content before publishing
  • Content validation: Use checklists to ensure content quality and consistency
  • Content headers: Organize content by channel and publication requirements

To create product content

  1. In the search box ( Alt+Q), enter PIM Items, then select the related link.
  2. Select the item or category you want to add content to.
  3. On the item details page, under Product Data, select Content.
  4. On the Product Content page, you must first create or select a content header. In the header section, select the New dropdown, then select New Header.
  5. Once the header is created, on the Product Content page, select the New action to add content lines.
  6. Fill in the following fields for each content line:
    • Type: Select the type of content you want to add (Text, Picture, Document, Feature, Keyword, Content Group, etc.)
    • Number: Select or enter the specific item number for that type
    • Level: The hierarchy level (0 for top-level, higher numbers for nested content)
    • Description: Optional description of this content line
    • Pimics Template: Select the template that defines how this specific content should be displayed
  7. To reorder content lines, select a line and use the arrow buttons to change the display sequence.
  8. Repeat steps 8-10 for each content element you want to add under this header.
  9. Select Save to store your product content definition.

To set up content templates with placeholders

Content templates define the HTML structure and layout of your content. They use placeholder functions to dynamically insert data from your master records and related entities.

Placeholder Functions

The following functions are available in content templates:

Function Parameters Purpose Example
AllLines None Renders all sub-lines within a content group {% AllLines %}
GetLine Line number (integer) Renders a specific sub-line by its sequence {% GetLine(1) %}
GetFieldValue Field name or number (text) Retrieves a field value from the master record {% GetFieldValue(Description) %}
CatalogFieldValue Field name or number (text) Retrieves a field value from catalog/related data {% CatalogFieldValue(Description) %}

To create a basic content template

  1. In the search box ( Alt+Q), enter PIMX Templates, then select the related link.

  2. Select New to create a template.

  3. Fill in the basic information:

    • Code: Enter a unique template code (e.g., 50_50_LAYOUT)
    • Description: Describe the purpose of this template
    • HTML Content: Enter or paste your HTML template code

  4. In the HTML Content field, structure your layout using standard HTML and insert placeholders:

     <div class="row">
     <div class="col-50">
         {% GetLine(1) %}
     </div>
     <div class="col-50">
         {% GetLine(2) %}
     </div>
 </div>

  5. For dynamic content from master data, use field placeholders:

    <h1>{{ GetFieldValue(Description) }}</h1>
<p>Product ID: {{ GetFieldValue(No.) }}</p>
<div class="features">
  {% AllLines %}
</div>

  6. Select Save.

    Important: Verify that field names in GetFieldValue() exactly match the field names in your master record. Incorrect field names will cause preview errors.

To preview content

  1. In the search box ( Alt+Q), enter PIM Items, then select the related link.

  2. Select the item or category containing the content you want to preview.

  3. In the right panel, select Content.

  4. Select Preview to see how your content will render.

  5. The preview displays the HTML output using the selected template layout and dynamic field values.

  6. If errors appear in the preview:

    • Check that all placeholder functions are spelled correctly
    • Verify that field names exist in the master record
    • Ensure nested content groups have appropriate templates assigned
    • Review the template's HTML syntax

  7. To refresh the preview after making changes, select the Refresh Preview action (or press Alt+R).

To organize content with headers

Content headers allow you to group content by publication channel and control which content is included in different publication outputs. Headers are created as part of the product content workflow and can also be managed separately.

To create multiple content headers for an item

If you need to create additional headers or manage headers separately:

  1. In the search box ( Alt+Q), enter PIM Items, then select the related link.

  2. Select the item or category where you need additional content headers.

  3. In the right panel, select Content.

  4. On the Product Content page, select Edit Headers to manage all headers for this item.

  5. Select the New dropdown and select New Header for each additional header you want to create.

  6. Fill in the header information:

    • Header Code: A unique identifier for this content group
    • Header Description: Description of the content header
    • Header Channel: The publication channel this header targets (e.g., AMAZON, EBAY, PDF, API)
    • Header Template: Optional - select a template for the overall structure

  7. Select Save.

To assign content to a header

Once headers are created, content lines are automatically assigned to the selected header:

  1. In the search box ( Alt+Q), enter PIM Items, then select the related link.

  2. Select the item or category containing the content you want to organize.

  3. In the right panel, select Content.

  4. Ensure the correct header is selected (you can see the active header at the top of the page).

  5. All content lines you add will be associated with this header.

  6. To switch to a different header and add content under it, select a different Header Code from the header section.

To validate content with checklists

Checklists help ensure that your content meets quality standards and follows defined rules before publication.

To create a content validation checklist

  1. In the search box ( Alt+Q), enter Checklists, then select the related link.

  2. Select New to create a checklist.

  3. Add Checklist Relations for content validation:

    • Relation Type: Select Content Line
    • Field: Select the field to validate (e.g., Type, Pimics Template)
    • Condition: Define the rule (e.g., "Type must be in (Text, Picture)" or "Pimics Template cannot be empty")

  4. Example validation rules:

    • Ensure all Picture type lines use only IMAGE or IMAGE_CENTER templates
    • Require that Text content groups use specific templates
    • Verify that Content Group types have valid Pimics Template assignments

  5. Select Save.

To certify content using a checklist

  1. In the search box ( Alt+Q), enter PIM Items, then select the related link.

  2. Select the item or category that has content defined.

  3. In the right panel, select Content.

  4. Select Certify to run the validation against the assigned checklist.

  5. The system checks all content lines against the defined rules.

  6. If validation fails:

    • Review the error messages indicating which rules were not met
    • Correct the content according to the rules
    • Run Certify again

To publish content to different channels

Rich Content integrates with the Publication system to distribute content across multiple channels.

To include content in publications

  1. In the search box ( Alt+Q), enter Publication Groups, then select the related link.

  2. Select the Publication Group where you want to include content.

  3. Configure the following settings:

    • Include Content As: Select HTML to generate HTML output, Data Lines for individual line items, or empty to exclude content

  4. Select Save.

  5. When publishing an item:

    • The system generates HTML from the content template
    • Content is exported to the target channel according to the Publication Interface rules
    • For e-commerce platforms (Sana Commerce, Shopify), HTML is wrapped in the appropriate format
    • For API and Print, HTML is saved directly

Tips and best practices

  • Reuse templates: Create generic templates for common layouts and reuse them across multiple content types
  • Test placeholders: Always preview content after modifying templates to catch field name errors early
  • Use content headers: Organize content by channel to avoid publishing irrelevant data
  • Version control: Keep templates organized by type and version to manage updates efficiently
  • Performance: For large content blocks, test preview generation to ensure acceptable performance
  • Migration: When upgrading from older content formats, use the Content Header feature to organize existing content by publication channel