Skip to main content
WISEPIM Product attributes page with a Needs attention strip and Label, Group, Type, Filled and Behavior columns WISEPIM Product attributes page with a Needs attention strip and Label, Group, Type, Filled and Behavior columns Attributes are the building blocks of your catalog. Each one is a custom field that holds a specific piece of product data: a color, a weight, a description, an image. Together, they form the data model every product follows. Set them up well and every product stays consistent, searchable, and easy to filter. Where to find it: open Catalog > Product Attributes in the top menu. With the Experimental interface the same page is Catalog > Catalog structure > Product fields.
Attributes are shared across your project. When you create an attribute, it becomes available for assignment to any product family.

The Product attributes page

The page header has two buttons:
  • New attribute: create one attribute by hand.
  • More: a menu in three sections. Bring data in and out holds Import attributes and Export. AI holds Guide catalog structure. Related links to Attribute groups, Product families and Option sets.
The table shows the Label (with the code next to it), Group, Type, Filled and Behavior of every attribute.
  • Filled shows how many products have a value. Click the bar to open the products that are missing it. Attributes that don’t count toward completeness show Not tracked.
  • Behavior only shows exceptions: No import, No export, AI off or Not in enrichment runs. A row without marks is imported, exported and included in enrichment. Click the cell to change the attribute’s properties in place.
Open Density and columns to switch between Compact and Comfortable and to add optional columns: Code, Filled, Families, Created and Sort order. Created shows when the attribute was added and sorts newest or oldest first. Attributes created before this column existed show Unknown. Switch between the Table and Grouped views. The grouped view sorts attributes under their group, and you can drag an attribute to another group.

Needs attention

Above the table, the Needs attention strip counts attributes with a likely problem. Click a chip to filter the table to those attributes.

Row menu

Every row has a pencil icon for quick edit and a More actions menu:
  • Organize: Move to group…, Add to families… and See and merge values.
  • Settings: Cleaning rules, AI enrichment, Validation and Import and export. Each opens the attribute settings on that tab.
  • Reuse: Duplicate and Save as template.
  • Danger zone: Delete. The attribute is also removed from product families and integration mappings. You can undo the delete for 5 seconds.

Attribute Types

WISEPIM supports a range of attribute types to cover different kinds of product data:
Use Select and Multi-select instead of free text whenever the values are predictable. This keeps your data consistent and makes filtering reliable.

Creating an attribute

WISEPIM new attribute modal with label, code, type and required/filterable/searchable options WISEPIM new attribute modal with label, code, type and required/filterable/searchable options The New product attribute form keeps creation fast. It captures only the essentials, so you can add a field and move on. Everything else (validation, cleaning, enrichment) lives in the attribute’s settings.
1

Click New attribute

On the Product attributes page, click New attribute.
2

Fill in the basics

Enter a Label (the name people see) and pick the Type. The Code (the technical identifier) is generated from the label as you type, and you can edit it.
3

Place it in your model

Optionally pick a Group and set a Sort order. These control where the field appears in product forms.
4

Set properties

Choose whether the attribute is Required, Unique, Filterable, Searchable or Visible, and whether AI can fill it. New attributes are visible by default.
5

Add a value source (for select types)

For Select and Multi-select, pick Type options here or Use an option set (see Option sets). For Number and Decimal, you can link a unit set.
6

Save the attribute

Click Create attribute. Tick Create another first if you want the form to stay open for the next one.
For options you type on the attribute itself, two switches decide what happens to values that don’t fit yet:
  • Add new options found during import: an import that brings an unknown value adds it as a new option instead of dropping it.
  • Let AI add new options: when an AI run finds a value that no option fits, it adds it as an option. Off by default, so AI only picks existing options.
Neither switch applies to attributes that use an option set. An option set has its own import rule.
The attribute code can’t be changed after creation. Use a descriptive, lowercase format like screen_size_inches or is_waterproof. Codes also can’t clash with reserved system fields such as sku, price, brand or weight.
Some plans cap the number of custom attributes. The header then shows how many you have used, and at the limit the New attribute button turns into Upgrade for more. Upgrade your plan to add more.

Attribute properties

Properties shape how the field behaves across your catalog:
  • Required: needed before a product counts as complete.
  • Unique: no two products can share a value.
  • Filterable: shows up as a filter in product lists and channel feeds that support it.
  • Searchable: product search looks inside this value.
  • Visible: shown on the product page.
  • AI can fill: AI enrichment may write a value here.
