Skip to navigation

Properties

The fields every item has, how they vary by language or website, and which ones Etals may write.
View as Markdown

A property is a field that every item of a content type has. Nordvik’s products have Category, Colour, Material, Gender, Price SEK, Supplier Notes, Description, Meta title and Meta description. Agents write into properties and read from them, so they are worth getting right.

etals-video-poster:properties

The Properties & prompts tab

Open a content type in My Data and click Properties & prompts. Each row is one property.

ColumnWhat it shows
PropertyThe property’s name. Click it to open the property page.
TypeWhat kind of value it holds, such as Text or Single choice.
Varies byThe level the value differs at, such as “Varies by language”. Empty means one value everywhere.
Applies toAll products, or the groups the property is limited to. Click to change it.
Etals can generateA check box. On: Etals may write the property, and it shows in tasks, My Data columns and prompts. Off: it stays in your data, out of the way.
Agents can seeA check box: whether agents read it while writing other properties. See What agents see.
PromptThe start of the property’s prompt, or Write prompt if there is none yet. Click to open the prompt editor.
SourceEtals, or the connected platform the property comes from.
CreatedWhen the property was added.

The footer sums up the Etals can generate column, for example “Etals can generate 3 · 6 off-limits”.

The Properties & prompts tab for Products with every property, its Varies by level, the Etals can generate and Agents can see check boxes, and the footer summary

Create a property

Click New property at the top right of the Properties & prompts tab.

SettingWhat it does
TypeThe button left of the name. Opens the type picker.
Property nameAt least 3 characters. Agents see this name, so make it clear.
Points toOnly for Linked item and Linked items: which content types the link can point to.
Varies byThe level the value differs at. See Varies by.
PromptOptional: tone, length, what to include and what to avoid. Open full editor adds sections and conditions. Only shown if you can manage prompts.

A line at the bottom sums up your choices. Click Create. The window closes and the new property shows up in the table.

New properties start with Etals can generate on and set to Internal only (see The property page).

The New property form: Single choice, name "Fit", Brand, Market and Language ticked under Varies by, a short prompt and the summary line

You can’t change a property’s type or its Varies by after you create it. If you picked the wrong one, delete the property and create it again.

Property types

The picker groups types under Text, Numbers & dates, Computed, Choices, Images & video and Links.

TypeDescription
TextShort plain text, such as a title, a name or a meta description.
Formatted text (HTML)Text with headings, bold and links, saved as HTML.
Document (PDF)A PDF file attached to the item.
Structured data (JSON)Data in JSON format, for example specifications or settings.
Whole numberA number without decimals, such as a stock count.
Decimal numberA number with decimals, such as a price or a weight.
DateA calendar date, such as a launch date.
Yes / NoA switch that is either on or off.
FormulaEtals fills the value in for you from other properties, the website and variables. For example the full page URL of each article.
Single choiceOne value picked from a list you define.
Multiple choiceSeveral values picked from a list you define.
Category treeValues picked from a tree, such as categories with sub categories.
TagsFree labels that can be added and reused.
Image or videoOne image or one video.
Images and videosA gallery of several images and videos.
Linked itemPoints to one item of another content type.
Linked itemsPoints to several items of another content type.

Formula only works once computed properties are turned on for your workspace.

Varies by

Tick the level the value differs at. The broader levels are ticked with it, because a website has its own language, a language belongs to a market and a market belongs to a brand.

LevelNordvik exampleWhat you get
Nothing tickedColourOne value everywhere
BrandBrand storyOne per brand
MarketPrice noteOne per market, such as Sweden and Germany
LanguageDescriptionOne per language, such as Swedish and German
WebsiteMeta titleOne per web shop, such as nordvikoutdoor.se

Each version is called a localization and gets its own column in My Data.

Click More specific to also vary a value by Country or Currency, on top of the level you ticked. Formula properties can vary by country but not by currency.

The property page

Click a property’s name to open its page. The top sums up Type, Varies by, Etals updates and Prompt. Click the name to rename it.

SectionWhat it does
Active / Inactive switchThe same setting as Etals can generate on the Properties & prompts tab.
Exportable / Internal only switchWhether the property’s values are sent when Etals exports to a connected platform. Only shown for properties created in Etals.
Instructions for agentsThe property’s prompt, which every agent reads when it writes the property.
ItemsOne row per localization, with chips for its brand, market, language, website, country or currency. Localizations hidden in your workspace settings show a Hidden badge.
Delete propertyRemoves the property, its column and its prompt, for good. Only for properties created in Etals and not used in a group’s conditions.

Options for choice properties

For choice types, the Items section lists each localization’s options. You can search them, filter to With prompts and add new ones.

Click an option to edit it:

FieldWhat it does
Option NameThe name people see.
Custom AI Name”Name shown to AI instead”. Useful when the name is a code, such as “NVY” for Navy.
Parent OptionCategory trees only: where the option sits in the tree.
Prompt”Describe how AI should behave when this option is selected”, for example “Gore-Tex: mention that the jacket is waterproof and breathable.”

The eye icon hides or shows an option.

Some properties have extra sections on their page:

  • Option rendering template and Reference rendering template: how each option or linked item is written out in prompts.
  • Image and video properties: the image model and style used to generate images.
  • With the Crawlera app: instructions for filling the property from crawled pages.
  • Some linked properties from connected platforms: whether tasks also write fields on the linked item.

Prompts for a property

Open a property’s prompt from the Prompt column, the property page or Setup > Prompts > My Data. Its scopes, All, Copywriting and Translations, let one part apply only when the field is written from scratch or only when it’s translated. See My data.