Configure brand knowledge and save Settings safely

Estimated reading: 3 minutes 2 views

The main Settings form is not autosaved. When you change manual brand knowledge or another setting in that form, Firefly opens Shopify’s native unsaved-changes bar at the top of Admin so you can choose Save or Discard.

Firefly Settings page with interface language and manual brand knowledge
Open Settings to manage interface language, approved brand context, and creation defaults.

Add manual brand knowledge

Open Settings → General, then use Manual brand knowledge to record concise, approved context such as:

  • the brand name, mission, positioning, and differentiated value;
  • product and collection facts, materials, specifications, and supported use cases;
  • target audiences, needs, and buying concerns;
  • the preferred voice, reading level, terminology, and example wording;
  • required disclaimers, prohibited claims, and subjects the writer must avoid;
  • messaging pillars, approved promises, taglines, and calls to action.

Use factual, current statements. Treat the field as source context for generation, not as a place to request unsupported claims.

Save with Shopify’s native bar

  1. Edit Manual brand knowledge or another field in the main Settings form.
  2. Shopify displays its unsaved-changes bar at the top of Admin.
  3. Choose Save in that bar. The on-page Save settings button submits the same main settings form.
  4. Wait for the success message before leaving the page. After the server confirms the save, the unsaved-changes bar closes.
Shopify unsaved-changes bar showing Save and Discard above Firefly Manual brand knowledge
Use Shopify’s native Save or Discard actions whenever the main Settings form has unsaved changes.

If saving fails, the bar remains available and the edited values stay on the page so you can correct the issue and retry.

Choose Discard when you want to restore all fields in the main form to their last loaded values. Shopify asks for discard confirmation before Firefly resets the form.

Interface language is saved separately

The Interface language panel has its own Save language button. Changing the interface language does not save pending brand knowledge or creation defaults, and saving the main Settings form does not submit an unconfirmed language change. Save or discard pending main-form edits before changing the interface language; Firefly disables the language action while a main settings save is in progress.

The interface language controls app labels. It does not change the language of generated articles; set the default content language separately or choose an article language in the AI writer.

Other main-form settings

Depending on the active plan, the same SaveBar-managed form can include:

  • default writing voice and content language;
  • local editor recovery autosave and version retention;
  • default search intent, article length, target audience, and image count;
  • fact-grounding controls and publishing approval enforcement;
  • Recipe structured-data synchronization;
  • optional custom text and image provider settings.

Plan-restricted values can be retained after a downgrade while their paid-only creation or editing behavior is unavailable. Follow the notice shown next to a restricted control.

Local autosave is not publishing

The Local autosave safeguard stores a browser recovery point after typing stops in the article editor. It does not publish an article and it does not replace the need to save main Settings changes through Shopify’s unsaved-changes bar.

Troubleshooting

  • No Save/Discard bar appears: make a change to a named field in the main Settings form, then wait briefly. The interface-language panel is separate and uses Save language.
  • The bar stays open after Save: read the error banner, correct the invalid or unavailable setting, and save again.
  • You left the page with unsaved edits: reopen Settings and check the stored value. Unsaved edits are not guaranteed to survive navigation.
  • Brand context is not used for an unrelated topic: Firefly selects topic-relevant knowledge. Add clear product and audience terms that match the intended article instead of unrelated general copy.
Share this Doc

Configure brand knowledge and save Settings safely

Or copy link

CONTENTS
Scroll to Top