Using Custom Mappings in Your Flows

Created by Brian Glick, Modified on Wed, 5 Nov at 5:17 AM by Brian Glick

Custom mappings allow you to create your own maps to convert data when Chain.io standard file types aren't available for your format.  They're great for JSON, CSV, or EDI formats from your external trading partners or legacy systems.


To use your custom mappings in your Flow Executions you need to configure your Flow to use the mappings you have created. This article explains how to set up your Flow Configuration to test your mappings.

In your Flow Configurations you will need to apply the following settings to test your mappings for use in your Flow Executions


See our Custom Mappings documentation for more detail on building the map.


To deploy a custom map as part of a flow. 


  1. Open the Custom Processors panel and select the mapping you created in the Custom Mapping tool.
  2. Select the version of the Mapping you want to use for the Input File Map.
  3. Next, select the same map and version for the Output File Map.


Now save and deploy the flow.


Remember that each flow is pinned to a version of the map, so if you update the map in the future, you need to also update the version on the flow and re-deploy.  This is done so you can work on maps without impacting your production flows and then deploy them when you're ready.

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article