ContextQMD
Back to Prompt Optimizer

Favorites & Import

mkdocs/docs/en/basic/favorites.md

2.11.16.9 KB
Original Source

Favorites & Import

Favorites are best used for these jobs:

  • saving prompt results that already proved reusable
  • adding titles, descriptions, categories, and tags
  • reusing content across different workspaces
  • importing or exporting a selected collection without moving all data

Favorites are not the same thing as history.

Favorites are also not tied to one prompt source. You can save manually written prompts, template results, local imports, or prompts that came from Prompt Garden.

The simplest distinction

  • History: version chains and working process
  • Favorites: curated results you intentionally keep for reuse

Where favorites live

There are two common entry types:

Favorites manager in the top toolbar

Best for:

  • search
  • filtering
  • browsing all favorites
  • import and export
  • category and tag management

“Save to favorites” inside a workspace or result area

Best for saving the current content directly as a reusable item.

When saving, you can usually add:

  • title
  • description
  • category
  • tags
  • workspace mode
  • for image favorites, attached images and a cover image

What the current favorites manager can do

Based on the current implementation, it supports:

  • keyword search
  • category filter
  • tag filter
  • grid browsing
  • preview
  • copy content
  • use now
  • edit
  • delete
  • import JSON, resource packages, share HTML, and original share PNG files
  • export JSON, resource packages, share HTML, and original share PNG files
  • clear all favorites
  • category management
  • tag management

Sharing One Favorite

If you only want to share one favorite, you do not need to export the whole collection.

From the favorite detail view, use the share action to export the current favorite as:

  • HTML: a single-file page that can be opened directly, copied from, and imported back into Prompt Optimizer.
  • PNG: a polished long image for visual sharing; the original PNG file also carries import data.

Both formats are generated from the visible export preview. Cover image, description, prompt body, tags, variables, and the product watermark are kept by default; examples and version history can be included or omitted before export. Before sharing, review the prompt, examples, images, and notes for private or sensitive information.

Importing a shared file

Open Prompt Optimizer, go to Favorites -> Import, and upload the file through the same import entry.

Supported files:

  • .po-favorites.zip
  • .json
  • share .html / .htm
  • original share .png

PNG import requires the original file. Screenshots, social-platform compression, re-saving, or format conversion may remove the embedded import data. If the recipient should be able to inspect and copy the content immediately, HTML is usually the better sharing format.

What happens when you click “Use now”

Favorites are not just plain text copies.

The current implementation tries to restore workspace semantics from the saved item:

  • text favorites jump back to the matching basic or pro workspace
  • if the favorite includes system / user meaning, the app also tries to restore the matching sub-mode
  • image favorites jump back to text-to-image, image-to-image, or multi-image

So favorites behave more like a reusable entry with workspace context, not just a clipboard slot.

If a favorite was saved from the multi-image workflow, Use now also tries to restore that sub-mode and its media context so you do not need to rebuild the image set manually.

Applying examples to workspaces

Favorites can also carry reproducible examples. When an example is applied, Prompt Optimizer restores the prompt together with the values, parameters, input images, or media that belong to that example.

Supported targets include:

  • variable prompt workspace
  • multi-message context workspace
  • text-to-image workspace
  • image-to-image workspace
  • multi-image workspace

This is useful when a favorite was saved with a known-good test case and you want to continue from the same evidence instead of rebuilding the setup by hand.

How favorites and history should work together

A practical workflow is:

  1. keep iterating in the left workspace
  2. use history to preserve process versions
  3. once something is stable enough, save it to favorites
  4. later, reuse from favorites first, and only open history when you need to trace the process

Favorites vs data management

Use favorites import/export when

  • you only want to move selected items
  • you want to share a prompt collection
  • you want to keep your main environment clean

Use data management import/export when

  • you need a full backup
  • you need a full migration
  • you want to move models, templates, and history together

What else can be saved

The save-favorite dialog currently supports:

  • title
  • description
  • category
  • tags
  • feature mode
  • optimization mode for text workflows
  • sub-mode for image workflows
  • editing the main content
  • image upload
  • setting a cover image
  • removing attached images

That means a favorite can preserve not just text, but also a small media set related to the prompt.

About Prompt Garden

The current implementation also supports a pluggable preview area for favorites. Favorites can store prompt assets from different sources; when a favorite came from Prompt Garden, it can preserve the import code, source link, examples, and media snapshot.

If your deployment enables Prompt Garden integration, a favorite preview can also show extra external snapshot information and media content. This is optional and not a prerequisite for using favorites.

See Prompt Garden for details.

v2.10.0 New Features

Resource-Aware Assets

Favorites now support:

  • Version History: Track the evolution of prompts, view and restore historical versions
  • Reproducible Examples: Store test results and context for later reproduction and verification
  • Media Support: Images and cover images fully preserved

Source Binding

Favorites imported from Prompt Garden automatically record:

  • Import code
  • Source link
  • Import time

Facilitating later updates and source verification.

Complete Backup

Exporting a favorite resource package now packages referenced images and media resources together. Importing automatically restores resource references, no need to separately migrate image files.

Suitable for:

  • Migrating favorites with images
  • Complete backup of favorite collections
  • Sharing prompts with media

Practical suggestions

  • let history keep the process, and let favorites keep the result
  • write titles your future self can still understand
  • do not over-tag; use only the tags that help filtering
  • for image favorites, set a clear cover image for easier browsing
  • before sharing favorite JSON, check descriptions and media for sensitive information