Contentful AI Content Generator App Guide

Contentful AI Content Generator uses a third party AI tool to make your content creation process faster than ever! With AI Content Generator, you can generate content that matches your brand, reduce repetitive tasks like generating SEO keywords, and even translate content to nearly 100 languages. 

Overview

Once installed, the AI Content Generator app can be added to sidebars across Content Types. The sidebar app allows you to use third-party AI to undertake operations on your content. You can also provide details around your brand and voice that the AI will use to create more targeted and effective content. This app requires your own or your company's OpenAI API key, and supports both free and paid keys. The app also shares some known limitations in ChatGPT, specifically the inability of that application to (currently) provide responses with a set character length. You may need to edit the response to fit length requirements. Depending on your ChatGPT subscription, you may also experience brief downtime or outages if their service is overloaded. You can find details about uptime status here.

Users are solely responsible for ensuring that AI-generated content complies with applicable laws, their company’s policies, and OpenAI's Terms and Policies.

Requirements

To use this app, you will need:

• A free or paid OpenAI API key

Usage

Step 1: Configuring the app

The app requires a free or paid OpenAI API key. This key can be generated by signing up for OpenAI and copying your API key (found here).

Paste this API key into the app configuration screen and press Install to install the app.

Once the app is installed, you can configure its other settings.

Step 2: Selecting an OpenAI model

Once you provide a profile, you will need to select the third-party AI model that you want to use. Currently, OpenAI’s GPT-3.5 and GPT-4 models are available. Generally, GPT-4 is a more performant and accurate model, but does cost more to use than GPT-3.5. You can learn more about available models and versions here.

Step 3: Configuring your brand's profile

Providing a detailed profile about your brand can produce far more accurate and on-brand results from AI Content Generator. Limited brand details tend to lead to generic, robotic content. Specific and detailed brand profiles tailor the response to your unique brand, voice, and tone.

Your brand's profile can be configured on the app configuration page. Providing the brand profile is not required, but is strongly recommended.

The brand profile consists of several fields:

• Describe your brand or product - provide a brief overview of your brand and products. This should include who you are and what you sell/promote. For example, a sustainable t-shirt company would describe their brand name, the t-shirts they sell, characteristics of those t-shirts (for example, organic cotton), as well as their market.

• What are your brand's values and attributes? - describe the core values and attributes of your brand. For example, your brand may value the environment, sustainability, and reducing environmental impact.

• Describe your brand's voice and tone - describe the style, tone, and voice of content your brand generally creates. For example, a brand that focuses on a younger audience may use a witty, casual, and hip tone and voice, while a brand focused on academic topics may choose a professional, serious, and concise tone and voice.

• Are there any words your brand should never use? - provide a comma separated list of words that your brand never uses. For example, a luxury brand may want to avoid words like "expensive" or "budget" in their content.

• Are there any words your brand should commonly use? - provide a comma separated list of words commonly used by your brand. For example, a brand focused on sustainable clothing may frequently use the word "eco-aware."

• Describe your brand's target audience - the specific audience your brand is targeting. For example, college educated 18-24 year olds in the United States

• Is there anything else that AI should know about your brand or product? - any additional context around your brand not captured in other fields. For example, you may use this section to describe sub-brands or the products you sell in detail.

Step 4: Adding to content types

Lastly, you can add AI Content Generator to the sidebar of any or all of your content types

Select the top option to apply AI Content Generator to all content types, or individually select each content type where you want the app to show.

Press save to configure the app.

Note that the app requires certain fields and locales to enable each action. 

• Generate title - a short text title field

• Generate content - a rich text field

• Translate content - no field requirements; must have more than one locale enabled and the field must be enabled for localization

• Rewrite - no field requirements

• Generate SEO description - a rich text field

• Generate SEO keyword - a rich text field

Step 5: Using the app

Once the app is added to a sidebar, you can use it in any content that you create or edit with the selected content type. Just click into an entry and the app will appear where you positioned it on the sidebar.

Each option available in AI Content Generator is shown on the sidebar.

AI Generated Content Updates

AI Content Generator now features more controls to help you decide when and how AI generated content is applied to your entries. Now, every time you make a request to AI Content Generator, we use your brand profile to create more accurate and on-brand responses. We do this automatically when you generate, rewrite, or translate content.

