AuraAura Docs

Publishing & Sharing

Publish guides and share them with users via public links.

Guides start as drafts and become available to users once you publish them. You can also share guides publicly via a dedicated link, with optional password protection and expiration.

Publishing a Guide

Every guide has a status: Draft or Published.

  • Draft -- The guide is only visible to you in the editor. Users cannot access it.
  • Published -- The guide is live and accessible to users through the companion's Guides tab.

To publish a guide, open the guide's settings or use the action menu on the guide card and change the status from Draft to Published. You can revert a published guide back to Draft at any time if you need to make changes or temporarily hide it.

Publishing saves any unsaved edits first, so the live guide always reflects exactly what you see in the editor.

Before you can publish

A guide must be valid before it can go live. If it isn't, publishing is blocked and you'll see a message telling you exactly what to fix. A publishable guide needs:

  • At least one step, and the first step must have at least one block.
  • No empty steps — every step needs at least one block (add a block, or remove the step).
  • An ending — at least one step that has no "next step" and no question, so the guide can finish.
  • Valid questions — every Question block needs at least two options.

Publishing a guide makes it visible through the companion, but it does not automatically create a public share link. Public sharing is a separate feature you can enable independently.

Public Sharing

You can share any guide via a public link that works outside of Aura. This is useful for embedding guides in support articles, sending them to customers, or using them as standalone troubleshooting tools.

Enabling Public Sharing

Open the guide's sharing settings and enable public sharing. Aura generates a unique share link that you can copy and distribute.

The public share page is available at a route like /share/guides/[token], where the token is unique to that guide's share link.

Password Protection

You can optionally require a password to access the shared guide. When enabled, visitors must enter the correct password before they can view or interact with the guide.

Expiration Date

You can set an expiration date on the share link. After the expiration date passes, the link stops working and visitors see a message that the guide is no longer available. This is useful for time-limited promotions, temporary troubleshooting guides, or content that should not remain accessible indefinitely.

The Public Guide Experience

When a visitor opens a shared guide link, they see the guide runner -- the same interactive step-by-step player used to preview guides internally. The visitor can:

  • Navigate through each step of the guide
  • Answer question blocks and follow the branching path
  • Submit tickets via action blocks (if configured)
  • View all media blocks (images, videos, documents)

At the end of the guide, the visitor is prompted to leave feedback -- a star rating and an optional comment. This feedback is recorded and visible in your Guide Analytics.

The guide runner tracks the visitor's journey through the guide, including the path taken, step transitions, skipped steps, question choices, and timing. All of this data feeds into your analytics.

Last updated on

On this page