Publishing articles
RankX AI publishes a reviewed article to WordPress or a Shopify blog, writes its SEO title and meta description, then reads every field back to verify it.
RankX AI publishes a reviewed article from Content Studio to a connected WordPress site or a Shopify blog. It writes the post, writes the SEO title and meta description, then reads every field back from the site, so the result says exactly what landed.
A person decides when an article goes live. An article publishes when someone asks for it from its own screen, or on a schedule when a Website runs Content Autopilot in publish mode. A staff member's Publish approves and publishes in one action unless the Website requires approval first.
What should I check before publishing?
Check three things, in this order; the first saves the most time.
Can this site be written to? RankX AI checks what your site supports: which content types are editable, whether SEO fields are writable, and whether a page builder is in use. Everything below reads differently once you know.
Is the draft reviewed? The quality and GEO checks tell you what to fix, and fixing it before the page exists is easier. See content quality scores.
Where does this site keep its SEO fields? That depends on your SEO plugin. RankX AI tells you which case you are in and how to make the fields writable; see the WordPress integration.
How do I publish an article to WordPress?
Open Publish on the article
Open the article in Content Studio and choose Publish. The sheet, Publish to your website, asks where, when and as whom.
Choose when
Publish now makes the post live. Schedule for later sets a time in the Website's own time zone, and WordPress shows the post as scheduled until then. Save as a draft on the site puts the post in WordPress without making it live.
Check the categories, tags and author
A category or tag the site does not have yet is offered as Create, and only your click creates it.
Publish and read the result
RankX AI publishes, reads every field back and lists each one as verified, written, not writable, failed or skipped.
What does a publish write?
One publish sets the whole post: title, body, excerpt, slug, categories and tags, featured image and author, then the SEO fields and, on WordPress, the article's structured data.
The SEO title and meta description go through your SEO plugin. Without the RankX AI plugin, RankX AI writes them where the plugin makes them available to the WordPress REST API: Yoast does on some post types, and Rank Math and SEOPress need a short code snippet first. With the optional RankX AI plugin installed, RankX AI writes them for Yoast, Rank Math, SEOPress, All in One SEO and The SEO Framework.
On a site with no SEO plugin, the meta description is saved as the post excerpt, and the RankX AI plugin can print it as the page's meta description.
The body is converted faithfully. Block markup is passed through untouched, and plain HTML is converted to blocks. Anything the converter cannot map is kept as it is in a Custom HTML block and reported, never dropped.
Every field is verified by reading it back, not by trusting a success response. Some plugins report success while saving nothing, so a write RankX AI cannot confirm is reported as unverified rather than as a success.
How does publishing to a Shopify blog work?
RankX AI publishes to a Shopify blog through the same engine and the same read back. The sheet picks the blog (the one this store last published to, or its only blog), takes tags as words and the author as a name, and writes the SEO title and description to the article's own search fields. Your Shopify theme adds the article's structured data itself.
From Content Studio, a Shopify article is published now or saved hidden on the store, and scheduling is offered for WordPress sites. This section covers Content Studio in the RankX AI web app; the embedded Shopify app has its own Blog workflow inside Shopify admin, described in the Shopify guide.
What can I do after an article is live?
From the article's own screen you can update the live post with your latest edits, unpublish it, cancel a schedule, or publish a scheduled article now.
On Shopify, an update first checks whether someone edited the article in Shopify admin since RankX AI's last write, and asks before overwriting that edit.
How do I undo a change on WordPress?
Use WordPress's own revision history. WordPress saves a revision each time a post is updated, so an update from RankX AI can be rolled back like any other edit.
Open the post's revisions
Open the post or page in the WordPress editor, open the Settings sidebar, select the Post or Page tab, and click the number next to Revisions.
Find the version you want
Use the slider at the top, or the list of revisions, to find the version from before the change. Changes between versions are highlighted.
Restore it
Click Restore. WordPress makes that version the current one, and the change you rolled back stays in the history. On WordPress 6.9 and earlier, the classic revisions screen opens instead and restores the same way.
Revisions cover the title, content, excerpt and author. The featured image, categories and tags, and usually your SEO plugin's fields, are stored outside revisions, so change those back in WordPress or your SEO plugin.
A site that has turned revisions off in wp-config.php keeps no history, and some content types, WooCommerce products among them, have none. Source: WordPress revisions documentation (opens in a new tab).
From an assistant, wp_list_revisions lists a post's revisions and says plainly
when a content type has none, which is worth checking before an edit.
Can an article be published twice by accident?
No, not from Content Studio. Each publish is claimed once and keyed to the article and the site, and a create whose outcome was uncertain is looked up on the site before anything is sent again. A second press of Publish cannot create a second post.
The MCP tool wp_create_content works differently. It creates a post
directly, outside Content Studio. Pass an idempotency key and a repeat of the
same call returns the original post; without one, two calls create two posts.
So
if you drive wp_create_content from a script or an assistant and are unsure
whether a call landed, list the content and look before retrying.
How should I update an existing page?
Use a targeted patch for any edit to an existing page. Choosing the wrong kind of edit is the expensive mistake here.
A targeted patch changes exact text inside existing blocks and nothing else, so it is safe on a long page and far cheaper than resending the whole body. If any of its edits fails to match, nothing is written at all.
A whole-body update replaces the body. That makes it unsafe after a cut-off read: a very long body comes back truncated and says so, and sending that back would delete the part you did not see.
Adding, moving or removing a whole block is a third operation, with a free outline action that lists every block first. A text patch cannot do it and refuses rather than trying.
What about pages built with a page builder?
RankX AI protects every page's layout, with three levels of access.
| The page is | What RankX AI can do |
|---|---|
| Plain block editor (Gutenberg) | Replace the body, or patch specific text |
| A block-based builder | Targeted text patches, and adding or removing a block, each asked for explicitly |
| A meta-based builder (Elementor, Divi and similar) | Protected. Edit the body in the builder itself; body writes from RankX AI are refused |
A builder RankX AI does not recognise gets the most protective level, so the guard keeps working for a builder it has never seen.
What does a verified write mean?
A verified write means RankX AI read the change back from your site's database through the WordPress REST API. It does not mean every visitor sees it yet: a page cache or CDN in front of your site can serve the old version for a while, and RankX AI says so on its edits to existing content and SEO fields.
If a write reports as unverified, check the post in wp-admin. It may have landed and been unreadable behind a cache, or a plugin may have accepted and then discarded it, which is the case this check exists to catch.
Can an AI assistant publish an article?
Yes, to WordPress. approve_content_item records a person's sign-off, which is
free and changes nothing on the site. publish_content_item then sends the
article to a WordPress site as a draft, scheduled for later, or
published now.
On a Website that requires approval, publish_content_item refuses an article
nobody has approved; on one that does not, the publish approves it in the same
step, as a staff member's Publish does. A Shopify blog is published from the
article's screen in Content Studio.
Show me content item X. If I approve it, publish it to my site as a draft and tell me which fields were verified.
Publishing spends no credits. It returns straight away and carries on in the
background, and get_publication_status reports each field as verified, written,
not writable, failed or skipped. An unconfirmed state means the post may have
landed and could not be read back: check the site, and do not publish again.
Edits to pages that already exist work differently: each one is a dry run by default, and the dry run goes through the same steps as the real write, so its warnings are the warnings the write will produce. See the WordPress tool reference.
Where to go next
- The WordPress integration, for connecting a site and the SEO plugin detail.
- The Shopify integration, for connecting a store.
- Writing articles, for what gets published.
- Content Studio, for what RankX AI's AI SEO content generator does from research to publishing.
- Troubleshooting connections, when a write is refused.
Questions
Does publishing an article cost credits?
No. Publishing to WordPress or a Shopify blog is free. You pay once, when the article is written.
Can I undo an update RankX AI made to a WordPress post?
Yes, through WordPress's own revisions. Open the post, open the Settings sidebar, click the number next to Revisions, find the earlier version and click Restore. SEO plugin fields are usually not part of revisions, so change those back in the plugin.
Why does my site still show the old version after a verified update?
A page cache or CDN in front of your site is serving a stored copy. The change is saved in WordPress; clear the cache, or wait for it to expire, and visitors see the new version.
Do I need the RankX AI WordPress plugin to publish?
No, publishing works over the WordPress REST API. The optional plugin, a free download from inside RankX AI, lets RankX AI write SEO fields for more SEO plugins. See the WordPress integration.
Last updated