Modules in a scenario are linked to each other by item mapping.
When you map an item, you use the data retrieved using a source module in the settings of another (target) module.
Values from the mapped items are then used by the module to perform the desired action.
An example – Sender: Email address (a sender's email address) and Subject (an email subject) items retrieved by the Watch email module and then mapped in the settings of the Send an email module:
Generally, an item is a piece of information retrieved by a module. Item is displayed in the module's output as a label and value. Click the bubble above the module to display the module's output .
In the following example of an item, the item's label is "Subject" and the item's value is "Welcome to Integromat!".
Follow these steps to map an item from one module to another:
1. Open settings of the target module (where you want to map items to).
2. Click the field where you want to map an item from a preceding module.
This will open a mapping panel offering all items from preceding modules in the scenario that are available for mapping. Also, sample values are usually displayed next to the item label.
3. To map an item to a field, click on the item or drag-and-drop the item to the module's input field.
When you're finished, click OK in the module's settings.
You can repeat the action (map from the module's output to another module's input fields) in other succeeding modules added to your scenario.
The number of linked modules in the scenario is not limited.
Module's output items that contain more items are called collections (contain items of a different type) or arrays (contain items of the same type). Collections are expanded in the mapping panel in order to allow user to easily map items contained in the collection. A collection itself is usually not being mapped.
For more details about mapping arrays, see the Mapping Arrays section of this article.
Example of a collection in the module's output:
Example of a collection in the module's mapping panel:
Example of an array (containing collections of the same type) in the module's output:
Example of an array (containing collections of the same type) in the module's mapping panel:
An example of a complex array is the email attachment. The Watch emails module returns an array of attachments for every email. Every attachment represents a collection that may contain a name, content, size, etc.
If you map the array's
Recipient name item, it will appear in the field like this:
The number in the square brackets is an index that determines which element of the array will be used. It is set to one by default.
If you wish to access another element, click on the square brackets and edit the index value:
Some arrays contain several collections with key and value items. These are typically various metadata, attributes, etc.
The following example shows the output of the WooCommerce > Get a product module that contains the item
Meta data, which is an array of collections. Each collection contains the key item
Meta data ID and the value item
The typical requirement is to lookup an element by its given key value and to obtain the corresponding value from the value item. This can be achieved with a formula employing a combination of the
The following example shows how to obtain the value of the
Value item of the element with key
Meta data ID item value equal to
The result of the formula will be "no".
The detailed breakdown of the formula follows:
map()function is the whole array item.
valuein contrast to the label
map() function returns an array (as there could be more elements with the given key value), it is necessary to apply the
get() function to get its first element:
get()function is the result of the
See also our Extract an item and/or its value from an array of collections video tutorial.
Arrays can be converted to a series of bundles using the Iterator module:
For each module, the mapping panel displays all output items listed by the author of the module. In some cases, this list might be incomplete for various reasons and some items might be missing. Nevertheless, Integromat can auto-discover the missing output items.
All you have to do is to execute the module in the scenario editor. The exact procedure differs slightly depending on the module's type:
You may choose to execute:
If you choose to execute just the single module then: