Skip to main content
Connect your Contentful CMS
Victor De Blander avatar
Written by Victor De Blander
Updated this week

Want to connect StoryChief to your Contentful website? Great! Follow this article to get it set up.
​
πŸš€ With StoryChief, you can collaborate with colleagues to create content-rich articles that boost the reach and awareness of your company or blog.

πŸ”” Note: Make sure you have created a content type for articles in your Contentful CMS: help article.


Start connecting your Contentful CMS

Step 1. Head to your Contentful account.

Step 2. Navigate to the settings and next to the CMA tokens.

Step 3. Add a new personal access token. Mind that you either need to set the expiration date to "No expiration" or that you might need to create a new token if you do use an expiration date.

Step 4. Copy the token

Step 5. Go to StoryChief, to your Channels (in the menu top-right) and click on Contentful CMS. Here, add a Contentful channel through "Add new destination". πŸ‘‰ Quick link.

Step 6. Paste the Access token in the access token field then click "Authenticate".

If the authorization succeeded, you should now be able to set up your connection settings.

Step 7. Select the space you want to connect to.

Step 8. Select the environment.

Step 9. Select the content type (known as content model in Contentful).

Step 10. Set your frontend domain URL for the content type you selected in the previous step:

( Ex: if your content type is blog your frontend URL might look something like this:

Step 11. You can now start mapping your StoryChief fields to your Contentful fields.

Field mappings:

Here is a list of the field types in StoryChief and which field types they can map to in Contentful:

StoryChief field

StoryChief field type

Contentful allowed field types

Comments

Article -> title

Text

Symbol, Text

Article -> body

RichText

RichText, Object

Article -> excerpt

LongText

Text

Article -> slug

Text

Symbol, Text

Article -> image

Image

Link (Asset)

Article -> seo title

Text

Symbol, Text

Article -> seo description

LongText

Text

Article -> Canonical URL

Text

Text, Symbol

Article -> published at

Date

Text, Date

Article -> updated at

Date

Text, Date, Integer

Article -> Tags

Array

Text, Symbol

As array or as comma separated list depending on the Contetnful field configuration

Article -> Categories

Array

Text, Symbol

As array or as comma separated list depending on the Contetnful field configuration

Author -> full name

Text

Text

Author -> e-mail

Email

Text

Author -> bio

LongText

Text

Author -> picture

Image

Link (Asset)

True/False

Boolean

Boolean

Custom field

Select, Radio, Checkbox

Link (Asset/Entry) Text

Custom field

File, Image

Link (Asset)

Custom field

Text

Text, Symbol, Integer,

Custom field

E-mail

Text, Symbol

Custom field

LargeText (Textarea)

RichText, Object, Text

Choose the Rich text option in StoryChief to map to RichText field in Contentful

Custom field

Date

Date, Integer

Entity references

❓How to set up an entity reference field.

Step 1. Get the content model machine name from Contentful.

Step 2. Create a custom field in StoryChief (field type = Auto-complete ) and make it available on articles.

Limitations:

  1. Contentful location field type is not supported.

  2. StoryChief gallery and embeds are sent as links to Contentful richText field with an extra custom property containing the embed HTML and the StoryChief block type. It's up to your frontend team to render them as needed on the frontend app.


πŸ“š Next steps

Did this answer your question?