Connect to WordPress

This guide walks through the steps to connect your Clutch project to your WordPress backend using the Clutch plugin for WordPress.

How to Connect

These steps assume you’ve already created a Clutch project using the WordPress template.

  1. Download the WordPress plugin from clutch.io/download.

  2. In your WordPress admin dashboard, go to the Plugins menu.

  3. Click Add New Plugin, then select Upload Plugin to install the .zip file you downloaded.

  4. After the upload, click Activate Plugin.

  5. In your Clutch project, click the WordPress icon in the app bar.

  6. Enter the root URL of your WordPress backend. Ex.: https://example.com/ (/ at the end is optional). Do not include /wp-admin.

    Note: Localhost sites using Local on a macOS having https in their URLs by trusting the certificate via Keychain will not work at the moment. You will need to use http in the URL.

  7. Click Connect.

  8. Click Authorize Connection. It should open a token approval page in your WordPress admin asking “Do you want to allow Clutch to access your WordPress drafts and previews?”. Click the Approve button.


    If the connection is successful, the indicator above the WordPress icon will turn green.

If you are having trouble connecting the plugin:

  • Confirm the Clutch plugin is activated in your WordPress admin

  • Verify the WordPress URL in Clutch is correct, it should be the base URL of your WordPress backend (e.g. https://yoursite.com/)

Next Steps

Once you have connected to your WordPress backend via the plugin, you can connect your WordPress data to components in Clutch. This will be covered in another article. If you are curious though and want to know how it works, watch the video below.