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 stories that boost the reach and awareness of your company or blog.

🔔 Note: Make sure you have created a content type for stories 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:

https://mysite.com/blogs )

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 Story Chief and which field types they can map to in Contentful:

🔔 Note: Please note that this list is very generic, the mapping might sometimes not work; depending on your Contentful field settings. Please reach out to our support team if you have any issues.

StoryChief field	StoryChief field type	Contentful allowed field types	Comments
Story -> title	Text	Symbol, Text
Story -> body	RichText	RichText, Object
Story -> excerpt	LongText	Text
Story -> slug	Text	Symbol, Text
Story -> image	Image	Link (Asset)
Story -> seo title	Text	Symbol, Text
Story -> seo description	LongText	Text
Story -> Canonical URL	Text	Text, Symbol
Story -> published at	Date	Text, Date
Story -> updated at	Date	Text, Date, Integer
Story -> Tags	Array	Text, Symbol	As array or as comma separated list depending on the Contetnful field configuration
Story -> 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 stories.

Step 3. Contact StoryChief support to configure the rest for you. Open a chat with our support via the chat logo at the bottom-right.

Limitations:

Contentful location field type is not supported.
Story Chief gallery and embeds are sent as links to Contentful richText field with an extra custom property containing the embed HTML and the story Chief block type. It's up to your frontend team to render them as needed on the frontend app. An example of how to render galleries and embeds in your frontend can be found in this repository

Start connecting your Contentful CMS

Field mappings:

Entity references

Limitations:

📚 Next steps