You don’t have to reopen the form to change these. Click the Behavior cell of a row, switch the properties you want, and apply.

Quick edit vs full settings

There are two ways to change an attribute after it exists, and they do different jobs:
  • Quick edit (the pencil icon on a row) reopens the basics: label, type, group, sort order, properties and the value source for select types. The code stays read-only. Quick edit also holds Name in other languages: the attribute’s name per project language. Shop exports use these names as the attribute title per language, for example Lightspeed filters and specifications.
  • Settings (the Settings items in the row menu) opens the deeper, tabbed configuration below.
Changing the type of an existing attribute can leave product values that no longer fit, such as text in a number field. Quick edit asks you to confirm before it saves the new type.

Configure attribute settings

The settings decide how values are imported, cleaned, filled by AI and exported. They open in a tabbed modal: General, Validation, Cleaning, Enrichment and Platforms. Which options appear depends on the attribute type.

General

The Data flow and AI switches decide which operations the attribute takes part in. The Behavior column shows each switch you turn off. New attributes start with all of these on. Quality scoring shows how many products have a value, with a link to the products missing it. Per-attribute weights are set in the data quality settings.

Validation rules

Enforce data quality so bad values never reach your channels:
  • Text length: minimum and maximum character limits, plus a format pattern (email, alphanumeric, phone, or your own regular expression).
  • Number ranges: acceptable min and max values, and decimal places.
  • Date ranges: earliest and latest allowed dates, and a date format.
  • Selections: minimum and maximum number of choices for multi-select, plus per-option rules (length, pattern, uniqueness, and a custom error message).

Data cleaning

Cleaning rules normalize values automatically during import and editing, so your data stays consistent without manual work:
  • Basic: trim whitespace, remove empty values, collapse extra spaces, and replace empty values with a fallback.
  • Text: normalize case, strip special characters, fix encoding, strip HTML, and convert line breaks.
  • Numbers: remove currency symbols, standardize thousand and decimal separators, and round to a set precision.
  • Options: deduplicate, sort, and map similar values together so “Colour” and “Color” become one.

Enrichment

For text fields, tune how AI fills the attribute:
  • Suggest values: AI proposes values for this attribute when you enrich products.
  • Minimum words and Maximum words: word limits for generated text.
  • Enrichment instructions: tell the AI exactly what this field should contain, for example “only the screen size in inches, taken from the specifications”.
Whether AI values for an attribute are saved right away or wait for your approval is set per field in Settings > AI review. Filter the field list on Attributes to give one attribute its own rule.

Platforms

This tab shows how the attribute maps to each connected sales channel. Mapping itself happens in the integration’s Data Mapping tool, and the tab links you straight there with Open Data Mapping tool. The mapper has two modes: Map to build mappings by dragging or choosing a source directly, and Review to audit coverage and correct individual mappings. Smart match attributes runs locally on strong name matches, without an AI call, and you review the result before saving. Undo reverses the last manual mapping, auto-map, or removal. Long attribute lists are paged, so a 500-attribute model stays workable.

Build a model with Guide catalog structure

Starting from scratch, or moving into a new industry? Choose More > Guide catalog structure (or the recommended card on an empty attributes page). It opens Organize your products, a guided flow that looks at the products you select and suggests families, attributes with options, categories and variant groups together.
1

Choose products

Search for a small group of products and select them. Pick Use an industry guide or Choose automatically from my products.
2

Review suggestions

Click Find suggestions. Open a suggestion to see why it was made, adjust it, or leave it out.
3

Confirm changes

Click Review changes to see exactly what will be created, reused, updated and linked. Then click Apply these changes. Your existing values, cleared fields and translations are kept.
Guide catalog structure needs no credits. You can undo the applied changes as long as they haven’t been edited since.

Add attributes to families

Link attributes to product families straight from this page, without opening each family.
1

Select the attributes

Tick the attributes and click Add to families in the selection bar. For one attribute, use Add to families… in its row menu.
2

Pick the families

Use Search families to tick the families that should get the attributes.
3

Decide if they are required

Turn on Required in these families if products in these families need a value for the new attributes.
4

Add them

Click Add to N families. The change is one step you can undo.
Attributes already in a family keep their current settings there. Those links are skipped, not changed. New links are added at the end of the family’s attribute order. Above 499 new links you get “That is more than 499 new family links at once.” Select fewer attributes or families and run it again.

Bulk actions on attributes

