Skip to content

docs: explain the shop ID choice for staging copies - #2689

Open
Aydin Hassan (AydinHassan) wants to merge 3 commits into
mainfrom
docs/shop-id-staging-advice
Open

Aydin Hassan (AydinHassan) wants to merge 3 commits into
mainfrom
docs/shop-id-staging-advice

Conversation

@AydinHassan

@AydinHassan Aydin Hassan (AydinHassan) commented Nov 2, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • Staging page: the warning for setups without staging mode now uses bin/console app:shop-id:change uninstall-apps. Deleting core.app.shopId no longer resets the shop ID, since Shopware reads core.app.shopIdV2 first.
  • Staging page: new section "If Shopware asks about the shop ID", mapping each option in the Administration to its app:shop-id:change strategy and when to use it, with a warning against Keep the shop identifier on a copy.
  • Secret Rotation & Recovery: the warning about cloned shops points to staging mode.
  • App Registration & Backend Setup: the detection section describes the fingerprints, their scores and the threshold of 75, and the strategies use their names from the Administration and the command.

Related links

Checklist

  • I reviewed affected links, code samples, and cross-references, including PageRef references where relevant.
  • I added or updated redirects in .gitbook.yaml if pages were moved, renamed, or deleted.
  • I updated .wordlist.txt (and sorted it) if spellcheck flags new legitimate terms.
  • I listed every dependent pull request that is not merged yet under Dependent PRs below.
  • Dependent changes that must be released, not only merged, before this documentation goes live have been published.
  • This pull request is ready for review.

Dependent PRs

Notes

@shopware-dev-docs-connector

shopware-dev-docs-connector Bot commented Nov 2, 2026 •

Copy link
Copy Markdown

Developer Docs healthcheck

Status: Completed with success.
Repository: shopware/docs
Commit: b9d670a
Preview: https://developer-documentation-2k9mcun2r-shopware-frontends.vercel.app
Workflow run: #5940

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants