Introduction
Importing Content
In this resource we'll walk through importing content into Agility using posts as an example. We'll assume you have a model created already. If not, we recommend checking out
Downloading Your Content in Excel
To start we can export a list of content from an existing Content List as an Excel sheet that we can then add to and import back into Agility.
To do this
1. From your Content List, click the Menu Indicator on the right-hand side followed by the Export option.
2. For this example we'll choose Regular format and then click Export again.
When it's finished, you can download the file that's provided to you and open it up. Once it's open, we'll be able to edit the fields in the Post and Category sheets:
Post
Category
Note
if you would like to import this as New Content as opposed to overriding the test post we created, set the Agility_ContentID values to -1.
Importing Your Updates to Agility
Once this is done and you've made your updates, you can Import the Excel sheet back into Agility using the same steps but clicking Import instead:
Once imported, you should see the updates in your List
Using the Content Management SDK
Alternatively, you can use the Agility Content Management SDK which is the official JavaScript library for inserting, updating, managing, and importing content, pages, and media in your Agility Instance.
Content Management SDK Documentation
Further Reading
This article will walk you through a basic example of importing content into Agility CMS. For this example, we will be importing posts.
Setting Up the Content Model
To start, we'll need to create a Content Model in Agility. We can do this by going to Models > Content Models.
Let's start by creating the models for our relations first.
Author Content Model
This model will have a simple title field.
Select an Image
Be sure to initialize Content to use this model.
Select an Image
Category Content Model
This model will have a simple title field so we can reference them in our Post Content Model later.
Select an Image
Be sure to initialize Content to use this model so we can reference them in our Post Content Model later.
Select an Image
Add a sample Authors and Categories which will help set up the structure of our Excel sheet export later.
Setting up the Post Content Model
Next, let's go back into the Models area to create a Content Model for the Blog Post, this will contain a Title, Slug, Date, and Content field along with Linked Content to our Authors and Categories list.
Here's what the settings will look like for your Authors and Categories Linked Content fields:
Select an Image
And here's how the Post Content Model will look:
Select an Image
Just like the Authors and Categories list, we will need to initialize a new List for our Posts using the Post Content Model.
Select an Image
Next, add a sample Blog Post which will help set up the structure of our Excel sheet export later.
Select an Image
Once we have a sample post, we can go back to our Posts list and export our list as an Excel sheet in Regular format:
Select an Image
When it's finished, you can download the file that's provided to you and open it up. Once it's open, we'll be able to edit the fields in the Post, Author, and Category sheets:
Post
Select an Image
Author
Select an Image
Category
Select an Image
Noteif you would like to import this as New Content as opposed to overriding the test post we created, set the Agility_ContentID values to -1.
Once this is done, you can Import the Excel sheet back into Agility:
Select an Image
Once imported, you should see the post in your Posts list:
Select an Image
Import/Export Documentation
Importing Content that contains Child Content
Using the Content Management SDK
Alternatively, you can use the Agility Content Management SDK which is the official JavaScript library for inserting, updating, managing, and importing content, pages, and media in your Agility CMS instance.