Tick the checkboxes on several attributes and a selection bar appears. Select all N selects every attribute that matches your current filters, also on other pages.
  • Set properties: turn Required, Unique, Filterable, Searchable, Visible or AI can fill on or off for the whole selection. Properties you leave at No change stay as they are.
  • Move to group: reassign every selected attribute to another attribute group, or to No group.
  • Add to families: see Add attributes to families.
  • Edit settings: push operations, cleaning, enrichment and validation rules to every selected attribute. Changing a setting turns its section on, and only sections that are on are applied. The Preview tab shows the exact before-and-after changes.
  • Enrich: translate missing attribute names and option labels with AI. See Translate names and option labels with AI.
  • Export: export the selection. See Export attributes.
  • Delete: remove the selected attributes. You can undo it for 5 seconds.
Found a set of cleaning and enrichment settings that works well? Use Save as template in any attribute’s row menu, then pick it with Apply template… in Edit settings. Templates copy general behaviour only. Enrichment instructions and validation rules stay per attribute.

Organizing with attribute groups

Attribute groups bundle related attributes for a cleaner product form. For example, you might group “Width”, “Height” and “Depth” under a “Dimensions” group. WISEPIM attribute groups bundling related fields with category-scoped visibility WISEPIM attribute groups bundling related fields with category-scoped visibility
1

Open Attribute groups

On the Product attributes page, choose More > Attribute groups.
2

Click New group

Create a group with a name and a code. Set a sort order to control where the group sits relative to other groups.
3

Set the visibility scope

Choose whether the group shows for all products or only for specific categories. Category scope keeps forms focused, so a “Battery” group appears only on electronics, not on apparel.
4

Assign attributes

Select which attributes belong in this group.
5

Save the group

Click Save. The group organizes its attributes into a section in product forms.
Group attributes by purpose: a “Specifications” group for technical details, a “Marketing” group for descriptions and features, a “Logistics” group for shipping info.

Option sets

An option set lists the values a Select or Multi-select attribute accepts. Instead of typing the same options into every attribute, you define the list once and point several attributes at it. Update the list in one place and every attribute that uses it stays in sync. WISEPIM option sets page with per-set import handling and value previews WISEPIM option sets page with per-set import handling and value previews Open Catalog > Option sets, or choose More > Option sets on the Product attributes page. Click New option set to create one. Each option set has:
  • A Name, Code and optional Description.
  • A list of Values, each with a code and a label per language. Use Paste values to add many at once: one value per line, with a tab between code and label to set both.
  • An Active or Inactive state per value, so you can retire an option without deleting its history.
  • A rule for When an import brings a value that is not in this set:
The Used by column shows how many attributes use each set. When you create or quick-edit a Select or Multi-select attribute, pick Use an option set and choose the set.

Export option sets

Export attribute options dialog with Scope set to All option sets and the CSV file, Connected platform and Another project destinations Export attribute options dialog with Scope set to All option sets and the CSV file, Connected platform and Another project destinations Select option sets and click Export, or choose More > Export. In Export attribute options, pick the Scope (Selected option sets or All option sets, up to 5,000 at a time) and a Destination:
  • CSV file: download option sets and their values as CSV.
  • Connected platform: export the attributes linked to each set. Most channels receive the values with the next product export. Lightspeed creates the filter definitions and their active values right away. Each option set needs a directly linked attribute.
  • Another project: copy option sets, localized values and import settings to a Target project. Sets and values with the same code there are overwritten, so you confirm with Copy and overwrite. Values that only exist in the target project stay.
Use a shared option set whenever the same list shows up on more than one attribute, for example a brand list, a material list or a size scale. It is the most effective way to stop near-duplicate values from creeping into your catalog.

Translate names and option labels with AI

Select attributes or option sets and click Enrich in the selection bar to fill missing translations of attribute names and option labels. Enrich attributes dialog with Items to enrich, Target languages and Fields to enrich set to Attribute names and Option labels Enrich attributes dialog with Items to enrich, Target languages and Fields to enrich set to Attribute names and Option labels
1

Choose the items

Under Items to enrich, pick Selected or All. You can enrich up to 5,000 items at a time.
2

Choose the languages

Under Target languages, tick the languages to fill. All project languages except your main language are ticked by default.
3

Choose the fields

For attributes, pick Attribute names, Option labels or both under Fields to enrich. For option sets, the dialog always fills Option labels.
4

Start

