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 | 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.
Limitations:
Contentful
location
field type is not supported.StoryChief gallery and embeds are sent as links to Contentful
richText
field with an extracustom 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.