Field Types

Feed Me supports all native Craft Fields, and even some third-party ones.

Assets

Accepts single or multiple values. You should supply the filename only, excluding the full path to the asset, but including the filename. If you're uploading remote assets, you'll need to produce fully-qualified URLs.

Additional Options

  • Upload remote asset (choose how to handle existing assets - Replace/Keep/Ignore)
  • Inner-element fields
<Asset>my_filename.jpg</Asset>

// Or
<Assets>
    <Asset>my_filename.jpg</Asset>
    <Asset>my_other_filename.jpg</Asset>
</Assets>

//
// When selecting upload
//
<Asset>http://mydomain.com/my_filename.jpg</Asset>

// Or
<Assets>
    <Asset>http://mydomain.com/my_filename.jpg</Asset>
    <Asset>http://mydomain.com/my_other_filename.jpg</Asset>
</Assets>

Categories

Accepts single or multiple values.

Additional Options

<Category>My Category</Category>

// Or
<Categories>
    <Category>My Category</Category>
    <Category>Another Category</Category>
</Categories>

Checkboxes

Accepts single or multiple values. You must provide the Value of the option to check, not the Label.

<Checkbox>option1</Checkbox>

// Or
<Checkboxes>
    <Option>option1</Option>
    <Option>option2</Option>
</Checkboxes>

Color

Accepts a single valid Colour value - usually in Hexadecimal.

<Color>#ffffff</Color>

Date/Time

Accepts a single valid date and time string. Supports many different formats, using PHP's date_parse function.

<Date>Tue, 24 Feb 2015 09:00:53 +0000</Date>
<Date>2015-02-24 09:00:53</Date>
<Date>02/24/2015</Date>

Accepts a single value. You must provide the Value of the option to select, not the Label.

<Dropdown>option2</Dropdown>

Entries

Accepts single or multiple values.

Additional Options

<Entry>My Entry</Entry>

// Or
<Entries>
    <Entry>My Entry</Entry>
    <Entry>Another Entry</Entry>
</Entries>

Lightswitch

Accepts a single value. Can be provided as any boolean-like string.

// 1/0
<Lightswitch>1</Lightswitch>

// true/false
<Lightswitch>true</Lightswitch>

// Yes/No
<Lightswitch>Yes</Lightswitch>

Matrix

Check out Importing into Matrix for a more comprehensive guide.

Multi-select

Accepts single or multiple values. You must provide the Value of the option to select, not the Label.

<MultiSelect>option1</MultiSelect>

// Or
<MultiSelects>
    <MultiSelect>option1</MultiSelect>
    <MultiSelect>option2</MultiSelect>
</MultiSelects>

Number

Accepts a single value.

<Number>10</Number>

Plain Text

Accepts a single value.

<PlainText>Lorem ipsum dolor sit amet</PlainText>

Position Select

Accepts a single or multiple values. Should provide from the below options:

  • left
  • center
  • right
  • full
  • drop-left
  • drop-right
<Position>right</Position>

// Or
<Positions>
    <Position>left</Position>
    <Position>right</Position>
</Positions>

Radio Buttons

Accepts a single value. You must provide the Value of the option to select, not the Label.

<Radio>option2</Radio>

Rich Text

Accepts a single value. Be sure to escape your content properly if it contains HTML.

<RichText><![CDATA[<p>Lorem ipsum dolor sit amet.</p>]]></RichText>

Table

Each Table field row has multiple columns, so you map each field value to a column, rather than the entire Table field. You also group your columns into rows, as shown below.

<Table>
    <Row>
        <ColumnOne>Content</ColumnOne>
        <ColumnTwo>For</ColumnTwo>
    </Row>

    <Row>
        <ColumnOne>Table</ColumnOne>
        <ColumnTwo>Field</ColumnTwo>
    </Row>
</Table>

Tags

Accepts single or multiple values.

Additional Options

<Tag>My Tag</Tag>

// Or
<Tags>
    <Tag>First Tag</Tag>
    <Tag>Second Tag</Tag>
</Tags>

Users

Accepts single or multiple values.

Additional Options

<User>123@nothing.com</User>

// Or
<Users>
    <User>123@nothing.com</User>
    <User>123@something.com</User>
</Users>

Third Party

The following third-party fields are supported.

Element Attributes

For element fields (Assets, Categories, Entries, Tags and Users), you'll want to check against any existing elements. Feed Me gives you the flexibility to choose how to match against existing elements. These will depend on what element it is, but will often be slug or title.

What this means in practical terms, is that your feed data can provide the ID, Title or Slug of an Entry - or the ID, Username, Name or Email for a User, and so on.

For instance, look at the following example feed data we want to import into a Categories field:

// Title provided
<Category>My Category</Category>

// Slug provided
<Category>my-category</Category>

// ID provided
<Category>23</Category>

Depending on what data your feed contains, you'll need to select the appropriate attribute, to tell Feed Me how to deal with your data.

Inner Element Fields

As each Element (Assets, Categories, Entries, Tags, Users) can have custom fields themselves, Feed Me gives you the chance to map to those fields as well. They'll appear under any row when mapping to an Element field.