Documentation
Product Fields
MANAGING PRODUCT FIELDSDocument Revision: v1.1
OVERVIEW
Fields define reusable extra description labels for product pages (for example,
"Warranty Information", "Care Instructions", or "What's in the Box"). Each
field has a title and a rich-text description (one set per store language),
a sort order, and an enabled/disabled status. Fields do not store product
values themselves; per-product text is entered when you edit a product under
Catalog > Products, on the Fields tab.
Once a field is created and enabled, it can be selected on any product form
via autocomplete. Only enabled fields assigned to a product with text entered
for the current storefront language are shown on the product page.
REQUIRED PERMISSION
The signed-in admin user must have modify permission on catalog/field.
ADD/CREATE NEW: STEP-BY-STEP
1. Go to Catalog > Product > Fields.
2. Click the Insert button (top right).
3. On the General tab, for each enabled store language:
a. Enter the Field Title (required, 3 to 64 characters).
Each language has its own input field with a flag icon.
b. Enter the Description (required, more than 3 characters).
Each language uses a rich-text editor (CKEditor) with access to the
file manager for images and media.
4. On the Data tab:
a. Enter a Sort Order (optional integer; defaults to 0 on create). Lower
numbers appear first among fields on the storefront product page.
b. Set Status to Enabled or Disabled (defaults to Enabled on create).
Disabled fields cannot be selected on new product assignments and are
not shown on the storefront even if old product data exists.
5. Save the field using one of these buttons:
- Save Saves the field and returns to the field list.
- Apply Saves the field and opens the edit form for the new record
(useful when you want to continue editing immediately).
- Cancel Discards changes and returns to the list.
EXAMPLE: CREATE A FIELD — "Warranty Information"
Goal: add an extra product-page field for warranty details that staff can
fill in per product.
Field Title (English): Warranty Information
Description (English): Standard warranty terms and coverage period for this product.
Sort Order: 1
Status: Enabled
Steps:
1. Catalog > Product > Fields > Insert
2. General tab — English:
- Field Title: "Warranty Information"
- Description: enter the default or template warranty text in the editor
3. Data tab:
- Sort Order = 1
- Status = Enabled
4. Click Save
Result: the list shows "Warranty Information" with Sort Order 1 and status
Enabled. The field is available on the Fields tab when editing products under
Catalog > Products.
EDIT: STEP-BY-STEP
1. Go to Catalog > Product > Fields.
2. Locate the field in the list (sort by Field Title, Sort Order, or Status
if needed).
3. Click Edit in the Action column for that field.
4. On the General tab, update the Field Title and/or Description for any
language.
5. On the Data tab, change the Sort Order and/or Status.
6. Click Save, Apply, or Cancel as when creating.
EXAMPLE: EDIT THE "Warranty Information" FIELD
Goal: clarify the title, update the template description, and adjust display
order.
1. Catalog > Product > Fields
2. Find "Warranty Information" > Edit
3. General tab — English:
- Field Title: Manufacturer Warranty
- Description: update the rich-text template as needed
4. Data tab:
- Sort Order: 2
- Status: Enabled
5. Click Save
Result: the list shows "Manufacturer Warranty" with Sort Order 2. Products
that already had values for this field keep their stored text; only the
field definition (title, description template, sort order, status) changes.
DELETE: STEP-BY-STEP
1. Go to Catalog > Product > Fields.
2. Check the box(es) next to the field or fields to delete.
(Use the header checkbox to select all fields on the current page.)
3. Click the Delete button.
4. Confirm the dialog when prompted ("Delete/Uninstall cannot be undone!
Are you sure you want to do this?").
5. If deletion succeeds, a success message is shown and the list refreshes.
Important: unlike attributes, field deletion is not blocked when products
still reference the field. This is true in NivoCart V2.0.0, but has been updated
in later versions, and now the Delete action is prevented if one or more
products are using the Field..
EXAMPLE: DELETE A FIELD
Goal: remove a test field "Care Instructions" that is no longer needed.
1. Catalog > Product > Fields
2. Check the box for "Care Instructions"
3. Click Delete > Confirm
Result: the Care Instructions field and its language descriptions are
removed from the database. Any product_field rows that referenced this
field_id may remain until manually cleaned up or overwritten on product save.
ENABLE AND DISABLE FIELDS (BULK)
From the field list, check one or more fields and use:
Enable Sets status = 1 for each selected field (editFieldStatus).
Disable Sets status = 0 for each selected field.
Disabled fields are excluded from storefront display (only status = 1 fields
with product text are shown) and from the cached field list used on product
forms. Bulk enable/disable does not alter field titles, descriptions, or
product-specific values.
USING FIELDS ON PRODUCTS
After a field exists and is enabled:
1. Open Catalog > Products and edit or create a product.
2. Open the Fields tab (visible when at least one field definition exists).
3. Click Add Field and type in the Field column; autocomplete suggests
enabled fields via catalog/field/autocomplete (filter_title).
4. Enter the field value (text) per language for that product.
5. Save the product.
On the storefront product page, enabled fields with text for the current
language appear as "Title: text" lines, ordered by field sort_order then
title.
EXAMPLE: ASSIGN "Warranty Information" TO A PRODUCT
Goal: show warranty details on a specific product page.
1. Ensure "Warranty Information" exists and is Enabled (see create example).
2. Catalog > Products > edit the target product.
3. Fields tab > Add Field.
4. Start typing "Warranty" and select "Warranty Information" from
autocomplete.
5. English text: "2-year limited manufacturer warranty. Register online
within 30 days of purchase."
6. Click Save on the product form.
Result: the product page displays "Warranty Information: 2-year limited
manufacturer warranty..." for English storefront visitors.