Nuvelics documentation
Web appSettings

CMS

Connect the content management system where Nuvelics files your articles as drafts: WordPress today; Arc XP can be connected but not yet filed to.

The CMS tab records where Nuvelics files your articles. A connection is the address and credential Nuvelics uses to reach your content management system. This page is the steps; what each system does with Nuvelics is in WordPress and Arc XP.

Who can use it

Owners and admins (cms:manage). The tab is missing for Members and Viewers.

Add an Arc XP connection

  1. Choose Add connection, then Arc XP in Add CMS connection. The other systems in the picker, such as WordPress VIP, Brightspot, Contentful, Sanity, Livingdocs, Ghost, Newspack and Adobe Experience Manager / Drupal, are marked Coming soon.
  2. On Connect Arc XP, fill in the form:
    • Name: how the connection appears in Nuvelics, for example "Acme production".
    • Arc organization ID: just the ID, such as acme, not a full host. It addresses the API and is written onto every story. Letters, digits and hyphens only.
    • Environment: Production, Sandbox, Staging or Development. It decides the API host.
    • Website ID: the Site Service Website ID of the site to file into.
    • API host: shown for you, derived from the organization ID and environment. It is not stored separately.
    • Access token: stored encrypted. Nuvelics never shows it again. Show access token reveals what you typed before you save.
  3. Choose Add connection.

You see CMS connection added. Blank fields are refused (for example Website ID is required); an organization ID that looks like a host is refused with "Enter just the organization ID, not a full host — letters, digits and hyphens only".

An Arc XP connection can be saved today, but pushing articles to it is not available yet: the list marks it Push support coming soon.

Add a WordPress connection

  1. Choose Add connection, then WordPress.
  2. On Connect WordPress, fill in the form:
    • Name: how the connection appears in Nuvelics.
    • Site address: your site's address exactly as WordPress shows it under Settings > General. It must start with https:// and carry no query, fragment or sign-in details.
    • WordPress username: the username shown in WordPress under Users > Profile. The account's email address works too.
    • Application password: create one in WordPress under Users > Profile > Application Passwords, then paste it as it is, spaces and all. It is stored encrypted, and Nuvelics never shows it again.
    • Credit the featured image in the article body, On or Off: turn it on if your theme does not show the featured image's caption. The photo credit is then filed as the article's first paragraph. Leave it off if your theme shows it, or the credit appears twice.
  3. Choose Add connection.

You see CMS connection added. A connection whose credential WordPress later refuses may have a wrong password, or its server may be stripping the Authorization header before WordPress sees it; WordPress reports that second case under Tools > Site Health.

Read the list

Each connection shows its System, Name and Target: the Arc API host the organization ID and environment resolve to, or the WordPress site address.

Edit a connection

  1. Open the connection from the list and choose Edit.
  2. Change what you need. A credential field appears as Replace access token, Replace WordPress username or Replace application password; leave it blank to keep the current one.
  3. Choose Save changes.

You see CMS connection saved. Some changes require you to re-enter the credential:

  • For Arc XP, changing the organization ID or environment: Re-enter the access token to change the organization ID or environment.
  • For WordPress, moving the connection to another server: Re-enter the application password to move the connection to another server; changing the username needs the password too (Enter the password to change the username).

If another person saved first you are told "This connection changed since you loaded it — reload and try again."

Delete a connection

  1. Open the connection's CMS connection actions menu, or the connection page, and choose Delete.
  2. Confirm in Delete CMS connection. This deletes the connection and the stored credential, and Nuvelics can no longer reach the system.

You see CMS connection deleted.

Other ways to manage connections

Report a problem with this page

On this page