--- title: "Mapp Connect: Import Configuration" slug: "mapp-connect-import-configuration" description: "Reference for Mapp Connect import jobs in Mapp Engage: schedule, FTP or HTTP source, file handling, processing steps, and error log recipients." status: "update" updated: 2026-11-17T17:03:39Z published: 2026-11-17T17:03:39Z canonical: "docs.mapp.com/mapp-connect-import-configuration" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.mapp.com/llms.txt > Use this file to discover all available pages before exploring further. # Mapp Connect: Import Configuration ## Overview The Import Configuration interface defines how external data files are imported into Mapp Engage. It controls the import schedule, data source, file handling, processing steps, and monitoring options to ensure imported data is processed correctly and consistently. --- ## Navigation Path 1. Go to *Data Management > Mapp Connect*. 2. Click **Add New Integration**, or click **Edit** on an existing integration. 3. Click the **Import Configuration** tab. Alternatively, in the **Data Import** tab, click **Add New Import** or **Configure**. --- ## Settings ### Import Job Configuration ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/image-HRQOWEO2.png) | Setting | Description | | --- | --- | | **Job name** | Defines the unique name of the import job. Each import job must have a distinct name. | | **Runs every** | Defines the schedule for the import job, including start date and execution frequency. | | **Job status** | Controls whether the import job is active. Set to **Enabled** only after all incoming data columns are fully mapped. | --- ### Import Source | ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/image-AEM5YXB8.png) | ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/image-6WPJM8XX.png) | | --- | --- | | Setting / Action | Description | | --- | --- | | **Import from** | Selects the data source type: **FTP/SFTP** or **HTTP**. | | **Connection (drop-down)** | Selects a predefined connection used to access the import files. | | **Test Connection** | Validates the selected connection. An alert is shown if the test fails. | | **File path** | Defines the file path for HTTP imports if it was not specified during credential setup. | | **File (wildcard)** | Allows importing multiple files that match a wildcard pattern. Only the “*” wildcard is supported. | | **Import only today’s files** | Limits the import to files created on the current day. | | **Backup input file** | Creates a backup copy of the imported file before processing. | --- ### File Handling (Optional Steps) ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/image-385SXG7T.png) | Setting | Description | | --- | --- | | **Unarchive file** | Extracts archived files before processing. Supported formats are `.zip`, `.tar`, and `.gz`. Password-protected archives are supported for `.zip` files only. | | **Convert file** | Defines the file delimiter and encoding before processing. All imported files must use the same encoding and delimiter. | > [!NOTE] > Note > > If multiple files are imported in one job, encoding and delimiter settings must be identical for all files. --- ### Data Processing ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/image-0LHXLLNG.png) | Setting | Description | | --- | --- | | **Upload to S3** | Uploads the processed file to Mapp’s S3 server. This step is automatic and cannot be configured. | | **Create Event** | Defines how imported data is handled in Mapp Engage, including adding users to groups, sending messages, and updating related data tables. | | **Process** | Generates an import report summarizing the execution and processing results. | | **Update Mapping** | Opens the mapping configuration to align source file columns with target data fields in Mapp Engage. | --- ### Monitoring ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/image-ZKQPX1RM.png) | Setting | Description | | --- | --- | | **Send error logs to** | Defines recipients who receive error logs when an import job fails. | --- ## Actions | Action | Description | | --- | --- | | **Run once** | Executes the import job once without changing the configured schedule. | | **Copy** | Creates a duplicate of the selected import job, including its configuration and settings. | | **Remove** | Deletes the selected import job. | | **Save** | Stores the import configuration and settings. | --- ## Additional Information - One import job can process multiple files if they match the same wildcard pattern and data type. - Supported data types include users, transactions, wishlists, abandoned carts, location data, and related tables. - A CSV column named `skipUnsubscribers` can be included to prevent re-adding unsubscribed contacts when set to “TRUE”. - Import jobs should remain **Disabled** until all mappings are verified to avoid processing errors. ## Related - [Set Up Data Imports](/set-up-data-imports.md)