Skip to Content
AuraAura Docs

Managing Your Companions

View, organize, and manage all the companions you have built.

The lower half of your Creator Profile page displays all your companions in a browsable grid. Visitors see only your public companions, while you (the owner) see all of them - public, private, and unshared.

Companion Cards

Each companion is displayed as a card. Here is what you will find on every card:

Status Indicator

A small colored dot at the top left of each card, in front of the name (visible only to you as the owner). In list view it is a colored dot with a label in the Visibility column:

  • Green dot - Public: this companion is listed on Explore and visible to everyone
  • Amber dot - Private: not publicly listed, but reachable by anyone with an active private link or email invite
  • Rose dot - None: not shared with anyone

Name

The companion's name appears prominently at the top of the card. Clicking the name (as the owner) opens the companion's settings in a new tab.

Avatar

A square image on the left side of the card body. This is the companion's profile picture that you set in the Persona tab.

Description

The companion's "About" text appears to the right of the avatar. It is trimmed to four lines so cards stay a consistent size.

Stats

At the bottom of each card, you will see:

  • Chats - the total number of conversations this companion has had (shown in an indigo badge)
  • Rating - the average user rating out of 5 (shown with a star icon)
  • Last updated - how long ago the companion was last modified (e.g., "3d ago", "2h ago")

Owner actions on the card

As the owner, each card shows a Share icon button, which opens the share modal for that companion - QR code, social sharing, copy link, and a visibility picker to switch between public, private, and none. Clicking the card itself (its name or body) opens the companion's own workspace, where you'll find Test, Settings (the profile editor), and - from inside that workspace - the option to delete the companion. There's no separate options menu on the card itself for those actions.

Save to Collection

Every card has a heart icon. Clicking it lets you (or any signed-in visitor) save the companion to a personal collection for easy access later. If you are not signed in, clicking the heart will prompt you to sign in or create an account.

Visitor vs. Owner View

As the owner, you see all companions with the Share button and status dots described above. You can also toggle Live preview mode using the button on your profile header to see exactly what visitors see - only public companions, no Share button, and no status dots.

Visitors see a simplified version: they can click a card to open the companion's public chat page, share it, or save it to their collection.

Grid and List Views

The toolbar above your companions includes a Grid/List toggle. Grid view shows companions as cards (described above). List view switches to a table with one row per companion.

List view columns

The table follows the same layout as your Resources list. Its columns are a selection circle, Name (avatar and companion name), Visibility (a colored dot with the label Public, Private or Not shared), Chats, Rating, Updated and Actions (save and share). The circle in the header selects every companion on the page.

Click the Name, Chats, Rating or Updated header to sort by that column. Clicking the active column again reverses the direction. Visibility and Actions are not sortable. Visitors see a similar table without the selection circle and visibility, plus a rank number column.

Searching and Sorting

Your Creator Profile page includes a toolbar above the grid with:

  • A search bar to filter companions by name
  • A sort menu to change the order (by last updated, name, sessions, or rating, in ascending or descending order) - in list view, you can also sort by clicking the column headers directly (see above)
  • Pagination at the bottom if you have many companions, with a page size selector (50, 100, 150, 200, or 250 per page; 50 by default). Your chosen page size is remembered in your browser and applied automatically the next time you visit.

Selecting Several Companions

As the owner, tick the round circle at the top right of a card, or at the start of a table row, to select a companion. Circles appear when you hover and stay visible once something is selected. Clicking a card while anything is selected ticks it instead of opening it.

  • The left side of the toolbar (New Companion and Activity) changes while companions are selected. It shows how many are selected, Select All or Deselect All (current page only), Duplicate (up to 10 companions), a Visibility menu (Public, Private, None), Delete and a clear button. The view toggle, sort and search stay where they are. Clearing, or changing the page, sort, search or page size, empties the selection
  • Setting companions to Private or None asks you to confirm first, since public links and embeds stop working. Public applies straight away
  • Delete lists the companions in a table, lets you untick any you want to keep, and asks you to type "delete permanently". Pressing Delete or Backspace with a selection opens the same dialog
  • When it finishes you get a message saying what happened, for example "4 companions are now Public." or "2 companions removed." Companions that are being duplicated or deleted are skipped and named, and the message also covers any that could not be changed

With 1 to 10 companions ticked, Duplicate opens one dialog: the same choices apply to all of them, each copy is named automatically after its original, and the copies are made one after another. Companions that could not be copied are reported in the final message. With more than 10 ticked the button is greyed out. See Duplicating a Companion.

Large selections are processed in batches of 50 and still end in one summary. While a companion is being duplicated, the original shows a small Being copied badge and works as usual: you can open it, tick it and change its visibility, though editing is paused until the copy finishes (bulk Duplicate and Delete skip it). The new copy shows Setting up..., is dimmed, and cannot be opened, ticked or shared until it is ready. A companion being deleted shows Deleting... and is locked the same way. The list refreshes itself every few seconds until each one is done.

Activity Across Companions

Next to New Companion (owner only) sits an Activity button. Its colored dot and count summarize all uploads and AI processing across every companion, so you do not have to open each one to see whether files are finished.

Clicking it opens a panel styled like your notifications. Its tab bar shows how many companions are in each state: All, Active (files being processed), Waiting (files queued), Complete and Failed. Each companion counts once, and a companion with any failed file counts as failed so it never gets lost in a long list. Select a tab to see only those companions; tabs with nothing in them are greyed out.

Every companion that has something to show gets one row: its name, how many files it has, and the same breakdown for its own files ("3 active · 12 waiting · 1 failed"), whether the row is open or closed. Under All, rows are grouped under small labels, with failed companions first.

  • Still working - rows open by default while a companion has files being processed or waiting
  • Complete or failed - rows stay closed until you open them; a closed row opens again by itself when new work starts
  • Nothing to show - companions with no uploads or processing do not appear at all
  • Long lists - inside a row, failed files come first, then active, waiting and complete. Five show at a time; use Show more for the rest

Hover a row to swap its status for actions: retry, cancel and dismiss on a file, and Open companion on a companion. You can drag the panel by its header.

Empty States

If you have no companions yet (as the owner, with no search filter active), you'll see "No companions yet" with the prompt "Create your first Product companion to get started on Aura.", a New Companion button, and a Take a Tour button that walks you through onboarding.

Visitors to a profile with no public companions instead see "No companions available", with the note that the profile hasn't published any public companions yet and to check back later.

Last updated on

On this page