To import content from GatherContent, the content editor needs to setup mappings between Templates in GatherContent and templates in Sitecore and their corresponding fields. Follow these steps to map your templates.

Click the Mappings button on the GatherContent ribbon

The manage template mappings screen will appear.

Click Add Mappings button

Clicking on the Add Mapping 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 Sitecore where imported Items will be stored. The field is also used on multilocation import dialog to pre-fill the locations pickers.

Select GatherContent project and template and corresponding Sitecore template

Specify the GatherContent project and Template you want to map and choose the corresponding Sitecore template (only templates that are stored under Templates Root Folder will be visible there).

Map GatherContent fields to Sitecore fields

Once you've completed the previous steps, all tabs and fields will be dynamically populated. The user can now map GatherContent fields to Sitecore fields. The Content Editor can map the required fields by selecting a Sitecore 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 Sitecore.

Please note that the right-side dropdown displays all fields from the selected Sitecore 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 Sitecore field. The content of such fields will be concatenated and placed in the Sitecore field.

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

GatherContent field type
Text
Sitecore field type
Single-Line Text, Multi-Line Text, Rich Text, Date, DateTime
Comment
Field content will be copied as it is 

GatherContent field type
Guidelines
Sitecore field type
Single-Line Text, Multi-Line Text, Rich Text, Date, DateTime
Comment
Field content will be copied as it is 

GatherContent field type
Checkboxes
Sitecore field type
Checklist, Multilist, Multilist with Search, Treelist
Comment
System will map selected items in GatherContent field to items specified in Sitecore field DataSource. 

GatherContent field type
Radio Buttons
Sitecore field type
Checklist, Multilist, Multilist with Search, Treelist, TreelistEx
Comment
System will map selected items in GatherContent field to items specified in Sitecore field DataSource. 

GatherContent field type
Attachment
Sitecore field type
Image, File, Droptree, Multilist, Multilist with Search, Treelist, TreelistEx
Comment
All attachments will be placed in the following node structure in Sitecore/media library/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 Sitecore Image or File or Droptree field, only first image/file will be downloaded from GatherContent and will be selected in Sitecore.
In case of mapping Attachment field to Sitecore fields allowing multiple selection (Multilist, Multilist with Search, Treelist, TreelistEx), all attachments/files will be downloaded and will be selected in the corresponding field

Save Mappings ConfigurationAfter 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?