Maintain / FAQ
Answers before a ticket is needed.
Start here for the most common Brass Archive setup, compatibility, update, and support questions.
Common questions
Practical answers, with the platform boundaries visible.
Where should I install Brass Archive from?
Install the public release through the Shopify Theme Store after it becomes available. Do not use a package copied from another store and do not redistribute the downloaded theme file.
Are the three design directions separate themes or presets?
No. Brass Archive has one install preset. Guided editorial, Technical catalog, and Visual journal are design directions selected in Theme settings → Appearance. They change hierarchy, density, media treatment, navigation, cards, and footer rhythm while preserving the same commerce foundation.
Why does a color option sometimes display text instead of a color?
Brass Archive uses Shopify's native swatch color or image when one exists, then supported merchant mappings. When neither exists, it keeps a visible text fallback instead of guessing. Review the swatch setup guide and verify every option remains labeled and keyboard selectable.
Why are collection filters or values missing?
Filters depend on the store's catalog data and Shopify's native filtering configuration. Configure the required product options, metafields, or category data, enable the intended filters in Shopify, and test the resulting collection. The theme does not invent missing filter values.
Does Brass Archive require third-party apps?
No app is required for core navigation, search, product selection, cart, checkout access, or documentation. Compatible app blocks can extend supported sections. App setup, billing, and app-specific defects remain the app provider's responsibility.
Where are llms.txt, llms-full.txt, and agents.md edited?
The theme editor shows their status without placing long technical prose in ordinary settings. Advanced content is maintained under Edit code in templates/llms.txt.liquid, templates/llms-full.txt.liquid, and templates/agents.md.liquid. See AI discovery files for the boundaries and validation steps.
Do AI discovery files guarantee rankings, citations, or sales?
No. They can make public storefront context clearer to compatible systems, but Shopify controls native request handling and external services decide what they crawl, index, cite, recommend, or use.
How should I update an existing store safely?
Keep a known-good unpublished copy, install the new release through Shopify's normal theme workflow, transfer merchant configuration carefully, and test home, collection, product, search, cart, account, password, gift-card, and 404 journeys on desktop and mobile before publishing. Custom code is not automatically transferred by a theme update.
What information should I include in a support request?
Include the permanent .myshopify.com URL, installed version, design direction, affected page, reproduction steps, expected result, actual result, browser, and device. Add one relevant screenshot if useful. Never include passwords, collaborator codes, API keys, payment data, order details, or customer personal data.
When will support reply?
The initial response target is within two business days. Reproducible defects that prevent normal storefront use or purchasing are prioritized. Resolution time depends on scope, reproduction quality, merchant changes, apps, and platform dependencies. Review the support policy before submitting.