Skip to navigation

Working with your data

How Etals stores your products and content, how data gets in and out, and where to find it.
View as Markdown

Etals writes better when it knows your items. A product description written from the material, the colour and a supplier note is far better than one written from a name alone. This page explains how Etals organises that data, so the rest of the docs make sense.

etals-video-poster:working-with-your-data

Four words to know

WordWhat it meansNordvik example
Content typeA kind of thing you keep in Etals. Each one gets its own page under My Data.Products, Categories, Pages, or your own type such as Store guides
ItemOne thing of that content type, such as one product.The Fjord Shell Jacket, identifier NV-1001
PropertyA field that every item of that content type has.Colour, Material, Description, Meta title
ValueWhat one item has in one property.Colour of NV-1001 is Deep teal

Read more in Content types and Properties.

One property, many versions

Some values are the same everywhere. A jacket’s colour does not change between Sweden and Germany. Other values change by place or language. Nordvik wants one Description in Swedish, one in Norwegian, one in German, and so on.

A property’s Varies by setting handles this. Description at Nordvik varies by language, so every product has one Description per language. Meta title varies by website, so every product has one Meta title for nordvikoutdoor.se, one for nordvikoutdoor.de, and so on. Each of those versions is called a localization.

You pick Varies by when you create the property. See Properties.

Two switches that matter most

Every property has two settings that decide how Etals treats it. You find both on the Properties & prompts tab.

SettingWhat it controlsWhen to turn it off
Etals can generateWhether Etals may write this property. When it’s on, the property shows in tasks, as a My Data column and in Setup > Prompts.Data that your own system owns and Etals must never change, such as Price SEK
Agents can seeWhether agents read this property when they write something else.Data that would only distract an agent, such as an internal stock code

They are independent. Nordvik switches Etals can generate off for Supplier Notes (Etals should never rewrite them) but leaves Agents can see on (they are great raw material for a Description). What agents see explains the second switch in detail.

How data gets in

Way inGood forPage
Setup wizardYour first file or feed, when you set up a content type in Setup > OnboardingImport
Import/Export appSpreadsheets you upload now and then, with an AI chat that maps the columns and shows a previewImport
FeedsA product feed URL that Etals reads on a schedule (needs the Feeds app)Import
Funnel APIYour own system pushing items to Etals whenever they changeData sync via Funnel API
IntegrationsA connected platform such as a CMS or PIMHow integrations work

How data gets out

Way outGood forPage
File exportA CSV or Excel file of any content type, with the columns you chooseExport
Export to a connected platformSending finished content straight to your shop, CMS or PIMExport
API exportEtals posting finished content to an endpoint you controlAPI export

A tour of My Data

Open My Data in the sidebar and pick a content type. Your content types share one list there. Favorites show at the top, and content types from a connected platform are grouped under that platform.

My Data > Products sorted by identifier: the tabs, the view tabs, the toolbar icons and the list of products NV-1001 to NV-1012, with New task at the top right and "16 products" in the footer

The tabs

TabWhat you find there
Products (the content type’s name)The table of items
GroupsSaved slices of the items, for example “Footwear”. Properties can be limited to a group.
InsightsNumbers and findings about these items. Only shown when Insights is active in your workspace (Activate insights in Setup > Onboarding) and you have access to it.
Properties & promptsEvery property, its settings and its prompt. See Properties.
AutomationsRules that run tasks on these items by themselves

When Insights is active, key figures show above the table, for products Search clicks, Search visibility, Written in Etals and Average position. Click one to open it in Insights. They need the same access as the Insights tab.

Views, search and filters

The view tabs above the table start with All, which shows every item. Change the search, filters, sort or columns, then save the result as a view with Save view. Save only for me keeps it private; Save for everyone shares it, if your role allows it. The + next to the tabs creates a new view.

The toolbar icons, from left to right:

  • Search narrows the table as you type.
  • Export this view downloads the items as they are filtered right now. See Export.
  • Filter adds rules such as “Colour is Navy”. The rules show in a strip above the table.
  • Sort changes the order. By default, items sort by last updated.
  • Table settings picks which columns show. Every localization of a property is its own column, for example Description in Swedish and Description in German.

Tick items to get a bar with Task, Group and Export. The footer shows how many items there are, for example “16 products”, or “5 of 16 products” when a search or filter narrows the table.

Click a value in the table to change just that value. A small window shows the property and its localization, with Cancel and Save, and Open record for the whole item. In categories and pages, a click always opens the whole item.

The item editor

Click an item’s name to open it. You see its image and identifier on the left, and tabs for Properties, Images and Changelog (plus Variants if the content type has variants).

Edit a value and Etals saves it on its own. The header shows “Saving…” and then “All changes saved”.

The Completeness panel on the right shows how much of the item is filled in, counted over the properties that apply to it. Next up lists what is still missing.

The item editor for Fjord Shell Jacket (NV-1001) on the Properties tab, with the Completeness panel at 81%, the Next up list and "All changes saved" in the header