For the complete documentation index, see llms.txt. This page is also available as Markdown.

Exporting and publishing content

Assign a Copywriter project in Asana, download its draft, or publish it to WordPress, Webflow, or a GitHub pull request.

Use Send to Asana to coordinate review and delivery in a mapped Asana project. Use Download to save the current artifact or create a Google Doc, and Publish to deliver an article to WordPress, Webflow, or a GitHub pull request. These actions are different from Share, which creates a review link, and Mark as done, which only changes the project status.

Before you export

Open the project and select Draft or Script. Confirm that the header shows Saved, then complete the draft review workflow. File exports and CMS deliveries use the project's current saved content and metadata; unsaved text is not a safe handoff point.

Rankability also checks the draft for problems a good content score cannot rule out. When one applies, the editor marks the draft Not publish-ready and lists exactly what to resolve. The checks cover incomplete or placeholder content, internal instructions left in the article body, repeated sections, a commerce page with no verified destination, claims and comparisons that the retained research evidence does not support, and a claims check that did not finish. Work through the listed items, then publish.

Scheduled auto-publishing applies the same checks. When one applies, a run that would have published live is delivered to the CMS as a draft for human review instead, so the work is not lost.

The choices shown depend on the project artifact, plan, and client connections. A project cannot export a brief or YouTube package it did not generate. New YouTube Script projects can no longer be created, but historical projects retain their package export. Demo content and free-plan limits can also make an option unavailable.

Choose a file or document format

Select Download, then choose the format that matches the next editor:

  • Google Docs creates a document and opens it in a new tab. The first use can open a Google authorization window. If the organization-level Google Docs integration is not configured, contact Rankability support.

  • HTML (developer handoff) downloads an .html file for a developer, CMS, or downstream build workflow.

  • Markdown downloads the article as .md.

  • Microsoft Word downloads a .docx document.

  • Brief (Markdown) appears only when the project contains a generated brief and downloads that brief separately from the draft.

  • YouTube Package appears for historical YouTube Script projects and downloads a text package containing the generated video title, description, chapters, tags, and script.

HTML, Markdown, and Word exports are not available on the free plan. Rankability can ask for a missing first name the first time you use one of those three file exports; that profile prompt is not part of the content itself.

Assign the content project in Asana

When Asana is connected and the client is mapped, open the Copywriter project and choose Send to Asana. Rankability creates a task in the mapped project with the content topic, available status or project context, and a direct link back to the Copywriter project. It adds a Copywriter tag when the connected Asana workspace permits it.

After the handoff, In Asana opens the existing task. Reusing the action does not create a second task for the same linked project.

This is a coordination handoff, not publishing or universal status sync. Rankability does not automatically select an assignee or due date, and completing the Asana task does not mark the Copywriter project done or publish the content. See Connecting Rankability to Asana for connection and mapping instructions.

Publish to WordPress

Select Publish > WordPress. The client needs a saved WordPress connection. If none exists, the dialog routes you to Client settings > Integrations, where the Rankability WordPress plugin and client-scoped token are configured.

Rankability saves pending editor changes before the dialog opens, so the preview reflects your latest text. If that save fails, the dialog does not open and Rankability asks you to save your latest edits first.

In the publish dialog:

  1. Confirm the connected site and its freshness or verification message.

  2. Review the preview, including title, slug, meta description, and hero image when present.

  3. For a standard article, choose Save as draft or Publish immediately, then choose Post or Page.

  4. For a local-service landing page, Rankability creates a draft block-editor Page so you can review its calls to action before it goes live.

  5. Confirm the delivery, then open the returned WordPress URL when available.

The editor toolbar keeps the latest WordPress delivery state visible:

  • Queued means Rankability accepted the delivery but the plugin has not acknowledged it yet.

  • Publishing means delivery is still active.

  • Published means the destination acknowledged completion and can include the returned URL.

  • Failed means the attempt needs review. Open Publishing history for the saved diagnostic before retrying.

Do not treat a queued fallback as a successful publish. Rankability continues polling queued deliveries, and one-off publish attempts remain in Publishing history rather than appearing as recurring Routines.

Publishing creates a CMS item; it does not turn the Rankability editor into a two-way WordPress editor. Make later CMS changes in WordPress, and avoid repeating the publish action until you have confirmed whether the prior item was created. See WordPress article delivery formats for native blocks and page-builder behavior.

Publish to Webflow

Select Publish > Webflow CMS when the client has a current Webflow connection. Confirm the site and collection, review the preview, and choose Save as draft (staged) or Publish immediately.

If the option says Not connected, open Client settings > Integrations, add a current Webflow Site API Token, and select the site and collection. A previous Webflow link can require reconnection before publishing.

Rankability maps the supported article fields to the connected collection. If the collection uses different field slugs or required fields, publishing can fail with a destination-specific error; correct the collection or connection before retrying.

Open a GitHub pull request

Select Publish > GitHub pull request to hand the saved article to a repository-based website workflow. If the client does not have a usable GitHub destination, use Manage destinations or Connect a destination first.

Before confirming, review the repository, base branch, content directory, and output format. Rankability saves pending editor changes when necessary, creates a new branch and content file, then opens a pull request for review. It does not merge the pull request or publish the website automatically. Review, approve, merge, and deploy through the repository's normal workflow.

A scheduled Routine can also deliver to GitHub. Choose Projects + GitHub pull request as the Routine's destination. Connect GitHub and confirm the client's article folder first; Rankability will not save the Routine until both are in place. Each scheduled run opens a pull request for review in the same way, so nothing reaches the site without your approval.

Check publishing history and the destination

Open More actions > Publishing history to inspect CMS attempts. Use the destination, status, timestamp, error, and available CMS link to determine what happened before retrying. A staged Webflow item and a live item are different states; confirm the remote collection so you do not mistake a partial publish for a missing item.

After every download or publish, inspect the destination. Headings, lists, links, and basic emphasis generally transfer well, but themes and editors can change spacing, tables, embeds, images, block structure, and metadata rendering.

Troubleshooting

  • A download is missing: Confirm the project produced that artifact and that your plan supports it.

  • Google Docs opens an authorization page: Complete the Google flow, then return to the project and export again if a document did not open.

  • WordPress has no connection: Install or update the Rankability plugin and finish the client-scoped connection in Client settings.

  • Webflow is disabled: Reconnect the client with a valid Site API Token and collection.

  • GitHub is unavailable: Confirm the client destination can access the intended repository and that its base branch, content directory, and file format are still valid.

  • A CMS publish failed: Read the returned error and Publishing history, verify the remote CMS for a partial success, correct the connection or content, and only then retry.

Last updated

Was this helpful?