Perfion Connector for Shopify

  • Updated

The Perfion Connector for Shopify is a licensed module (must be included in your Perfion license) and requires Perfion 4.5 2019 R1.

Perfion Connector for Shopify version 2.2

This package contains the Perfion Connector for Shopify version 2.2 for Shopify API 2025-07.

Related guides:

Shopify - Install

Release Notes

Perfion Connector for Shopify version 2.2.10

Release note
Mapped Images - Variants are now correctly created even when no images are mapped.

Perfion Connector for Shopify version 2.2.9

Release note
Mapped fields - Fields that are not mapped can now be controlled by third‑party applications. The following fields have been added to the “will be ignored if not mapped” list:
GiftCard, Images, SeoTitle, SeoDescription, Status, and Tags.
Initial Validate Call - The initial "validate call" to the Perfion Ecommerce API has been removed, as this call could in some cases be very slow.

Perfion Connector for Shopify version 2.2.7

Release note
Rich text metafield - Fixed an issue with Rich text metafields having Paragraph tag in lists

Perfion Connector for Shopify version 2.2.6

Release note
Rich text metafield - Fixed an issue with Rich text metafields including two bullet list in the same field

Perfion Connector for Shopify version 2.2.5

Release note
Logging error messages - Fixed an issue with missing logging error messages if product_reference mapping was added.

Perfion Connector for Shopify version 2.2.4

Release note
Update to Shopify API version 2025-10 - No breaking change for the new Shopify API.
The Shopify connector now supports authentication via Custom App using Client ID and Client Secret. Shopify has announced that legacy custom apps using long-lived access tokens will no longer be supported starting in 2026. Existing long-lived access tokens can still be used for now, but new integrations should migrate to the new authentication method.
Supports Product status Unlisted - The new product status called “Unlisted” is now supported in the connector. It hides products from store search and collections, all sales channels, internet searches and Shopify Catalog - while still allowing access via a direct URL.
The metafield types file_reference and list.file_reference are now translatable using the localizable features via the map Attachment(Url).
Support for Cron expressions has been added - Synchronization can now be scheduled to start at a specific time using Cron expressions, rather than being limited to minute-based intervals.
The metafield types collection_reference and list.collection_reference can now be used with Collection/Category mapping
Resolved an issue that prevented CountryCodeOfOrigin from being added during product creation

Perfion Connector for Shopify version 2.2.3

Release note
In version 2.2.0, the update to Shopify API version 2025-07 only included the schema changes, but not the endpoints. With this release, the endpoints have now also been updated to use API version 2025-07.
Product Reference Metafield - It is now possible to use Perfion "Related Product" to map directly to Product Reference Metafield.
Variant dimension are now translatable.
Variant dimension showing wrong language - Fixed a bug where the variant dimension showing the wrong language value. It now correctly shows the correct language value.

Perfion Connector for Shopify version 2.2.2

Release note
Changing the logging when waiting for the next synchronization to only log the first "The next delta synchronization will start in..." and updating NuGet packages.
A new setting OnlySetPricesOnAdd has been added to SyncType - When enabled, prices are only set when a product or variant is created and remain unchanged during updates. This is useful if a third-party system updates products, but an initial price must be set on creation.
Metafield type Money - It is now possible to use Metafield type Money with Perfions units/currency and not only the json string.
Metafields - Fixed a bug that prevented the use of special characters. It is now possible to include special characters in Metafields.

Perfion Connector for Shopify version 2.2.1

Release note
A new setting IgnoreImages has been added for both SyncType and CategorySyncType. When enabled, all image synchronization will be stopped: Existing images remain unchanged, New images will not be added, Removed images will not be deleted.
It is now possible to have translated SEO title and description at Collections.
Market Prices - Previously, market prices were deleted if they were not mapped. This has been changed so that market prices are now only updated if they are mapped to products or variants.
Improved image synchronization - Image synchronization has been optimized to reduce timeouts in Shopify. Previously, new images not yet cached in the Perfion Image API could cause timeouts. The connector now handles caching more efficiently, improving overall stability.

Perfion Connector for Shopify version 2.2.0

