Skip to content

Content Studio will not hand off a draft

Updated View as Markdown

Content Studio sends the current working copy to WordPress as a draft. It does not publish the post. The first hand-off and a later update are different operations: the first creates a draft, while an update is allowed only when MazeGraph can safely change the post it previously handed off.

The hand-off itself does not make an AI request. Provider availability matters while Research, Plan, Write, or a suggested rewrite is running; it is not what saves the finished working copy to WordPress. See Content Studio stages for the full workflow and The provider is unavailable if an AI stage cannot finish.

Sending a draft for the first time

Before sending, make sure the document has finished writing and has a title. The Send to editor button stays unavailable while the assistant is working, while an outline still needs approval, or while the title is blank. Optimize findings are suggestions; they do not block hand-off.

  1. Open Hand off and choose a content Type if more than one is available.
  2. Choose any categories, tags, or featured image you want to include. These are optional. Content Studio only offers items your WordPress account may use; images must already be in the Media Library.
  3. Wait for the working copy to show as saved in Studio. Select Send to editor.
  4. When the save completes, select Open in editor to review the new WordPress draft.

If Studio says Your edits could not be saved first, the hand-off stops until the working copy can be saved. Keep the page open, check the save indicator, and copy your latest text somewhere safe before refreshing or leaving the document. Once Studio confirms your edits are saved, try Send to editor again.

If the content type or target is unavailable

The available types depend on both WordPress and the current user’s capabilities. Posts and pages are the baseline; a custom type must be public, available in the dashboard, support an editor, and be exposed to the REST API. You must also have permission to create and edit that type. Ask an administrator to check the custom type registration and your WordPress role if the type you need is missing.

Categories and tags are limited to terms you may assign. A featured image must be an image in the Media Library that your account may use. If a selected image or term causes a save error, remove that optional selection and try again; you can add it later in WordPress. For the complete first hand-off process, see Optimize and hand off a draft.

If WordPress refuses to create the draft

Read the full message shown in Studio before retrying. Then ask an administrator to check:

Check What to review
Content Studio module Open MazeGraph → Tools → Extensions and confirm Content Studio is enabled. A disabled module cannot perform its hand-off. See Extensions.
Permission for the selected type Confirm that your WordPress account may create and edit the selected post type. If the type is missing from the choices, WordPress may not expose it to Studio or your account may lack the required capability.
Title and current save Give the working copy a title and make sure Studio has saved your latest edits before sending. A blank title prevents the hand-off.
Optional targets Remove the featured image or terms you just selected and retry. You can assign supported categories, tags, or an image from the WordPress editor afterward.

Sending from Studio is an explicit action you take with the draft in view. Chat tool switches, an assistant’s tool list, and the chat’s Ask / Auto / Full permission mode do not control this hand-off. WordPress still checks your permission, and the Content Studio module must be enabled. For a draft-creation request made in chat, see A tool is missing or refused.

If Studio will not update a draft it already sent

After the first hand-off, WordPress owns the post. Studio can update it only while it is still a draft or pending post, you can edit it, nobody else has it open in the editor, and its title, excerpt, and text have not changed since MazeGraph last wrote them. This prevents Studio from replacing newer editorial work.

Studio message or situation Why the update stops What to do
You may not edit that post. Your account no longer has permission to edit this post. Ask an administrator to review your access, or continue in WordPress if the editor allows you to make the change another way.
That post is no longer a draft. The post has moved beyond draft or pending status. Continue editing the existing post in WordPress. Studio will not replace a published or otherwise changed-status post.
Someone is editing that post right now. WordPress reports an active editor lock. Wait until the other person has finished, then reopen the Studio document and check again.
That post was edited in WordPress after MazeGraph wrote it. The title, excerpt, or text no longer matches Studio’s last saved version. Keep the WordPress edits and continue in the editor, or select New draft from this to create a separate draft from the Studio copy.

If you choose New draft from this, the existing WordPress post stays as it is and Studio creates a separate draft. Use Open in editor whenever the WordPress post itself is now the source of truth. Undo last save is also protected by these checks; if someone has since edited or published the post, MazeGraph will not undo over that newer work. See Review changes and undo.

Example: an editor improved the post after hand-off

An editor opens the handed-off draft in WordPress and revises several paragraphs. Later, Content Studio reports that it will not update the draft. The change is intentional: Studio detected that the WordPress text differs from the version it last wrote. Continue editing the current post in WordPress, or create a separate draft from the Studio copy if you need to preserve both versions.

What happened Reason Solution Learning
Studio would not update the handed-off draft. The editor changed the post after the last Studio save, so replacing its full text could erase that work. Keep editing in WordPress or choose New draft from this to make a separate copy. After hand-off, treat WordPress as the owner of the post; Studio updates only an unchanged, editable draft.

For the complete writing process, continue to Write a useful brief, Content Studio stages, and Optimize and hand off a draft.

Was this page helpful?

Your feedback helps us improve these docs.

Documentation

Type to search…

↑↓ navigate↵ selectEsc close