Importer 2.x

Legacy documentation for Importer 2.x.

Importer includes third party add-on support for the following field types when importing into Channel Entries:

Solspace Tag 4+

Importer allows you to create import profiles that can map data into a Solspace Tag field. This requires that you have Solspace Tag 4+ installed and a Tag fieldtype field already created. You can then choose from a variety of delimiters, depending on how your Tag data is formatted: colon, comma, doublepipe, newline, semicolon, space, tab, tilde. You can also set a default tag or set of tags to be applied to each entry.

click to enlarge

Pixel & Tonic Playa 4.2+

Importer allows you to create import profiles that can map data into Playa fields. This requires that you have Pixel & Tonic Playa 4.2+ installed. The Playa fieldtype can have data as a list of entry IDs separated by a comma or pipe (|), or as stored in the EE database with an entry ID, title, and URL title (ex: [###] Entry Title - entry_url_title) and multiple entries separated by a line break.

CSV

"" // no entries
"1,2" // entry ID's 1 and 2
"2|5|8" // entry ID's 2, 5, and 8

XML

<playa_field_name></playa_field_name> // no entries
<playa_field_name>1,2,3</playa_field_name> // entry ID's 1, 2, and 3
<playa_field_name>2|5|8</playa_field_name> // entry ID's 2, 5, and 8
<playa_field_name>
    <entry_id>1</entry_id>
    <entry_id>2</entry_id>
    <entry_id>3</entry_id>
</playa_field_name>

JSON

"playa_field_name":[] // no entries
"playa_field_name":["1","2"] // entry ID's 1 and 2
"playa_field_name":"1,2,3" // entry ID's 1, 2, and 3
"playa_field_name":"2|5|8" // entry ID's 2, 5, and 8

click to enlarge

Pixel & Tonic Matrix 2.3+

Importer allows you to create import profiles that can map data into Matrix fields. This requires that you have Pixel & Tonic Matrix 2.3+ installed. Importer supports the following Matrix Field Types: Date, Playa, Text, and Wygwam. You can choose from a variety of formats for your data:

CSV

"One","Two","Three"

XML

<matrix_field>
    <matrix_cell_1>One</matrix_cell_1>
    <matrix_cell_2>Two</matrix_cell_2>
</matrix_field>

<matrix_cell_1>One</matrix_cell_1>
<matrix_cell_2>Two</matrix_cell_2>
<matrix_cell_3>Three</matrix_cell_3>

<matrix_field>
    <matrix_entry>
        <cell_one>The Bird is the word</cell_one>
        <cell_two>1332650167</cell_two>
        <cell_three>1|2</cell_three>
    </matrix_entry>
    <matrix_entry>
        <cell_one>Have you not heard?</cell_one>
        <cell_two>2011-02-28 10:28 AM</cell_two>
        <cell_three>4,6</cell_three>
    </matrix_entry>
</matrix_field>

JSON

"matrix_field": [
    {"cell_one":"The Bird is the word","cell_two":"1332650167", "cell_three":"[1] Entry Title A entry_title_a\r\n[2] Entry Title B entry_title_b"},
    {"cell_one":"Have you not heard?","cell_two":"2011-02-28 10:28 AM", "cell_three":"2,1"}
]

"matrix2": {
    "cell_1":"The Bird is the word",
    "cell_2":"2011-02-28 10:28 AM",
    "cell_3":"[1] Entry Title A entry_title_a\r\n[2] Entry Title B entry_title_b"
}

"matrix3_cell_1":"The Bird is the word",
"matrix3_cell_2":"2012-02-28 10:28 AM",
"matrix3_cell_3":"[1] Entry Title A entry_title_a\r\n[2] Entry Title B entry_title_b",

click to enlarge