Connecting your WordPress site

You connect a site from the WordPress side. That way the person who controls the site is always the person who starts the connection, and Content Uploader never needs your WordPress password.

Before you start: the plugin is installed and active, you are signed in to WordPress as an administrator, and you are able to sign in to Content Uploader as an owner of the workspace the site should join (team members cannot connect sites; see team members).

Connect the site#

1. In WordPress, open Settings → Content Uploader. It says Not connected, or connection expired.

   

   Read the paragraph above the button: it lists what the site shares with Content Uploader once you approve (the site address, versions, the content types and fields that can be written, and author names) and links to the privacy policy and terms.

2. Select Connect to Content Uploader. WordPress shows a short hand-over page titled Approve the connection. It shows the address of your site. Select Continue to Content Uploader.

   

3. Content Uploader opens. Sign in if you are asked to. You see Connect your WordPress site, the address of the site, and a Workspace list.

   

   1. Check the site address. Approve only a connection that you started from your own site.
   2. Choose the Workspace. If you own only one, it is already chosen.
   3. Select Approve connection.

4. The Sites page opens and shows the site as connected.

   

   1. The line under the address reads WordPress, the version, connected and the plugin's version.
   2. Access ends on shows when the connection expires: it lasts 90 days for security and can be renewed at any time.
   3. Renew access, 4. Refresh fields and 5. Disconnect are explained in managing connected sites.

5. Back in WordPress, Settings → Content Uploader now says Connected. and shows the same end date.

   

What the connection can and cannot do#

• It can read which content types, fields, categories, tags and users your site offers, and the state of items it created, and it can create and update items. It cannot sign in to WordPress, read other parts of your site, or use any other REST address.
• It never deletes anything.
• It lasts 90 days, can be revoked at any time by selecting Disconnect in WordPress or by deactivating the plugin, and renewing it is always free.

Permissions and authentication explains how this works.

Common mistakes#

• Waiting more than ten minutes between steps 2 and 4. The invitation expires. Start again at step 1.
• Approving into the wrong workspace. A site is connected to one workspace at a time. To move it, select Disconnect on its row on Sites in the workspace that has it, then connect it from WordPress in the other workspace. Until then, the approval is refused with This installation is still connected to another workspace. Disconnect it there first, then connect it here. Choose the workspace carefully: configurations and publishing history stay with the workspace the site was disconnected from.
• Being signed in to Content Uploader as a team member. Only owners can connect sites. The page tells you so and asks you to have an owner approve it.
• The Free plan allows one site. Connecting a second shows The Free plan connects 1 site… with a link to the plans. Reconnecting or renewing the site you already have is never refused.

If the connection cannot be completed, see troubleshooting the WordPress connection. When it works, go on to your first import.