Release note
Update to Shopify API version 2025-07 - No breaking change for the new Shopify API.
Updating the Shopify Connector to http://ASP.Net Core 8 and updating NuGet packages. Ensure the http://ASP.Net Core 8 are installed.
Setting for fixed product prices via Market - It is now possible to set product and variant prices for each Market. Use the new mapping Price_<MarketName>
Schedule publishing for Online Store added for Collections and Products. Use the mapping OnlineStorePublishDate.
MetaFields Error Handling Enhancement - A new setting, ShopifyBulkUpdateMetaFields, has been introduced to improve error handling when updating metafields via Shopify. By default, Shopify processes metafield updates in bulk. If any metafield fails, the entire operation is halted. With the new setting, the system will detect errors in the bulk updates and automatically switch to single update mode, allowing successful metafields to be updated individually.
Variant position - Reordering variants via Position mapping now works as expected.
Improved Error Handling for Rich Text Meta Fields - Previously, product synchronization would stop if a Rich Text Meta field contained invalid XML. This issue has been resolved. Now, invalid Rich Text content will be logged and the product synchronization to continue.

Perfion Connector for Shopify version 2.1.3

Release note title Release note
SyncMsg messages are cleared When a product are synchronized without errors or warnings, the SyncMsg are cleared for old messages.
Translated SEO title and description are added It is now possible to have translated SEO title and description.
Renaming Variant Options bug It is now possible to rename and reorder Variant Options.

Perfion Connector for Shopify version 2.1.2

Release note title Release note
Limitation of 250 collections has been removed A bug is fixed and it is now possible to have more the 250 collections. It is still not possible to have more the 250 collection at one product.
The file appsettings.json renamed to appsettings.json.example To prevent overwriting the configuration file appsettings.json the file is renamed to appsettings.json.example.

Perfion Connector for Shopify version 2.1.1

Release note title Release note
Rich text synchronization It is now possible to synchronize rich text features as rich text metafields
Localizable Features synchronization bug Localizable Features synchronization for more the one language is now possible.
More then 25 Metafields A bug is fixed in Metafields synchronization and now it is possible to have more then 25 Metafields.
Metafields with file_reference It is now possible to use Shopify Id like gid://shopify/ImageMedia/1234 in file_reference.
A bug when adding images to variants is fixed. Adding new thumbnail image to variants adds the image to the Product in first sync run, but the thumbnail is first added to the Variant in second sync run.

Perfion Connector for Shopify version 2.1.0

Release note title Release note
Update to Shopify API version 2024-10

News in version 2024-10:

Deprecated by Shopify:

  • CustomProductType. Use the ProductType field instead.
  • ProductCategory. Use the category field instead.
  • StandardizedProductType. Use the ProductType field instead.
New Metafield namespace "Perfion-App-Data" To track data between Perfion and Shopify. Metafields with the namespace "Perfion-App-Data" are added for technical internal use.
Deletes or deactivates non Perfion products Two new SyncType DeactivateOnlyPerfion and DeleteOnlyPerfion are added. With these types, it is possible to have products that are not maintained via Perfion.
Add and delete Variant Dimensions It is now possible to add and delete Variant Dimensions via the Shopify Connector.
Error handling in E-Commerce API Added error handling so the synchronization handle all products or no products if the E-commerce API send an error.

Perfion Connector for Shopify version 2.0.1

Release note title Release note
Delete Metafields onfy for Namespace = Perfion To prevent deleting Metafields created from other 3. parts apps, only Metafields with a Namespace = 'Perfion' will be deleted if the value is deleted in Perfion.

Shopify API rate limits

 

If the Shopify API rate limits is reached, the connector will wait and retry.
Fields can be controllable from 3. part apps. Fields like Taxable can be controllable from 3. part apps if it is not mapped in the connector.
Images - Only upload unique images If the same images/Image URLs are used on several variants, the image will only be uploaded to the product ones.
More error handling is added A bug around API error handling is fixed. In some cases a file upload error was not reported to the log
It is now passible to create metafields of type Dimension and Volume A bug is fixed, so it is now possible to create metafields of type Dimension and Volume.

 

Was this article helpful?

0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.