What’s New
SiteFlow attribute mapping has been enhanced to support specification attributes in addition to standard product attributes.
This means you can now send more product configuration data into SiteFlow without relying only on visible product attributes. It is especially useful when values need to be passed into SiteFlow but should not be displayed or selected by the customer on the storefront.
The SiteFlow/PrintOS mapping settings now support both:
- Product attributes
- Specification attributes
The attribute selection experience has also been improved. Instead of entering values manually, mappings now use an autocomplete-style selector that shows available attributes and includes IDs where needed. This helps avoid confusion when multiple attributes have the same name.
Product attributes are clearly identified with a Attribute: prefix.
Specification attributes are clearly identified with a SpecAttribute: prefix.
What Was It Like Before?
Previously, SiteFlow mappings only supported standard product attributes.
Some customers worked around this by using hidden product attributes, but this was limited and did not always support the required values cleanly. It also made setup harder to manage when the data was really better suited to specification attributes.
Updated Settings
The following mapping settings have been updated to support the new attribute selection format:
- Paper attribute(s)
- Shrink wrap attribute(s)
- Binding attribute(s)
- Folding attribute(s)
A new setting has also been added:
Include specification attributes in optional attributes
This works alongside the existing setting for product attributes, giving you separate control over whether specification attributes are included in optional attribute data sent to SiteFlow.
Pre-Requisites
Before configuring specification attributes for SiteFlow, make sure the following are already in place:
- A working SiteFlow/PrintOS integration
- Existing MIS notification setup for SiteFlow
- Product attributes and/or specification attributes already created in Infigo
- Valid SiteFlow-compatible values for:
- Paper types
- Binding types
- Folding types
- Shrink wrap types
It’s also important to understand which data should be customer-facing and which should remain internal.
Product attributes are typically used for customer-selectable options, while specification attributes are often better suited for production or fulfilment data that should not appear on the storefront.
Before enabling optional attribute inclusion settings, confirm that your SiteFlow workflow supports the additional values being sent in the request payload.
How to Set It Up
Go to the relevant SiteFlow/PrintOS configuration area in Admin (Connect Plugins section).
Locate the Product Attribute/Specification Attribute mapping settings, such as:
- Paper attribute(s)
- Shrink wrap attribute(s)
- Binding attribute(s)
- Folding attribute(s)
Use the searchable attribute selector to choose the product or specification attributes you want to map.
When selecting specification attributes, look for values prefixed with:
SpecificationAttribute Id: 123
Save your changes.
The mapped values should match the values expected by SiteFlow. For example:
- Paper mappings should resolve to valid SiteFlow paper types
- Binding mappings should resolve to valid SiteFlow binding types
- Folding mappings should resolve to valid SiteFlow folding types
Using unsupported values may cause SiteFlow API requests to fail.
You can also configure:
- Include product attributes in optional attributes
- Include specification attributes in optional attributes
These settings control whether additional attributes are added into the SiteFlow attributes payload.
Unless specifically required and validated for your SiteFlow workflow, it is recommended to leave these disabled, as unsupported values in the payload may result in failed SiteFlow requests.
Save your changes once the mappings are complete.
Once your specification attributes are mapped correctly, navigate to the product which requires artwork, click Edit and add the relevant Specification Attributes:
And you would repeat the same process for Product Attributes.
Make sure you map each Specification Attribute (Or Product Attribute) to your SiteFlow External ID:
Save the configuration.
Now when a customer logs into the store and places an order, the Infigo Sales Order - ExtraData section will show the sent specification attributes (and product attributes if there are any mapped)
Tips
Use specification attributes when the data needs to be passed into SiteFlow but does not need to be shown as a customer-facing option on the storefront.
This is useful for production settings, fulfilment details, finishing options, or other configuration values that are important downstream but should remain hidden from the end user.
If multiple attributes have similar names, use the ID shown in the selector to make sure the correct attribute is selected.
Summary
This update makes SiteFlow mappings more flexible by allowing specification attributes to be sent alongside product attributes.
It reduces the need for workaround hidden attributes, makes mapping clearer, and gives admins better control over what product data is passed into SiteFlow.