How to use input field

How to modify feed data

Feed fields are composed of key-value pairs, forming the structure of each feed. For custom feeds, there is no limit to the number of fields, and the field key can be any string. However, the number of fields and field keys for pre-configured templates is limited by the product listing they were created for.

To generate field values, the application uses flexible, macro-driven input fields. The input field section is shown in Figure 1, which includes:

Field key select
Macros block: Multiple macros can be included in a field value to achieve the desired result.
Input field
Buttons to insert new macro before or after the target item
Macro sources
Remove input field section button
Checkbox for field conditions: If the conditions are met, the field will be included in the feed.
Input field label: Displays clear, intuitive representations of field values.

The macro sources block consists of the following components:

Mappings section: Includes product and shop-related mappings, such as product price, title, and shop currency.
Metafields section: Contains all product and variant metafields.
Sources section: Provides access to various data sources, including product collections, tags, currency lists, Google categories, and more.
Actions section: Lists available actions to modify a field’s value, such as adding a number or removing whitespace. The available actions depend on the field’s content; for example, mathematical actions are only shown for numerical values, not for text-based fields like captions or titles.

To add a new macro element to an input field, follow these steps:

Click inside the input field or on an existing macro element.
From the popup that appears, choose your desired macro source (e.g., mapping, metafields, source, etc.).
Select the specific macro item.
To insert a macro before or after the target item, click the corresponding button. If you clicked inside the input field in the first step (rather than on a macro item), the new macro will be inserted after the existing macros.

A feed value can be made optional by applying it only when specific conditions are met. To do this, follow the steps outlined in Figure 3:

Check the “Apply condition” checkbox.
Choose the required condition item.
Define the condition.
Set the condition value.
(Optional) Add an OR condition (the condition will match if any sub-condition is met).
(Optional) Add an AND condition (the condition will match only if all sub-conditions are met).

Conditions function as follows: when feed values have conditions, they are tested in sequence, with the first matching feed value being applied. If no conditions are met, the feed value without a condition will be used. If no conditions match and there is no feed value without a condition, the feed value will be excluded. Therefore, required feed values (marked with an asterisk) should always have a default value without conditions.

In the example shown in Figure 4, the feed Title value will resolve to “Product title #2” if the product title is “Big pajama,” or “Product title #3” (the default, non-optional value) if the product title is “Small pajama.”