Field Settings

In order to properly index your data feed, we need to know how your data is configured. The settings on this page determine how each data field is used across your storefront.

Note: Adjusting field settings can impact where your data appears publicly across your storefront. Ensure you understand the implications before making changes. Click here for more information.

Editing mode

This toggle defaults to the "Disabled" setting and prevents you from making changes accidentally while viewing this page. If you click the toggle to enable editing, a message will appear at the bottom of the page: "Editing is currently enabled. All changes will be saved automatically. [Disable Editing]". This message will display while you have editing enabled. Click the "Disable Editing" button within the message to turn off the edit function, or click the toggle at the top left of the page to disable the edit function.

Search for a field

Use the search field at the top left of the page to search for a particular field. The system will automatically find matching fields as you type.

Fields

The table on this page displays all fields configured for your store. Each column in the table is sortable in either ascending or descending order. Simply click the arrows at the right of each column header to sort by that header.

Use the pagination at the bottom to see the next or previous page; use the "Rows per page" drop-down to select how many rows of fields are displayed on a page.

Field

The Field column displays the name of the field that Athos Commerce gets from the data feed. In addition to showing fields from the data feed, custom fields created through Product Filters are listed here as well. It is a good idea to name custom fields uniquely so they stand out from what is in the data feed. If you have added a new field to your data but it's not showing, please read this article on How to Add a New Field.

Label

The label is the public-facing name for this field. This is how this field will appear to shoppers in your store. If it appears as a filter, in a product listing, or on a product detail page, this is the name it will display. Be sure this name is easy to read and understandable.

Type

Setting a type determines how data will be interpreted.

• Ignore = The value is ignored.
• Text = The value is treated as text.
• Text (Strip HTML) = The searchable data has the HTML removed so that customers searching for things like "span" won't find irrelevant products.

Note: This does not strip HTML from displaying on the front-end of your site when this field is used. 

• Code (SKU, MPN, etc.) = Values will be partially searched.
• Whole Number = The value is treated as a whole number (2, 4, 6, 8, etc.).
• Decimal Number = The value is treated as an integer that includes decimals (2.25, 4.50, 6.75, 8.25, etc.).

Delimiter

If your field can have multiple values in it, configure how those values are separated by choosing a delimiter in this column. 

Example: Your "Color" data could be formatted as:

     Blue, Black, Red, Yellow

If "Color" was selected as a filter and did not have a comma (,) set as the delimiter, "Blue, Black, Red, Yellow" would display as a filter option rather than the separate options "Blue", "Black", "Red", and "Yellow".

Display

The Display checkbox determines whether or not the field is available for use in item templates. Fields that are set as Core Fields do not need to be marked for display in Field Settings, as they are already available.

Sort

The Sort checkbox determines whether or not the field can be selected as a sort option on the Sorting page (Search Optimizations > Display Settings > Sorting).

Filter

The Filter checkbox determines whether or not the field can be selected as a filter option on the Filtering page (Search Optimizations > Display Settings > Filtering). For more information on filters and their settings in Athos, please read our article on Filtering.

Search

Checking the Search box enables a field to be searched. This setting is important to review as checked fields are included in our search index. It is recommended to have things like "Name", "SKU", "Category" or "Brand" marked as search. Other fields that contain a lot of information, such as "Description", may be unhelpful as they generally have a lot of content and may skew the user's search results.

Recs Display

Fields marked as "Display in Recs" will be returned in the API response for Athos' next generation Personalized Recommendations (coming soon).

Recs Filter

To use a filter in recommendations, check this box to enable the function.  To use a filter in recs, it has to be enabled here. Otherwise, we won't load the data from that field into our service and would be unable to filter on it.