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:
🔔 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 |
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 | 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 | Text, Symbol |
| |
Custom field | LargeText (Textarea) | RichText, Object, Text | Choose the |
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.
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
locationfield type is not supported.StoryChief gallery and embeds are sent as links to Contentful
richTextfield with an extracustom propertycontaining the embed HTML and the StoryChief block type. It's up to your frontend team to render them as needed on the frontend app.