> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://uploadcare.com/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://uploadcare.com/docs/_mcp/server.

# Contentful integration

> Contentful is the leading composable content platform. Uploadcare powered them up with File Uploader.

[Contentful](https://www.contentful.com) is a headless CMS that allows users to create, manage,
and distribute content across multiple channels.

Contentful feature set may be extended via collections of widgets called “apps”.
Uploadcare provides a Contentful app that allows you to upload files to your
Uploadcare account via [File Uploader](/docs/file-uploader/) and store the metadata in
Contentful.

## Preparations

### Create a Contentful account

If you don't have one yet, create a Contentful account. The account is free and
allows you to have one space.

Later in this guide you will install the app to your space. So, ensure you've
created one before proceeding.

### Create an Uploadcare account

Same here: if you aren't with us yet, [sign up](https://app.uploadcare.com/accounts/signup/). Once you have
an account, navigate to your [Dashboard](https://app.uploadcare.com/) to create a new
[Project](/docs/start/settings/), or discover [API keys](https://app.uploadcare.com/projects/-/api-keys/) for an existing
one. To go through the steps of this guide, you will need the [Public API Key](/docs/start/settings/#keys-public), which tells Uploadcare which project your file
uploads should go to. The key can be found in the [API keys](https://app.uploadcare.com/projects/-/api-keys/) section.

![Uploadcare dashboard](https://ucarecdn.com/926500d3-9b1c-49e1-8c97-1bfc17c99cbc/API-keys.png "You need to take a Public key from this page")

## Step 1. Install the app

Open [Uploadcare app](https://www.contentful.com/marketplace/app/uploadcare/) in Contentful Marketplace and click
**Install now**. Pick the space and environment as you wish, then click
**Continue**.

Marketplace should redirect you to your Contentful space with app details window
open. Click **Install** button there and then **Authorize access**.

Now you should see the app installation screen.

![Contentful's installation screen for Uploadcare app](https://ucarecdn.com/9671a1b9-1144-49bf-8be2-990b3b00e546/app-installation-screen.png "Set up your app here")

To make it work, provide the [Public API Key](/docs/start/settings/#keys-public) that can be
found in the [API keys](https://app.uploadcare.com/projects/-/api-keys/) section of your Uploadcare Dashboard.

All the other settings are up to your preferences. Click **Install** when you
are done.

## Step 2. Create a content type

Uploadcare app provides File Uploader as a custom field. To use this field while
editing content, you have to first attach it to a certain content type.

If you already have a content type, feel free to modify it according to the
instructions below. Otherwise let's create a new one.

Click on **Content model** link in the main menu. Then click on **Add content
type** button. Fill **Name** input with the name you like. Then click
**Create**. You will be navigated to the content type page.

## Step 3. Set up a field

Click **Add field** button and there pick **JSON object** field.

![Contentful field creation dialog](https://ucarecdn.com/791d7af5-2b4f-45c6-ab32-275447f371de/json-object.png "Pick 'JSON object' field here")

In the next dialog fill the **Name** of the field. This is the name of the field
File Uploader will be attached to. So, you probably want to call it like
“Images” or “Files”.

Click **Add and configure** to proceed.

In the field settings dialog scroll down to the **Appearance** section, and
click on the Uploadcare logo. This will attach the app to the field.

![Contentful field settings dialog](https://ucarecdn.com/7b818e90-051c-4958-a322-06fadb7d3d11/field-appearance.png "Click on the Uploadcare logo here")

You may also override some app settings here using the fields below the app
picker. Don't worry, you do not need to decide now. You will be able to do it
later by editing the field.

Click **Confirm** in this dialog.

If you need, create more fields for this type. Finally, click **Save** on the
content type page.

## Results

Now you have the Uploadcare app attached to the field you've created.

Feel free to open the **Content** section and create a new entry of the type
you've just configured.

You should see our File Uploader.

![Uploadcare app for Contentful app and running](https://ucarecdn.com/06b71588-7db2-4866-8968-a62d6f8262d0/file-uploader.png "Feel free to upload your files")

Click on the button to upload files. When the uploading completes, files'
metadata will be saved into Contentful as JSON.

This JSON object may be used by developers to display uploader files, or apply
[CDN operations](/docs/cdn-operations/) to them.

## Conclusion

Yay! You have just installed Uploadcare app to Contentful. The flexibility of
Uploadcare is now enhancing your content infrastructure.