Strapi plugin integration

The Spron Strapi plugin integration sends ready articles and their images to a plugin-owned collection in Strapi 5. Install the plugin, restart Strapi, then use Connect to Spron from Settings → Spron. You approve the request in Spron, and the signing key goes straight to your Strapi site without manual copying.

How Strapi publishing works

Spron sends each ready article to the plugin’s own Articles collection in Strapi. The collection uses the slug spron-articles, so the integration does not write to your existing collections.

The plugin checks the signature over the raw request body and rejects old or repeated deliveries. It uses the last delivery ID stored on the entry for replay protection.

When an article includes images, the plugin downloads them into your Strapi media library. It rewrites the links in the article so they do not point to an address that expires.

A later delivery of the same article updates its existing entry instead of creating another entry. New ready articles are sent automatically after you connect.

Before you connect Strapi

You need Strapi 5, the Spron plugin, and a Strapi site that Spron can reach over the internet. Spron must reach your server to send the signing secret and later deliver articles.

Run the install command inside your Strapi project. You also need access to the Strapi admin panel and the Spron site you want to connect.

  • A project running Strapi 5
  • The ability to install an npm package and restart Strapi
  • A public address that reaches your Strapi server
  • Access to Settings → Spron in the Strapi admin panel

Connect Strapi to Spron

  1. Install the Spron plugin

    Open a terminal in your Strapi project and install the package. Restart Strapi after the installation finishes.

    • Run the command from the root of your Strapi project
    • Restart Strapi before opening the plugin settings
    npm install @spron/strapi-plugin
  2. Connect from Strapi

    In the Strapi admin panel, open Settings → Spron. Check the address of your site, then press Connect to Spron.

    Strapi sends you to Spron with a one-time state. Allow the connection there, and Spron sends the signing secret directly to /api/spron/connect on your site.

    The secret does not travel through your browser or a URL. The plugin rejects a secret when its state was not issued by that plugin.

    • There is no key to copy or paste during this setup
    • After approval, you return to the connection flow

What Spron sends to Strapi

Spron sends the article content, search data, and images needed for the plugin’s article entry. Images are stored in the Strapi media library rather than left on temporary external addresses.

Every image is saved with its alt text, and the featured image is set on the entry. The plugin writes only to its own Articles collection.

  • Article title and content
  • SEO description
  • Search data for Google
  • Featured image
  • Images used inside the article
  • Alt text for each image

Check your first Strapi article

Check Delivery history in Spron, then find the matching entry in the plugin’s Articles collection in Strapi. Review the title, content, featured image, other images, and alt text.

Delivery history shows the article, site, result, and sent date. Possible result labels include Waiting, Sending, Saved as draft, Published, and Needs attention.

A Saved as draft result means the article reached Strapi as a draft. A Published result means the delivery is recorded as published.

  • Confirm that the entry appears in the plugin’s Articles collection
  • Check that article images appear in the media library
  • Review any delivery error shown under Needs attention

Fix common Strapi connection issues

Connect to Spron does not complete

Check the site address shown under Settings → Spron and make sure Spron can reach that address over the internet. The connection cannot finish unless Spron can post the signing secret to your Strapi server.

An older ready article was not sent

The connection sends new ready articles automatically. For articles that were already ready before you connected, open the connection actions in Spron and press Send pending.

An edited article did not change in Strapi

Spron saves article edits as you type but does not send them immediately. Open the article editor and press Republish to send the latest version to the same Strapi entry.

Need help connecting? Contact support, visit the Help Center, or see our other publishing integrations.

Strapi FAQ

We're here to help.

Which Strapi version does the plugin need?

The plugin needs <strong>Strapi 5</strong>. Install it with npm and restart your Strapi site.

Do I need a Strapi API token?

No. Start the connection from <strong>Settings → Spron</strong>, approve it in Spron, and the two sites exchange the signing secret directly.

Where do Spron articles go in Strapi?

They go into the plugin’s own <strong>Articles</strong> collection, which uses the slug <code>spron-articles</code>. Mapping articles into an existing collection is not supported.

What happens when Spron sends the same article again?

The plugin updates the existing entry instead of creating a second copy. Use <strong>Republish</strong> in the Spron article editor to send your latest edits.

What happens if my Strapi site is down?

Spron retries a failed delivery automatically. You can also resend an article from <strong>Delivery history</strong> while its connection remains active.

How do I restore an article deleted from Strapi?

Open the connection actions and press <strong>Check destination</strong>. Spron finds articles that are gone and sends only those articles again.

How do I stop sending articles to Strapi?

Press <strong>Disconnect</strong> at the top of the integration page. Spron stops sending new articles, while articles already stored in Strapi remain there.

Can I enter a signing key manually?

If you connected through Spron’s Webhook screen instead, open <strong>Enter a key by hand</strong> on the Strapi plugin settings screen and paste the signing secret there.