Creating your Feed

Each field is fairly self-explanatory, but any additional information is provided below.

Name #

Feedme Setup 1

Setup a name for you feed, so you can easily keep track of what you're importing.

Feed URL #

Feedme Setup 2

Provide the URL for your feed. This can be an absolute URL, relative (to the web root) and use any environmentVariables you have in your general.php config.

Feed Type #

Feedme Setup 3

Its important to set the Feed Type to match the type of data you're importing. While its optional to pick RSS or ATOM, you'll find that choosing these options will pre-set the Primary Element field below.

Primary Element #

Feedme Setup 4
<?xml version="1.0" encoding="UTF-8"?>
<rss>
    <channel>
        <item>
            <title>My Title</title>
            <slug>my-title</slug>
        </item>

        <item>
            <title>Another Title</title>
            <slug>another-title</slug>
        </item>
    </channel>
</rss>
{
    "channel": {
        "item": [
            {
                "title": "My Title",
                "slug": "my-title"
            },
            {
                "title": "Another Title",
                "slug": "another-title"
            }
        ]
    }
}

Your Primary Element would be item. This is the node thats repeatable, and you can usually pick it as it'll be the node thats one level above the content you want to import (title and slug in this case). In the JSON example, you'll see its a plain array, but the same applies.

Notably, the above example XML is actually an RSS feed. Selecting RSS in the Feed Type will auto-set the Primary Element to item.

Element Type #

Feedme Setup 5

Select the Element you wish to import your feed content into. For the Free version, you'll only be able to import into Entries, but Pro will allow you to select Assets, Categories, Users, Commerce Products.

Locales #

Feedme Setup 6

If you're running Craft Pro, and have Locales setup, you'll have an additional field to select which Locale to import into. Only the selected Locale will have content imported, leaving all others untouched.

Import Strategy #

Feedme Setup 7

The Import Strategy tells Feed Me how to act when (or if) it comes across elements that are similar to what you're importing. If you've imported your content once, there will very likely be elements with the same title or content as what you're trying to import.

For example - you have an existing entry called "About Us", but you also have an item in your feed with exactly the same title. You should tell Feed Me what to do when it comes to processing this entry in your feed. Do you want to update that same entry, or add a new one?

You can select from any combination of the following:

Create new elements

Adds new elements if they do not already exist. If an element does exist, it simply skips over it, leaving it unchanged.

Update existing elements

Updates elements that match the Unique Identifier (next step). If no existing element to update, it won't create it unless you select Create new elements.

Delete old elements

Deletes elements that are not updated by this feed. Be careful when deleting.

Passkey #

Feedme Setup 8

A generated, unique string to increase security against imports being run inadvertently. This is mainly used when triggering an import via the direct feed link.

Backup #

Feedme Setup 9

Enable a backup of your database to be taken on each import. Please note the performance implications when switching this on.


With your fields populated, you should have a final result similar to the below screenshot.

Feedme Setup

Click on the Save & Continue button to be taken to the Field Mapping screen, or press Save to continue editing this screen.


Get started with Feed Me

Available for Craft 2 & Craft 3, with Free and Pro versions.