Results also now stream live from OpenAI, instantly showing you the generated content and reducing the time it takes to generate content. Pressing "Stop Generating" will stop streaming content if the results aren't what you expect. You can directly edit this content by clicking in the text box. The generated content can also be copied out to your clipboard on demand. Finally, we've updated the app to give you the ability to choose if/when AI generated content is applied to a field. If you do not press the "Apply" button, AI content will not overwrite a field.

AI Content Generator Options

Generate title

The Generate title option allows you to create a title for a page or blog post either using the content of another field or from a prompt.

Generate from another field - if selected, you can choose which field to use as input and which to place the output. This feature is useful if you already have body content, but want to use AI to generate a creative title. To use this option, select any field for the Input and select your Title field for the output.

Generate from prompt - this is an advanced feature that allows you to generate a title using a prompt you write. Effective prompts generally describe exactly what you want generated, such as "write a funny title about always losing your sunglasses."

Generate content

The Generate content option allows you to generate more verbose content into a text field. This option is most often used to create descriptive copy or generate the outlines of a blog post.

Generate from another field - if selected, you can choose which field to use as input and which to place the output. This feature is useful if you already have a title, but want to use AI to generate content. To use this option, select any field for the Input and select a text field for the output.

Generate from prompt - this is an advanced feature that allows you to generate content using a provided prompt. Effective prompts generally describe exactly what you want generated, such as "write a short blog post about sustainable t-shirts."

Language translation

AI Content Generator can translate to over 100 different languages. Like other operations, it can translate one field to another language, or allow you to write a prompt to translate a specific piece of content.

Generate from another field - if selected, you can choose which field to use as input and which to place the output. Generally, this is used to translate a piece of content in one locale to the same field in another locale. For example, you may have an English title that needs to be translated to German.

Generate from prompt - this is an advanced feature that allows you to translate content following a specific prompt. This feature is most often used if you are translating a piece of content not yet stored in Contentful.

Rewrite - New!

Rewrite is a new capability in AI Content Generator that allows you to use AI to rewrite content on demand! Rewriting is extremely useful, empowering you to use AI to change content length, voice, or tone.

Rewrite allows you to select from a number of default options, including Shorter, Casual, or Witty. Or, live out your fantasy dreams and rewrite content in the style of Tolkien! You can also provide your own list of comma separated requirements. For example, you may want to select Shorter and also add "professional" to the list of requirements.

Generate from another field - if selected, you can choose which field to use as input and which to place the output. Generally, the same field is selected as the input and the output, so that you can rewrite a specific field.

Generate from prompt - this is an advanced feature that allows you to rewrite content following a specific prompt. You may already have rewrite prompts or requirements in your company that can be used here instead of default prompts.

SEO keywords

The SEO description option allows you to use AI to generate SEO optimized keywords using other content on your entry. This can help reduce repetitive work and save time when creating content.

Generate from another field - if selected, you can choose which field to use as input and which to place the output. Generally, you would select a body field for as the input, and a text field for the output.

Generate from prompt - this is an advanced feature that allows you to generate SEO keywords content following a specific prompt. You may already have SEO prompts or requirements in your company that can be used here instead of default prompts.

SEO description

This option allows you to use AI to generate SEO optimized descriptions using other content on your entry. This can help reduce repetitive work and save time when creating content.

Generate from another field - if selected, you can choose which field to use as input and which to place the output. Generally, you would select a body field for as the input, and a text field for the output.

Generate from prompt - this is an advanced feature that allows you to generate SEO description content following a specific prompt. You may already have SEO prompts or requirements in your company that can be used here instead of default prompts.

For an in-depth walkthrough on optimizing SEO with Contentful, please refer to this guide.

FAQ and Troubleshooting

I see an error when requesting content or translations

There are many reasons why you may receive an error when using AI Content Generator. Some common reasons include:

1. OpenAI Trial Expired - your OpenAI trial is expired and you need to either purchase additional credits, provide an API key from a new account, or purchase an additional license.

2. Try again later - the OpenAI service is overloaded and you will need to wait until later to use it. Alternatively, purchasing an OpenAI subscription can provide priority access when the system is overloaded.

3. Field character limits - the response is too long for the field you have selected and will need to be edited down before you can publish.