# Template

## Product card

This is a place where you can set values for your products, create an [AI-generated product description](#ai-description) based on selected attributes, use the [AI translation](#ai-translation) feature, and establish [two-way product relations](#product-relation-attribute).

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2FrmHJhMBpCQfIq2pgTPz5%2Fimage.png?alt=media&#x26;token=6ce6a0b3-7cf5-48af-9647-a7ab81aa56df" alt=""><figcaption></figcaption></figure>

At the top left corner, there is an \[1] Edit language drop-down menu; use it to switch between languages for filling in attribute values.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2FGpe4VyiI15f5CLfBnv93%2Fimage.png?alt=media&#x26;token=1dede41d-b597-4ed7-b74d-a4620838d43d" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Information on how to add a new language to the list can be found [here](https://usermanual.ergonode.com/system/settings/languages).
{% endhint %}

At the left top corner, you can find \[2] Edit template button, \[3] the Completion index, and \[4] the Missing translation indicator, and \[5] the workflow status switch.

\[2] Edit template button - takes you directly to the template editor feature.

\[3] The Completion index - shows how many of the [attributes ](https://usermanual.ergonode.com/product-design/attributes)in that [template ](https://usermanual.ergonode.com/product-design/product-templates)are marked as [required ](https://usermanual.ergonode.com/product-design/product-templates/main-templates/designer)and are filled with values.

\[4] Missing translation - indicates that there are untranslated attribute values in the product.

\[5] The workflow status switch - allows you to change the [workflow ](https://usermanual.ergonode.com/workflow/information)status of a product if [workflow status changing conditions](https://usermanual.ergonode.com/workflow/information/designer/conditions) are met.

### Product Navigation panel

The navigation sidebar helps navigate long product templates by providing an at‑a‑glance list of sections and headings widgets to quick jumps to each area on the product page.

* [Section](https://usermanual.ergonode.com/product-design/product-templates/sections) names reflect the template structure defined in Product design → Product templates → Sections, so the sidebar mirrors the same internal organization used during template design.
* [Completeness](https://usermanual.ergonode.com/product-design/product-templates/completeness-sets) indicators in the sidebar reflect required attributes and assigned completeness sets, allowing a quick read on enrichment progress per section.
* **Jump to any section**: click a section name in the sidebar to scroll instantly to that block on the product page.
* **Show headings**: Toggle to display headings under their parent sections in the sidebar; when turned off, the list shows sections only for a compact outline.
* **Search**: Use the sidebar search field to filter entries by section name or by heading widget name; results narrow instantly while typing.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2FCsPliIvwILyBp7Hrz3EQ%2Fnew_page_navigation.gif?alt=media&#x26;token=72d7aa38-1b59-4e13-834c-1375771b9729" alt=""><figcaption></figcaption></figure>

### AI Description

{% hint style="success" %}
The quality and availability of AI description depend on external technology providers (OpenAI), who have limited support for certain languages - this is why some languages may not be available for description.
{% endhint %}

The “Generate content” option for the text and textarea attributes enables users to create AI-powered product descriptions quickly. Users can either enter a custom prompt using variables that reference product attributes.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2FEAAkrlPdLzYJVpj2jAy7%2Fimage.png?alt=media&#x26;token=f2712cb1-f66a-4d10-8ba3-7f0751fcbdd8" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
More information about writing an effective prompt can be found there[how-to-write-effective-prompts](https://usermanual.ergonode.com/tutorials-and-video-clips/how-to-write-effective-prompts "mention")
{% endhint %}

Or select specific attributes to guide the content generation. This feature streamlines the process of writing product descriptions by automatically generating relevant and well-structured text tailored to the product’s details, saving time and ensuring consistency across listings.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2F2Cmm0UJs3RMkPej7j4ZK%2Fimage.png?alt=media&#x26;token=37bc3bc2-697a-407c-8ef3-ae0dd518b7a0" alt=""><figcaption><p>Product Card - Generate Content Menu</p></figcaption></figure>

To use it, click on the three dots (kebab) menu in the textarea type attribute and choose Auto-generated content.

This will allow you to select attributes on which to base your description. The more attributes you select, the better the description will be. Click on Generate Content to proceed or "x" to abort.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2Fen4TYcYwvV4zXxVXoIXL%2Fimage.png?alt=media&#x26;token=a88d791d-ad1b-4d2c-ad1b-e857c4cd37a7" alt=""><figcaption><p>Product Card - Selecting the Attributes fo AI</p></figcaption></figure>

Wait for a moment, and when done, the content will be automatically pasted into the attribute value.

### AI Translation

{% hint style="warning" %}
Keep in mind that AI-generated content may contain errors. Review all entries carefully before saving.
{% endhint %}

{% hint style="success" %}
The quality and availability of AI translation depend on external technology providers (OpenAI), who have limited support for certain languages - this is why some languages may not be available for translation.
{% endhint %}

This feature allows for automatic content translation and can be used for any text or textarea-type attribute.&#x20;

To start translating, click on the three dots (kebab) menu for your chosen attribute, select Translate from, and then choose the source language for this translation.

{% hint style="info" %}
For this to work, there must be something to translate from. For example, if you wish to translate English product descriptions to Polish, an English version must already be created and saved.
{% endhint %}

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2FqzfreLRa2Mh4fsa0BC7C%2Fimage.png?alt=media&#x26;token=53a4d698-ff8e-48e1-85bc-1bac5f0c446b" alt=""><figcaption><p>Product Card - AI Translate Menu</p></figcaption></figure>

Now wait a moment, and the translated value will be automatically inserted into the attribute.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2FTw2a2jAhmsdVfbW66vpz%2Fimage.png?alt=media&#x26;token=a06114a8-d597-4fc1-a70b-cb401b092f56" alt=""><figcaption><p>Product Card - Translated Description</p></figcaption></figure>

Remember to save your changes when you are done.

### AI Complete

{% hint style="warning" %}
Keep in mind that AI-generated content may contain errors. Review all entries carefully before saving.
{% endhint %}

AI Complete empowers all users to auto-populate empty product attributes in two flexible ways: by selecting existing attributes or by uploading a PDF specification. This streamlined workflow saves time and ensures consistent, high-quality content across your catalog.

#### Accessing AI Complete

* Go to Products → Catalog and open your product.
* Switch to the Template tab.
* Click the AI Complete button in the top-right corner.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2FPfwsQEU1ksjQXY1reX8B%2Fimage.png?alt=media&#x26;token=4c215e53-9956-4427-968f-72e97c8b5c53" alt=""><figcaption></figcaption></figure>

#### Mode 1: Complete with Attributes

{% embed url="<https://www.youtube.com/watch?v=Nxg2iQJhXI8>" %}

{% hint style="info" %}
All attributes types are supported except files and product relations. For galleries, only the first image will be included.
{% endhint %}

**Use case**: Quickly generate values using your existing product data.

**Steps**:

* From the AI Complete menu, choose Complete with attributes.

1/2 Select attributes to complete

* In the right-hand panel, **check each empty attribute you want AI to fill** (e.g., Product title, Meta description, Detailed description, Short description, SEO tags, Product relations).
* Click **Next step**.

2/2 Choose data to identify the product

* **Pick one or more** identifying attributes (for example, Main image, Product type, Brand, Short description).
* Click **Complete product**.

AI will analyze the selected inputs and populate the chosen fields. A green notification “Auto-generation of content completed” confirms success. Click Save changes to apply.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2FHl8ND0M3KT3bPd2oozP5%2Fimage.png?alt=media&#x26;token=213df398-2fac-4040-8f44-6232d9a77ffe" alt=""><figcaption></figcaption></figure>

#### Mode 2: Complete with PDF File

{% embed url="<https://www.youtube.com/watch?v=3kZNsVI_m2c>" %}

**Use case**: Generate rich, detailed content when you have a product specification PDF.

**Steps:**

* From the AI Complete menu, choose Complete with PDF file.

1/2 Select attributes to complete

* Check the boxes for **each empty attribute** you’d like AI to fill.
* Click **Next step.**

2/2 Upload PDF file

* **Drag and drop or browse** to select your PDF (up to 100 pages or 20 MB).
* Wait for the upload progress bar to reach 100%.
* Click **Complete product.**

AI extracts relevant data from your PDF - such as specifications, measurements, and marketing copy—and populates the selected attributes. Look for the completion confirmation, then **Save changes** to finalize.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2FzrZJOnBiRtRKNnn4EYRz%2Fimage.png?alt=media&#x26;token=7a1bb160-9f02-4c2b-bb5b-8c73fd61d71e" alt=""><figcaption></figcaption></figure>

#### Best Practices

* **Attribute selection:** The more contextual attributes you include, the more accurate the output.
* **Identifying:** Choose at least one clear identifier (e.g., image, title) to guide the AI.
* **PDF quality:** For PDF mode, ensure your document has clear headings, tables, and specifications.
* **Retry generation:** If results aren’t satisfactory, adjust your attribute choices or upload a refined PDF and try again.

### Attribute variables in the product template

{% hint style="info" %}
Attribute variables can only be used with specific attribute types; you can read more about this [here](https://usermanual.ergonode.com/product-design/attributes/attribute-variables).
{% endhint %}

To use the variables, click on a supported attribute in the product template and type the hash character (#). A list of available variables will be displayed.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2FQms1daC8ynA9yg7BslH3%2Fimage.png?alt=media&#x26;token=b7c3b5a5-250f-4b8b-9973-ea5ac41b8c16" alt=""><figcaption></figcaption></figure>

You can use more than one variable.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2FHbNXJlk5Q91TuR5NTwCm%2Fimage.png?alt=media&#x26;token=f5b74ca0-ac65-4ade-827b-18b6d8aea428" alt=""><figcaption></figcaption></figure>

When a variable is used, a new eye icon will appear. If clicked, a preview will be shown.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2Fv3OfcoUDBaErqfg627qe%2Fimage.png?alt=media&#x26;token=8202cff5-6b09-470e-a7da-10f464c10a59" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Variables are language-independent, meaning that the same variable can have different values depending on the selected language (if a local-type attribute is used).
{% endhint %}

### Gallery attribute

There are four items in the gallery-type attribute:

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2F2LlDMQq1tqvCVUW3FVb0%2Fimage.png?alt=media&#x26;token=c4f3136d-a3de-4cfd-b623-18fa78024a44" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Clicking on an image will open it in full-screen mode.
{% endhint %}

\[1] Information on how many images are in the gallery.

\[2] Name of the file.

\[3] Context menu.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2F5K7jgx3XPwYcgCTive0f%2Fimage.png?alt=media&#x26;token=a0a4b828-1d58-48d1-a83b-b5317a552adb" alt=""><figcaption></figcaption></figure>

| Option              | Function                                                |
| ------------------- | ------------------------------------------------------- |
| Add image           | Add new image to the gallery                            |
| Manages items       | Change order of images in the gallery                   |
| Download this image | Download this image                                     |
| File information    | Opens new windows with file details                     |
| Go to image         | Open displayed image in Resources > Media               |
| Detach image        | Remove an image from the gallery (not from Resources)   |
| Detach all          | Remove all images from the gallery (not from Resources) |

\[4] Arrows to display previous/next images.

### Product relation attribute

You can choose to create a two-way relationship with a product instead of a traditional one-way relationship. To do so, click on the ***+ Add Relations*** button.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2FXA3dK2i2llaZrWmB9SkK%2Fimage.png?alt=media&#x26;token=d5c26879-0321-4576-9490-dee1ae8468e2" alt=""><figcaption></figcaption></figure>

Then, toggle the ***Create a Two-Way Relation*** switch to add the currently edited product as a relation to a selected product.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2F6Va2oyfZ2hxyNI0ikENy%2Fimage.png?alt=media&#x26;token=9d35b813-f44a-4f41-8905-17ca81575ab2" alt=""><figcaption></figcaption></figure>

### Textarea with RTE-enabled attribute

RTE-enabled textarea-type attributes allow you to enter rich text content with various formatting options. You can use the RTE editor to create and edit your content in the Product Catalog. You may also use variables.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2FXCjcNwia9TcbKxVFpYUV%2Fimage.png?alt=media&#x26;token=6f878294-67f1-4ff5-b5e7-2ca04f96ccf9" alt=""><figcaption></figcaption></figure>

#### To use the RTE editor, follow these steps:

1. Click on the plus icon that appears in the upper left corner of the attribute field when you click on it in the Product Catalog. This will open the RTE editor.
2. Choose an option from the toolbar to insert a block of content. You have eight options: Text, Heading, List, Image, Video, Delimiter, Table, and Quote. Each option has different functions and appearances:
   * **Text**: Inserts a text block where you can type plain text. You can also use keyboard shortcuts like Ctrl+B for bold, Ctrl+I for italics, Ctrl+U for underlining, or Ctrl+K to create links.
   * **Heading**: Inserts a heading block where you can type a title or subtitle. You can choose heading sizes from H1 to H6 by clicking on the ***Click to Tune*** icon (six dots) next to the block.H1 is the largest and H6 is the smallest.
   * **List**: Inserts a list block for typing item lists; by default, it’s ordered but can be changed to unordered by clicking on ***Click to Tune***.
   * **Image**: This option inserts an image block where you can display an image from the internet. You need to enter the image URL in the window that appears. The image URL must be an absolute link, which means it starts with **http\://** or **https\://** and includes the full path to the image file. For example, **<https://example.com/images/image.jpg>** is an absolute link, but **/images/image.jpg** is not.
   * **Video**: This option inserts a video block where you can embed a video from YouTube or Vimeo. You need to enter the video link in the “Source” field in the window that appears. The video link must be a valid link from YouTube or Vimeo, such as **<https://www.youtube.com/watch?v=example>** or **<https://vimeo.com/example>**. You can also enter the width and height of the video in pixels in the “Width” and “Height” fields, and toggle the “Constrain proportions” switch to keep the aspect ratio of the video. Click on the “Add video” button to insert the video, or the “Cancel” button to close the window. You can also resize the video by clicking on the “Click to tune” icon next to the block.
   * **Delimiter**: Inserts a thin horizontal line separating different sections of content.
   * **Table**: Inserts a table block for displaying data in rows and columns; you can edit it by clicking on options next to each row or column.
   * **Quote**: Inserts a quote block for typing quotations or citations; alignment options are available via ***Click to Tune***.
3. To add more blocks of content, click on the ***plus icon*** that appears between blocks. You can also reorder blocks by dragging and dropping them using the ***handle*** (six dots) on each block's left side.
4. To expand the attribute field, click on the ***double-arrow*** icon on the right side of the toolbar; this will make it fill the whole screen. Click again to return it to its original size.
5. To save your content, click on ***Save Changes*** on the right side of the screen. To discard changes, simply navigate elsewhere in the system or refresh the page.

{% hint style="info" %}
RTE editor does not support all HTML tags.
{% endhint %}

You can use RTE-enabled textarea-type attributes to create rich and engaging content for your products and edit it at any time by returning to the [Product Catalog](https://usermanual.ergonode.com/products/catalog) and clicking on the attribute field.

{% hint style="success" %}
Read our blog article on How to Create a Product Family Template [HERE](https://www.ergonode.com/blog/creating-product-family-template-guide).
{% endhint %}
