# 2025 09 17 release notes (core)

## Release summary <a href="#release-summary" id="release-summary"></a>

This page summarises items scheduled for the following release to the Patchworks Core Production environment.&#x20;

| Release version | Release date              |
| --------------- | ------------------------- |
| v2025-09-17     | 17th September 2025 (a.m) |

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

* [Company registration](#company-registration)​
* [Process flows](#process-flows)
* [Virtual environments](#virtual-environments)
* [Connector builder](#connector-builder)
* [Blueprints](#blueprints)
* [Multi-company profiles](#blueprints)

## Company registration

<table><thead><tr><th width="180">Type<select><option value="edbc33cea7f34e16b3a205c7a65c3172" label="New" color="blue"></option><option value="d8457d8925c74fab90fa132d141b764b" label="Change" color="blue"></option><option value="030babd6286a4fe19214da74af9afb98" label="Enhancement" color="blue"></option><option value="9a29ee576f43448f9b1623baca59c3db" label="Bug" color="blue"></option><option value="L09Gy6z2y7VD" label="Breaking change" color="blue"></option></select></th><th width="426">Summary</th><th>Ref #</th></tr></thead><tbody><tr><td><span data-option="d8457d8925c74fab90fa132d141b764b">Change</span></td><td><strong>Registering for a trial account</strong> <br>The process for registering a trial account has changed. Now, users are directed to our request a trial page - here they can enter company details and schedule a brief meeting with Patchworks to discuss requirements and initiate a trial.<br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FRrjk9xAjfqkNrsD16eTE%2Ficon%20page.png?alt=media&#x26;token=dab50d7c-876d-460c-a6ba-676fac0531f9" alt="" data-size="line"> <a href="../../registration/registering-for-a-patchworks-account">Registering for a Patchworks account</a></td><td>CPT-4589</td></tr></tbody></table>

## Process flows <a href="#process-flows" id="process-flows"></a>

<table><thead><tr><th width="180">Type<select><option value="edbc33cea7f34e16b3a205c7a65c3172" label="New" color="blue"></option><option value="d8457d8925c74fab90fa132d141b764b" label="Change" color="blue"></option><option value="030babd6286a4fe19214da74af9afb98" label="Enhancement" color="blue"></option><option value="9a29ee576f43448f9b1623baca59c3db" label="Bug" color="blue"></option><option value="L09Gy6z2y7VD" label="Breaking change" color="blue"></option></select></th><th width="426">Summary</th><th>Ref #</th></tr></thead><tbody><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>View  payload metadata at each stage in a flow run</strong><br>A new <code>metadata</code> tab has been added to the process flow run details panel so you can view payload metadata at each step of a run.<br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FRrjk9xAjfqkNrsD16eTE%2Ficon%20page.png?alt=media&#x26;token=dab50d7c-876d-460c-a6ba-676fac0531f9" alt="" data-size="line"> <a href="../../process-flows/error-reporting-and-exception-handling/real-time-run-logs">Real-time run logs</a></td><td>CPT-4575</td></tr><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>Create caches from the data caches page</strong><br>Previously, new caches could only be created via an <a href="../../process-flows/building-process-flows/process-flow-shapes/advanced-shapes/cache/add-to-cache-shape">add to cache shape</a> in process flows. Now you can also use  <code>create cache</code> options from the <code>data caches</code> page - you'll find this option for each cache type.  <br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FRrjk9xAjfqkNrsD16eTE%2Ficon%20page.png?alt=media&#x26;token=dab50d7c-876d-460c-a6ba-676fac0531f9" alt="" data-size="line"> <a href="../../process-flows/building-process-flows/process-flow-shapes/advanced-shapes/cache/cache-maintenance">Cache maintenance</a></td><td>CPT-4549</td></tr><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><p><strong>Callback shape authentication</strong><br>By default, callback URLs include a Patchworks signature, which is passed as a URL parameter. However, some third-party systems don't allow URL parameters, stripping them out when found. </p><p></p><p>To handle this scenario, we now pass the signature in as a <code>patchworks_signature</code> header, if no signature is found in the URL.  <br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FRrjk9xAjfqkNrsD16eTE%2Ficon%20page.png?alt=media&#x26;token=dab50d7c-876d-460c-a6ba-676fac0531f9" alt="" data-size="line"> <a href="../../process-flows/building-process-flows/process-flow-shapes/standard-shapes/trigger-shape/trigger-shape-callback">Callback triggers</a></p></td><td>CPT-4725</td></tr><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>Run logs</strong><br>Performance improvements for loading run logs.  <br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FRrjk9xAjfqkNrsD16eTE%2Ficon%20page.png?alt=media&#x26;token=dab50d7c-876d-460c-a6ba-676fac0531f9" alt="" data-size="line"> <a href="../../process-flows/error-reporting-and-exception-handling/run-logs-and-queue/working-with-run-logs">Run logs </a></td><td>CPT-4798</td></tr><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td><strong>Substring transform function</strong><br>Fixed an issue where the substring transform function was not allowing negative offsets.<br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FRrjk9xAjfqkNrsD16eTE%2Ficon%20page.png?alt=media&#x26;token=dab50d7c-876d-460c-a6ba-676fac0531f9" alt="" data-size="line"> <a href="../../process-flows/building-process-flows/process-flow-shapes/standard-shapes/map-shape/working-with-field-transformations/available-transform-functions/string-transform-functions/substring-transform-function">The substring transform function</a></td><td>CPT-3099</td></tr></tbody></table>

## Virtual environments

<table><thead><tr><th width="180">Type<select><option value="edbc33cea7f34e16b3a205c7a65c3172" label="New" color="blue"></option><option value="d8457d8925c74fab90fa132d141b764b" label="Change" color="blue"></option><option value="030babd6286a4fe19214da74af9afb98" label="Enhancement" color="blue"></option><option value="9a29ee576f43448f9b1623baca59c3db" label="Bug" color="blue"></option><option value="L09Gy6z2y7VD" label="Breaking change" color="blue"></option></select></th><th width="426">Summary</th><th>Ref #</th></tr></thead><tbody><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>Ability to replace 'flow' caches</strong><br><code>flow</code> type caches are now available when selecting cache replacements for a virtual environment (previously, only <code>company</code> caches could be replaced).<br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FRrjk9xAjfqkNrsD16eTE%2Ficon%20page.png?alt=media&#x26;token=dab50d7c-876d-460c-a6ba-676fac0531f9" alt="" data-size="line"> <a href="../../virtual-environments/implementing-virtual-environments/configuring-a-virtual-environment-version/configuring-virtual-environment-replacements/replacement-caches">Replacement caches</a></td><td>CPT-4549</td></tr><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>Add (and sort by) labels</strong> <br>When creating a virtual environment, you can now apply labels. When <a href="../../virtual-environments/accessing-virtual-environments/understanding-the-virtual-environments-overview-page">viewing available virtual environments</a>, a new label filter option is available. <br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FRrjk9xAjfqkNrsD16eTE%2Ficon%20page.png?alt=media&#x26;token=dab50d7c-876d-460c-a6ba-676fac0531f9" alt="" data-size="line"> <a href="../../virtual-environments/implementing-virtual-environments/creating-a-virtual-environment">Creating a virtual environment</a></td><td>CPT-4498</td></tr><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>Advanced run from process flow canvas</strong><br>The advanced run option has been enhanced, allowing you to override environment variables for the selected virtual environment OR add new (temporary) environment variables if no virtual environment is chosen. <br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FRrjk9xAjfqkNrsD16eTE%2Ficon%20page.png?alt=media&#x26;token=dab50d7c-876d-460c-a6ba-676fac0531f9" alt="" data-size="line"> <a href="../../virtual-environments/implementing-virtual-environments/testing-a-process-flow-against-a-virtual-environment">Testing a process flow against a virtual environment</a></td><td>CPT-4694</td></tr><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>Warning before virtual environment removal</strong><br>Choosing to delete a virtual environment now displays a confirmation message, so users must confirm the action before the removal happens.<br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FRrjk9xAjfqkNrsD16eTE%2Ficon%20page.png?alt=media&#x26;token=dab50d7c-876d-460c-a6ba-676fac0531f9" alt="" data-size="line"> <a href="../../virtual-environments/managing-virtual-environments-versions-and-flows/managing-virtual-environments/deleting-a-virtual-environment">Deleting a virtual environment</a></td><td>CPT-4449</td></tr><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><p><strong>Adding flow versions to packages</strong></p><p>When choosing which version of a process flow to add to a package, you can now see the current status of the flow version (<code>draft</code>, <code>deployed</code>, <code>inactive</code>) as well as the version number.<br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FRrjk9xAjfqkNrsD16eTE%2Ficon%20page.png?alt=media&#x26;token=dab50d7c-876d-460c-a6ba-676fac0531f9" alt="" data-size="line"> <a href="../../virtual-environments/virtual-environment-packages/creating-a-package">Creating a package</a></p></td><td>CPT-4375</td></tr><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td><strong>View deployments display</strong> <br>Fixed a refresh issue where the view deployments modal was not updating to show a new deployment.<br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FRrjk9xAjfqkNrsD16eTE%2Ficon%20page.png?alt=media&#x26;token=dab50d7c-876d-460c-a6ba-676fac0531f9" alt="" data-size="line"> <a href="../../virtual-environments/implementing-virtual-environments/deploying-a-single-process-flow-to-a-virtual-environment">Deploying a single process flow to a virtual environment</a></td><td>CPT-4517</td></tr><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td><strong>Delete draft virtual environment version</strong> <br>Fixed a refresh issue where the option to create a new virtual environment <code>draft</code> version was not displayed immediately after deleting the existing draft.  <br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FRrjk9xAjfqkNrsD16eTE%2Ficon%20page.png?alt=media&#x26;token=dab50d7c-876d-460c-a6ba-676fac0531f9" alt="" data-size="line"> <a href="../../virtual-environments/managing-virtual-environments-versions-and-flows/managing-virtual-environment-configuration-versions/deleting-a-virtual-environment-version">Deleting a virtual environment version</a></td><td>CPT-4450</td></tr><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td><strong>Run process flow shape in virtual environments</strong><br>Fixed validation to ensure that the process flow called from a run process flow shape must exist in the same environment as the 'parent' flow - if not, the shape fails and an error is given.<br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FRrjk9xAjfqkNrsD16eTE%2Ficon%20page.png?alt=media&#x26;token=dab50d7c-876d-460c-a6ba-676fac0531f9" alt="" data-size="line"> <a href="../../process-flows/building-process-flows/process-flow-shapes/standard-shapes/run-process-flow-shape">Run process flow shape</a></td><td>CPT-4693</td></tr><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td><strong>Missing</strong> <strong>environment variables for new draft versions</strong> <br>Fixed an issue where environment variables present in a <code>deployed</code> virtual environment were missing in new <code>draft</code> versions created from that version.   <br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FRrjk9xAjfqkNrsD16eTE%2Ficon%20page.png?alt=media&#x26;token=dab50d7c-876d-460c-a6ba-676fac0531f9" alt="" data-size="line"> <a href="../../virtual-environments/managing-virtual-environments-versions-and-flows/managing-virtual-environment-configuration-versions/updating-a-virtual-environment-version">Updating a virtual environment version</a></td><td>CPT-4488</td></tr><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td><strong>Environment variables passed as connector variable values</strong><br>Fixed an issue where environment variables were not resolved correctly when passed as connector variable values. <br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FRrjk9xAjfqkNrsD16eTE%2Ficon%20page.png?alt=media&#x26;token=dab50d7c-876d-460c-a6ba-676fac0531f9" alt="" data-size="line"> <a href="../../virtual-environments/implementing-virtual-environments/configuring-a-virtual-environment-version/configuring-virtual-environment-replacements/replacement-variables">Replacement variables</a></td><td>CPT-4536</td></tr><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td><strong>Cross-reference lookup duplication</strong> <br>Fixed an issue where cross-reference lookups could be duplicated when a blueprint was installed. <br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FRrjk9xAjfqkNrsD16eTE%2Ficon%20page.png?alt=media&#x26;token=dab50d7c-876d-460c-a6ba-676fac0531f9" alt="" data-size="line"> <a href="../../blueprints/blueprints-introduction">Blueprints</a></td><td>CPT-4730</td></tr></tbody></table>

## Connector builder

<table><thead><tr><th width="180">Type<select><option value="edbc33cea7f34e16b3a205c7a65c3172" label="New" color="blue"></option><option value="d8457d8925c74fab90fa132d141b764b" label="Change" color="blue"></option><option value="030babd6286a4fe19214da74af9afb98" label="Enhancement" color="blue"></option><option value="9a29ee576f43448f9b1623baca59c3db" label="Bug" color="blue"></option><option value="L09Gy6z2y7VD" label="Breaking change" color="blue"></option></select></th><th width="426">Summary</th><th>Ref #</th></tr></thead><tbody><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td><strong>Multiple occurrences of the same endpoint variable</strong><br>Fixed an issue where defining the same endpoint variable multiple times (i.e. sending array elements in the form <code>my_variable[]</code> ) resulted in only the first variable being sent in requests.<br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FRrjk9xAjfqkNrsD16eTE%2Ficon%20page.png?alt=media&#x26;token=dab50d7c-876d-460c-a6ba-676fac0531f9" alt="" data-size="line"> <a href="../../developer-hub/connector-builder/building-your-own-connector/4-endpoints/endpoint-options/endpoint-variables">Endpoint variables</a></td><td>CPT-3921</td></tr><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td><strong>OAuth redirects for API keys</strong> <br>Fixed an issue where creating OAuth-based connectors via the API failed (because redirects back to Patchworks no longer contained API keys passed in the original request).<br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FRrjk9xAjfqkNrsD16eTE%2Ficon%20page.png?alt=media&#x26;token=dab50d7c-876d-460c-a6ba-676fac0531f9" alt="" data-size="line"> <a href="../../blueprints/blueprints-introduction">Blueprints</a></td><td>CPT-4683</td></tr></tbody></table>

## Blueprints

<table><thead><tr><th width="180">Type<select><option value="edbc33cea7f34e16b3a205c7a65c3172" label="New" color="blue"></option><option value="d8457d8925c74fab90fa132d141b764b" label="Change" color="blue"></option><option value="030babd6286a4fe19214da74af9afb98" label="Enhancement" color="blue"></option><option value="9a29ee576f43448f9b1623baca59c3db" label="Bug" color="blue"></option><option value="L09Gy6z2y7VD" label="Breaking change" color="blue"></option></select></th><th width="426">Summary</th><th>Ref #</th></tr></thead><tbody><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>Add (and sort by) labels</strong> <br>When creating a blueprint, you can now apply labels. When viewing your blueprints, a new label filter option is available.<br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FRrjk9xAjfqkNrsD16eTE%2Ficon%20page.png?alt=media&#x26;token=dab50d7c-876d-460c-a6ba-676fac0531f9" alt="" data-size="line"> <a href="../../blueprints/blueprints-introduction">Blueprints</a></td><td>CPT-4498</td></tr><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td><strong>Cross-reference lookup duplication</strong> <br>Fixed an issue where cross-reference lookups could be duplicated when a blueprint was installed. <br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FRrjk9xAjfqkNrsD16eTE%2Ficon%20page.png?alt=media&#x26;token=dab50d7c-876d-460c-a6ba-676fac0531f9" alt="" data-size="line"> <a href="../../blueprints/blueprints-introduction">Blueprints</a></td><td>CPT-4730</td></tr></tbody></table>

## Multi-company profiles

<table><thead><tr><th width="180">Type<select><option value="edbc33cea7f34e16b3a205c7a65c3172" label="New" color="blue"></option><option value="d8457d8925c74fab90fa132d141b764b" label="Change" color="blue"></option><option value="030babd6286a4fe19214da74af9afb98" label="Enhancement" color="blue"></option><option value="9a29ee576f43448f9b1623baca59c3db" label="Bug" color="blue"></option><option value="L09Gy6z2y7VD" label="Breaking change" color="blue"></option></select></th><th width="426">Summary</th><th>Ref #</th></tr></thead><tbody><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td><strong>Company insights</strong> <br>Fixed an issue where totals were displayed incorrectly for managed companies. <br><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FRrjk9xAjfqkNrsD16eTE%2Ficon%20page.png?alt=media&#x26;token=dab50d7c-876d-460c-a6ba-676fac0531f9" alt="" data-size="line"> <a href="../../company-management/company-insights">Company insights</a></td><td>CPT-4555</td></tr></tbody></table>
