> ## Documentation Index
> Fetch the complete documentation index at: https://docs.get3rd.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Contentful

> Send Content Agent articles into your Contentful space as draft entries, per brand. 3RD never publishes.

Connect Contentful and the [Content Agent](https://docs.get3rd.com/actions/content-agent.md) can send a finished article straight into your Contentful space as a **draft entry**. Your team reviews the draft in Contentful and publishes it there.

## Before you start

* Your organization needs an **active 3RD subscription** with the Content Agent.
* You need **edit access** to the brand in 3RD. View-only members don't see the **Connect** button.
* You connect **per brand**. Each brand links its own Contentful space.
* You connect by signing in to Contentful. There's no key to paste.
* The content type you choose needs a short text field for the title, a short text field for the slug, and a Rich Text or long text field for the body.

## Connect Contentful

**1. Open Integrations**

In 3RD, open **Brand → Integrations** for the brand. Contentful is listed under **Publishing**.

**2. Click Connect**

In the **Contentful** row, click **Connect**. Contentful opens so you can sign in.

**3. Choose where pieces go**

Back in 3RD, the **Where pieces go** window opens. Pick the **Space**, **Environment**, **Content type**, and **Locale**. The environment defaults to **master**. Map the fields and click **Save**.

## Choose where pieces go

3RD fills these fields on each new entry:

| In Contentful | From 3RD |
| - | - |
| **Title** (short text) | The piece title |
| **Slug** (short text) | The address you set when pushing |
| **Body** (Rich Text or long text) | The article, as Rich Text or Markdown |
| **Summary** (optional) | The article's first paragraph |
| **Cover image** (optional) | The article's first image |

To change the space, environment, content type, locale, or fields later, open the **⋯** menu in the Contentful row and click **Choose where pieces go**.

## Push an article to Contentful

**1. Open the article**

In the Content Agent, open a new article (not an optimization of an existing page).

**2. Send it as a draft**

Click **Push to Contentful**. If the brand has more than one CMS connected, the button says **Push to CMS** and you pick **Contentful** in the window. Check the address and click **Send as draft**. 3RD shows **Draft created in Contentful** when it's done.

**3. Review it in Contentful**

Open the entry in Contentful. It's a draft. Publish it there when you're ready.

## Drafts only

3RD only ever saves **drafts**. It never publishes, archives or deletes.

Once an entry is published in Contentful, 3RD refuses to change it. Edit that entry in Contentful.

## Disconnect

Open the **⋯** menu in the Contentful row and click **Disconnect**. 3RD stops sending anything to Contentful and deletes its stored access. Entries already in Contentful stay where they are.

## Troubleshooting

| You see | What to do |
| - | - |
| A message that the entry was already published | Edit the entry in Contentful. 3RD doesn't change published entries. |

## Related

* [Content Agent](https://docs.get3rd.com/actions/content-agent.md): where the articles are written
* [HubSpot](https://docs.get3rd.com/integrations/hubspot.md): the same flow for HubSpot blogs and pages


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.