> For the complete documentation index, see [llms.txt](https://doc.wearepatchworks.com/product-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.wearepatchworks.com/product-documentation/release-information/core-release-notes/2023-12-05-release-notes-core.md).

# 2023 12 05 release notes (core)

## Release summary

The information detailed on this page refers to updates included in the following releases to the Patchworks Production environment:

**Patchworks core (backend)**

| Release version | Release date      |
| --------------- | ----------------- |
| 1.8.4           | 5th December 2023 |

**Patchworks dashboard (frontend)**

| Release version | Release date      |
| --------------- | ----------------- |
| 1.6.3           | 5th December 2023 |

New features, updates, and enhancements of note are summarised by product area, below:

* [General](#general)
* [Process flows](#process-flows)
* [Connectors & instances](#connectors-and-instances)
* [Dashboard UI](#dashboard-ui)
* [Prebuilt connectors](#prebuilt-connectors)

## General

<table><thead><tr><th width="180">Type<select><option value="edbc33cea7f34e16b3a205c7a65c3172" label="New" color="blue"></option><option value="d8457d8925c74fab90fa132d141b764b" label="Update" color="blue"></option><option value="030babd6286a4fe19214da74af9afb98" label="Enhancement" color="blue"></option><option value="9a29ee576f43448f9b1623baca59c3db" label="Bug" color="blue"></option></select></th><th width="388">Summary</th><th>Ref #</th></tr></thead><tbody><tr><td><span data-option="edbc33cea7f34e16b3a205c7a65c3172">New</span></td><td><strong>Patchworks marketplace</strong><br>The Patchworks marketplace is now your one-stop stop for all resources that you may want to install to streamline your integrations. You can now browse and install apps, connectors, process flows, and cross-reference lookups.<br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&amp;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt=""> <a href="/product-documentation/marketplace/the-patchworks-marketplace.md">The Patchworks marketplace</a></td><td>CPT-1576</td></tr><tr><td><span data-option="edbc33cea7f34e16b3a205c7a65c3172">New</span></td><td><strong>Patchworks apps</strong><br>This release introduced apps - install everything you need (connectors, process flows, scripts, etc.) to perform a specific task.<br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&amp;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt=""><a href="/product-documentation/marketplace/the-patchworks-marketplace.md">The Patchworks marketplace</a></td><td>CPT-1576</td></tr></tbody></table>

## Process flows

<table><thead><tr><th width="180">Type<select><option value="edbc33cea7f34e16b3a205c7a65c3172" label="New" color="blue"></option><option value="d8457d8925c74fab90fa132d141b764b" label="Update" color="blue"></option><option value="030babd6286a4fe19214da74af9afb98" label="Enhancement" color="blue"></option><option value="9a29ee576f43448f9b1623baca59c3db" label="Bug" color="blue"></option></select></th><th width="388">Summary</th><th>Ref #</th></tr></thead><tbody><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td><strong>Forward slashes in cache keys</strong><br>Fixed issue where the forward slash character was not permitted when defining cache keys.<br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&amp;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt=""> <a href="/product-documentation/process-flows/building-process-flows/process-flow-shapes/advanced-shapes/cache.md">Cache shapes</a></td><td>CPT-1524</td></tr><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td><strong>Incorrect mapping structure</strong><br>Fixed issue where mapping a flat array to an indexed array resulted in an incorrect structure.<br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&amp;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt=""> <a href="/product-documentation/process-flows/building-process-flows/process-flow-shapes/standard-shapes/map-shape.md">Map shape</a></td><td>CPT-1524</td></tr><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>Filter logs by process flow</strong><br>It's now possible to filter process flow run logs by process flow.<br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&amp;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt=""> Documentation coming soon</td><td>CPT-905</td></tr><tr><td><span data-option="d8457d8925c74fab90fa132d141b764b">Update</span></td><td><strong>All shapes now support manual input for payload fields</strong><br>All shapes have been updated to include a manual input option wherever the user has the option to select a payload field.<br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&amp;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt=""> <a href="/product-documentation/process-flows/building-process-flows/process-flow-shapes/standard-shapes/map-shape.md">Shapes</a></td><td>CPT-1419</td></tr><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td><strong>Empty payloads</strong><br>Fixed issue passing 'empty' payloads into a shape (which can happen if a null is returned from a script, or if a cache expires). As part of this fix, a new <code>string length</code> option is available on the filter shape.<br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&amp;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt=""> <a href="/product-documentation/process-flows/building-process-flows/process-flow-shapes/standard-shapes/filter-shape.md">The filter shape</a></td><td>CPT-1763</td></tr><tr><td><span data-option="edbc33cea7f34e16b3a205c7a65c3172">New</span></td><td><strong>Custom string transform now supports payload metadata</strong><br>The custom string field mapping transform now supports payload metadata values using <code>[[meta.unique_key]]</code> syntax.<br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&amp;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt=""> <a href="/product-documentation/process-flows/building-process-flows/dynamic-variables/flow-variables/referencing-flow-and-meta-variables-in-mapping-transformations.md">Referencing flow &#x26; meta variables in mapping transformations</a></td><td>CPT-1440</td></tr><tr><td><span data-option="edbc33cea7f34e16b3a205c7a65c3172">New</span></td><td><strong>Inbound API now supports flow variables</strong><br>When initialising a process flow using the Inbound API, it's now possible to pass in flow variables.<br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&amp;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt=""> <a href="/product-documentation/process-flows/managing-process-flows/initialising-a-process-flow-manually-with-a-payload.md">Initialising a process flow manually with a payload</a></td><td>CPT-1519</td></tr></tbody></table>

## Connectors & instances

<table><thead><tr><th>Type<select><option value="edbc33cea7f34e16b3a205c7a65c3172" label="New" color="blue"></option><option value="d8457d8925c74fab90fa132d141b764b" label="Update" color="blue"></option><option value="030babd6286a4fe19214da74af9afb98" label="Enhancement" color="blue"></option><option value="9a29ee576f43448f9b1623baca59c3db" label="Bug" color="blue"></option></select></th><th width="388">Summary</th><th>Ref #</th></tr></thead><tbody><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>Installing a connector includes required scripts</strong><br>If a marketplace connector requires pre/post scripts, these are now included when a user chooses to install the connector (previously these would be added manually).<br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&amp;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt=""><a href="/product-documentation/connectors-and-instances/working-with-connectors/installing-a-connector.md">Installing a connector</a></td><td>CPT-821</td></tr><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td><strong>URL parameters excluded from POST requests</strong><br>Fixed issue where URL parameters were not being passed in POST requests.<br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&amp;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt=""> <a href="/product-documentation/developer-hub/connector-builder/building-your-own-connector/4-endpoints/endpoint-options/url.md">URL parameters</a></td><td>CPT-1436</td></tr></tbody></table>

## Dashboard UI

<table><thead><tr><th width="156">Type<select><option value="edbc33cea7f34e16b3a205c7a65c3172" label="New" color="blue"></option><option value="d8457d8925c74fab90fa132d141b764b" label="Update" color="blue"></option><option value="030babd6286a4fe19214da74af9afb98" label="Enhancement" color="blue"></option><option value="9a29ee576f43448f9b1623baca59c3db" label="Bug" color="blue"></option></select></th><th width="388">Summary</th><th>Version &#x26; Ref #</th></tr></thead><tbody><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td>Field select UI<br>Fixed issue where the dropdown for payload field selection could be partially hidden.</td><td>CPT-35</td></tr></tbody></table>

## Prebuilt connectors

The following prebuilt connectors have been added to the Patchworks marketplace since our previous release:

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Bloomreach Engagement</strong> is an eCommerce platform specialising in marketing automation, product discovery, and content management systems.</td><td></td><td></td><td><a href="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FbfQ8IjJXFFbcGphQyWU3%2Fbloomreach.svg?alt=media&amp;token=77abdca0-08ce-49fd-bd8a-fb12e7ee73d2">bloomreach.svg</a></td><td><a href="/product-documentation/connectors-and-instances/patchworks-connectors/bloomreach-engagement-prebuilt-connector.md">Bloomreach Engagement (prebuilt connector)</a></td></tr><tr><td><strong>EKM Insight</strong> is a leading managed print service (MPS) software supplier, helping customers optimise their print and imaging operations.</td><td></td><td></td><td><a href="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FclOgJBjEB3IC61rdwpT8%2FEKM.svg?alt=media&amp;token=5f451c34-834e-446d-bb53-dae06f2946ce">EKM.svg</a></td><td><a href="/product-documentation/connectors-and-instances/patchworks-connectors/ekm-insight-prebuilt-connector.md">EKM Insight (prebuilt connector)</a></td></tr><tr><td><strong>Gorgias</strong> is a customer support platform built for e-commerce companies.</td><td></td><td></td><td><a href="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FL8S3zfffO1lm8s5LyH6d%2FGorgias.svg?alt=media&amp;token=e7456395-8d58-44d5-9e24-16fb09c2dc56">Gorgias.svg</a></td><td><a href="/product-documentation/connectors-and-instances/patchworks-connectors/gorgias-prebuilt-connector.md">Gorgias (prebuilt connector)</a></td></tr><tr><td><strong>ShipBob</strong> is a global fulfillment solution used by brands to ship orders from everywhere their customers shop.</td><td></td><td></td><td><a href="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FsQInQNZ4fvOV8gRb7ocm%2Fshipbob.svg?alt=media&amp;token=839383d9-b3ec-4f97-9cc5-438758ae9d17">shipbob.svg</a></td><td><a href="/product-documentation/connectors-and-instances/patchworks-connectors/shipbob-prebuilt-connector.md">ShipBob (prebuilt connector)</a></td></tr><tr><td><strong>Snowflake</strong> provides a single platform for data warehousing, data lakes, data engineering, etc., with secure sharing and consumption of real-time / shared data.</td><td></td><td></td><td><a href="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FITbWg8KztgojAtp6DrhZ%2Fsnowflake.svg?alt=media&amp;token=a3ec3290-2593-46c3-9986-901092ba22e8">snowflake.svg</a></td><td><a href="/product-documentation/connectors-and-instances/patchworks-connectors/snowflake-prebuilt-connector.md">Snowflake (prebuilt connector)</a></td></tr><tr><td><strong>Stok.ly</strong> provides seamless, multi-channel and multi-location order and warehouse management for retailers and wholesalers.</td><td></td><td></td><td><a href="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FaPSHbPZEmXxUiBdZcmZW%2Fstockly.svg?alt=media&amp;token=096e6190-7e82-484d-81ee-71532d7a0b23">stockly.svg</a></td><td><a href="/product-documentation/connectors-and-instances/patchworks-connectors/stok.ly-prebuilt-connector.md">Stok.ly (prebuilt connector)</a></td></tr><tr><td><strong>Virtualstock</strong> is Europe's largest drop-shipping and curated marketplace SaaS (software-as-a-service) platform.</td><td></td><td></td><td><a href="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F9U5Kf0aJAu46osPD8nlQ%2Fvirtualstock.svg?alt=media&amp;token=a2d61f29-d8ff-43b9-b062-8fefdbbe56db">virtualstock.svg</a></td><td><a href="/product-documentation/connectors-and-instances/patchworks-connectors/virtualstock-prebuilt-connector.md">Virtualstock (prebuilt connector)</a></td></tr></tbody></table>
