Skip to content

E02-228 A value isn't one of the allowed values

E02-228 is no longer written to log files. What an import's log file says today about a value that is not on an attribute's list of allowed values, for products and custom entities, and how to fix it.

E02-228 is no longer written to log files. Today an import that meets a value not on an attribute’s list of Allowed values says so in words: a product is imported without that field’s value, and a custom entity record is not imported at all.

You imported Severity Message
Products Warning The record was imported without this field’s value. “Blue” isn’t one of this field’s options. Change the value in the file, or add the option to the field, and import again.
Custom entity records Error Couldn’t import the record. “Blue” isn’t one of this field’s options. Change the value in the file, or add the option to the field, and import again.

The quoted value is the one from your file. In the message, “options” means the entries on the Allowed values list.

For a custom entity record the import updates, the quoted value can be one the record already holds, from before it was taken off the list. The record is refused until the file gives the field an allowed value or empties it, or you put the value back on the list. Where to find the log file, and what its columns show: Reading a log file.

Only a Text attribute has a list of allowed values. Choose by whether the value is right and the list is missing it, or the value is wrong.

The value is… Fix Where
Right, and should be one of the allowed values Add it to the list The attribute’s Values tab: type it under New value and select Add
Right, and the attribute should take any value Turn on Allow custom values The attribute’s Values tab, in the Options section
Wrong, in a file you import by hand Replace it in the file with one of the allowed values Your import file
Wrong, in files a data source imports for you Convert or remove it before it is written The dataset’s Mapping tab on the data source: open the field’s pipeline with the arrow button beside it (pointing at it shows Edit pipeline) and add a node that converts or removes the value

The attribute’s Values tab is in Settings → Attributes & sections for an attribute of a product, and in Settings → Custom entities for an attribute of a custom entity — see Attributes and Custom entity settings. A change on the tab is saved only when you select Done in the attribute’s window and then Save on the section or the custom entity.

Then import the file again.