---
title: "Surfer x Contentful Integration"
description: "Unlock Your Content's Full Potential!"
url: https://docs.surferseo.com/en/articles/8448831-surfer-x-contentful-integration
collection: "Surfer x Contentful"
updated: 2026-11-06
language: en
alternates: [fr, de]
---

# Surfer x Contentful Integration

Unlock Your Content's Full Potential!

## **What is Contentful?**

Contentful is an intelligent Content Management System (CMS) that simplifies the creation, management, publication, and expansion of unique content experiences across various digital platforms, all within a single, comprehensive content system.

[Learn more about Contentful](https://www.contentful.com/products/)

Have you ever wondered what it's like to use Contentful powered by Surfer's solutions? If so, let's dive into this powerful integration.

## **How does the integration work, and what is required?**

Our integration, will allow you to work directly within your CMS while giving you real-time SEO guidelines, such as keyword density, length and content structure using our Content Editor guidelines.

💡 **To use the integration, there are two main requirements**:

-   a Contentful account
    

-   an active subscription on Surfer
    

It's important to note that your Surfer and Contentful logins don't have to match – browser cookies will do their magic!

  

## **Setting up the integration**

Once you have set up your accounts and ensured your Surfer subscription is active, you can integrate Surfer into Contentful directly from the [marketplace](https://www.contentful.com/marketplace/app/surfer/). Alternatively, you can do so on the 'Apps' tab in your Contentful account by following the below steps:

-   Click on the 'Apps' section then select 'Marketplace'.
    
-   Search for 'Surfer' and click on it.
    
-   Click the Install button  
    ​
    

![](https://staticfiles.gleap.io/helpcenter/6928645a69d9b470d70dcfd6/20251212091144_4522.gif)

  
You're all set! 😊 Surfer should appear on your list of Installed apps. 

  
​

![](https://staticfiles.gleap.io/helpcenter/6928645a69d9b470d70dcfd6/20251212091143_2919.gif)

  
​

## **Configuring the Integration**

Once installed, you will need to select the content types you want Surfer App to work with.

⚠ **Each content type you select must contain at least one Rich Text field.**

  
To allow Surfer to work with your content type:

-   Select your existing Content Model (or add a new one)
    
-   Click on the '**Sidebar**' section
    
-   Hit the ➕ sign next to Surfer
    
-   Click the **Save** button to save changes
    

![](https://staticfiles.gleap.io/helpcenter/6928645a69d9b470d70dcfd6/20251212091143_8905.gif)

To get started, you can choose one of your existing content types or add a new entry. Surfer will appear in the right sidebar when you access the selected content type editor in Contentful. You can also create a new Content Editor directly from Contentful, which will count towards your Surfer subscription limit.  
  
​

![](https://staticfiles.gleap.io/helpcenter/6928645a69d9b470d70dcfd6/20251212091144_6473.png)

⚠ The integration allows you to link existing Surfer guidelines or create new ones directly in Contentful, but there’s no sync for content. You will need to copy-paste the content manually from one Editor to another.

## **Sharing a draft link**

While your Editor is linked to Contentful, you will **not** be able to create another sharable link. However, you can always disconnect a Content Editor from Contentful and then create a new shareable link in Surfer.  
​

You can disconnect the Content Editor from Contentful in two ways:

**In Contentful** – click on the below pin icon to disconnect the editor.

![](https://staticfiles.gleap.io/helpcenter/6928645a69d9b470d70dcfd6/20251212091143_8768.png)

**In Surfer** – open the content editor from the list in [Surfer](https://app.surferseo.com/drafts) » click the **"Share"** button on the right » click **"Disconnect from Content Editor"**  
  
​

![](https://staticfiles.gleap.io/helpcenter/6928645a69d9b470d70dcfd6/20251212091144_8880.png)

**Do you still need help?** Don't worry! You can contact us at [support@surferseo.com](mailto:support@surferseo.com) or via live chat by clicking the icon in the bottom-right corner.