Umbraco Integration: Mapping Setup
You'll need to set up mappings between your structure in GatherContent and templates in Umbraco before you can import content.
Bruno Wilson avatar
Written by Bruno Wilson
Updated over a week ago

To import content from GatherContent, you'll need to set up mappings between Templates in GatherContent and templates in Umbraco and their corresponding fields. Follow these steps to map your templates:

Click the Mappings button on the GatherContent menu

The manage template mappings screen will appear.

Click Add Mappings button

Clicking on the "Add Mappings" button will bring up the Field Mappings dialog. The Field Mappings dialog lets the user specify which templates and fields should be mapped.

Specify mapping name

First, users should specify a name for the mapping. The mapping name will be used to distinguish mappings on import dialogs.

Set default location

Next, the default location field can be set (optional). This helps specify the default location (node) in Umbraco where imported Items will be stored. The field is also used on the multilocation import dialog to pre-fill the locations pickers.

Select GatherContent project and template and corresponding Umbraco template

Specify the GatherContent project and Template you want to map and choose the corresponding Umbraco template.

Map GatherContent fields to Umbraco fields

Please note: The connector doesn't support the Umbraco Grid Editor.

Once you’ve completed the previous steps, all tabs and fields will be dynamically populated. The user can now map GatherContent fields to Umbraco fields. The Content Editor can map the required fields by selecting a Umbraco field in the corresponding dropdown on the right-hand side of the screen.

Only fields that are possible to map are displayed in the dropdowns. For example, it is not possible to map a text field from GatherContent to an image field in Umbraco.

Please note that the right-side dropdown displays all fields from the selected Umbraco template, along with fields from all base templates, which the current template inherits.

The plug-in supports many-to-one field mappings for text and guidelines field types. This means, that it is possible to map, for example, two GatherContent fields into one Umbraco field. The content of such fields will be concatenated and placed in the Umbraco field.

Please check the mappings table that shows all the supported field mappings:

GatherContent field type
Text
Umbraco field type
Textbox, Text Area, Rich text editor, Date Picker
Comment
Field content will be copied as it isis. Import Date format will be used to convert dates form text to date.

GatherContent field type
Guidelines
Umbraco field type
Textbox, Text Area, Rich text editoreditor, Date Picker
Comment
Field content will be copied as it isis. Import Date format will be used to convert dates form text to date.

GatherContent field type
Checkboxes
Umbraco field type
DropDown
Comment
Multiple List System will map selected items in the GatherContent field to items specified in Umbraco field DataSource.

GatherContent field type
Radio Buttons
Umbraco field type
Drop Down, Check Box List, Radio Button List, Dropdown list
Comment
Publishing Keys System will map selected items in the GatherContent field to items specified in Umbraco field DataSource.

GatherContent field type
Attachment
Umbraco field type
Legacy MediaPicker, MediaPicker
Comment
All attachments will be placed Media Library in the following node structure in Umbraco/GatherContent///IfUmbraco/GatherContent/If a field has a datasource set, all importing files will be uploaded to the location specified in datasource.If Attachment field is mapped to Umbraco Legacy MediaPicker field, only first image/file will be downloaded from GatherContent and will be selected in Umbraco.In case of mapping Attachment field to Umbraco fields allowing multiple selection (MediaPicker), all attachments/files will be downloaded and will be selected in the corresponding field

Save Mappings Configuration

After all mapping criteria are set, click the "Save Mapping Configuration" button. The saved mappings can be edited or deleted at any point.

Did this answer your question?