Click Review enrichment, check the summary, then click Start enrichment. Follow the run with View tasks in the Process Tracker.
Enrich attribute options dialog with Items to enrich, Target languages and the fixed Option labels field Enrich attribute options dialog with Items to enrich, Target languages and the fixed Option labels field Existing labels and option codes are kept. Only missing translations are filled. If you don’t have enough credits, the dialog tells you how many the run needs and how many you have. This rate is separate from filling product attribute values with AI, which is covered in AI Attribute Extraction.

See and merge values

Free-text attributes collect spelling variants over time: “Black”, “black ” and “Zwart”. Choose See and merge values in an attribute’s row menu to open Attribute values. It works for text, choice and color attributes.
  • Look-alikes groups values that only differ in capitals, spaces, spelling or wording. Pick the value to keep and click Merge. Merging changes the value on every product that has it.
  • All values lists every distinct value with its product count. Use Rename, Merge into… or Make allowed per value.
  • Find look-alikes asks AI to compare values the rules missed, like Zwart and Black. The button shows the most it can cost, and nothing is merged until you press Merge. If the AI doesn’t answer, you are not charged.
  • When an attribute has no allowed values yet, Use these N values as the allowed list turns the cleaned-up values into its options.
Every merge and rename can be reversed with Undo last change. Large merges keep running in the background.
Export to your shop after a merge. Otherwise the next shop import brings back the old spelling.

Export attributes

Choose More > Export, or select attributes and click Export in the selection bar. In Export attributes, pick the Scope (Selected attributes or All attributes) and a Destination:
  • CSV file: download definitions and settings as a CSV you can import again as-is.
  • Connected platform: enable the attributes in the platform’s product-export mapping with Enable export. For Lightspeed, pick the Lightspeed store and click Export filters to create them as filters right away. Their values and product links follow with the next product export.
  • Another project: copy definitions, settings, code sets and matching family links to a Target project. Attributes there with the same code are overwritten, so you confirm with Copy and overwrite.

Import attributes

Choose More > Import attributes to bring definitions in from Shopify, Magento, WooCommerce or a CSV file. For CSV, the column mapper covers every column of a WISEPIM attribute export, so an exported file imports again as-is. It also reads files with commas or semicolons as separators. Set a column you don’t need to Ignore and it is really dropped. The review step shows “All N columns are mapped or skipped.” once every column is handled. Files without the group and families columns leave groups and families untouched. The other columns (Required, Unique, Filterable, Searchable, Visible, Differentiator, Sort order, Default value, Default unit, and the validation, AI enrichment, cleaning and platform settings) match the export.
Pair export with import to bulk-edit: export your attributes, adjust groups or family membership in a spreadsheet, then import the file again.

Views and filters

The Product attributes page adapts to how you work, so a 20-attribute model and a 500-attribute model both stay manageable.
  • Search: search by label or code.
  • Filters: filter by group, type and properties, and combine them with All or Any matching.
  • Views: built-in views such as Required, Not in a group and Needs attention, plus your own. Use Save view to keep the current filters, search and group or type.

Troubleshooting

Attribute not showing in product forms

  • Check that the attribute is marked as Visible.
  • Verify the attribute is assigned to the product’s family.
  • Confirm the attribute group is not hidden by its category visibility scope.

A Select attribute stays empty after AI enrichment

  • AI only picks existing options. A Select or Multi-select attribute without options can’t be filled, and the product shows “This field has no options yet. Add options, or let AI add them.”
  • Add options, link an option set, or import a list through the CSV options column.
  • Or turn on Let AI add new options in quick edit.

Validation errors during data entry

  • Review the validation rules for overly strict settings.
  • Check for conflicting rules (for example, a minimum higher than the maximum).
  • Make sure error messages are clear so your team knows what to fix.

Inconsistent data across products

  • Open See and merge values to merge look-alike values.
  • Switch from free text to Select or Multi-select, backed by a shared option set where possible.
  • Turn on data cleaning rules to normalize values automatically.
  • Use the Data Quality tools to find and fix inconsistencies.

Product Families

Assign attributes to product families to define which data each product type requires.

Units of Measure

Link number and decimal attributes to unit sets for consistent, convertible measurements.

AI Attribute Extraction

Let AI fill attribute values on your products from descriptions and research.

Managing Product Categories

Organize products into hierarchical categories for navigation and filtering.

Data Quality Analytics

Track completeness and fix inconsistent attribute values across your catalog.

Process Tracker

Follow attribute imports, exports and label enrichment runs.