# Shopify migration launch runbook

Replace every `REPLACE_ME`, remove example rows, and rehearse the sequence before launch day.

## Launch details

- Source store: REPLACE_ME
- Target Shopify store: REPLACE_ME
- Launch date and timezone: REPLACE_ME
- Launch lead: REPLACE_ME
- Business go/no-go owner: REPLACE_ME
- Technical go/no-go owner: REPLACE_ME
- Rollback decision owner: REPLACE_ME
- Team communication channel: REPLACE_ME
- Incident log: REPLACE_ME

## Go/no-go criteria

- [ ] Critical buying journeys pass in the release candidate.
- [ ] Required source and target totals reconcile within documented tolerances.
- [ ] Priority redirects have approved targets.
- [ ] Payments, tax, shipping, fulfillment, notifications, and analytics pass.
- [ ] Known defects have a severity, owner, and accepted business impact.
- [ ] Final migration and rollback windows still fit the approved timing.
- [ ] Business and technical owners record the go decision.

## Cutover sequence

| Order | Planned time | Owner | Action | Dependency | Verification | Rollback point | Status |
| --- | --- | --- | --- | --- | --- | --- | --- |
| 1 | REPLACE_ME | REPLACE_ME | Announce migration start and apply agreed content/data freeze | Go decision | Owners acknowledge freeze | Resume source operation | Not started |
| 2 | REPLACE_ME | REPLACE_ME | Export final source data delta | Freeze active | Counts and export files recorded | Repeat export | Not started |
| 3 | REPLACE_ME | REPLACE_ME | Transform and import final delta | Valid export | Import log reviewed; totals reconcile | Restore target snapshot or correct import | Not started |
| 4 | REPLACE_ME | REPLACE_ME | Apply and verify redirects | Final target URLs | Priority URL sample reaches one correct destination | Restore prior routing | Not started |
| 5 | REPLACE_ME | REPLACE_ME | Switch domain or routing | Store and certificates ready | Public domain loads secure target storefront | Revert DNS or routing | Not started |
| 6 | REPLACE_ME | REPLACE_ME | Run critical customer and operational checks | Target publicly reachable | All critical checks recorded | Invoke rollback decision | Not started |
| 7 | REPLACE_ME | REPLACE_ME | Announce launch and begin monitoring | Go-live checks pass | Team and stakeholders notified | Incident process takes over | Not started |

## Immediate validation

- [ ] Homepage, priority collection, product, content, cart, checkout, account, search, and 404 routes load.
- [ ] A real low-value order completes using each required payment path.
- [ ] Order confirmation, tax, shipping, inventory, fulfillment, email, and analytics behave as expected.
- [ ] Priority redirects return the expected permanent status and final destination.
- [ ] Canonicals, robots directives, sitemap, structured data, and consent behavior are correct.
- [ ] Monitoring, logs, alerts, support queue, and integration dashboards have named watchers.

## Monitoring windows

### First two hours

- Owner: REPLACE_ME
- Check frequency: REPLACE_ME
- Metrics and systems: checkout, payments, errors, inventory, fulfillment, analytics, redirects, support contacts

### First 24 hours

- Owner: REPLACE_ME
- Check frequency: REPLACE_ME
- Metrics and systems: traffic, conversion, revenue, 404s, integration failures, campaign landing pages, feeds

### First two weeks

- Owner: REPLACE_ME
- Check frequency: REPLACE_ME
- Metrics and systems: search visibility, crawl and indexing, landing-page performance, returns, reporting, merchant workflows

## Incident log

| Time | Severity | Symptom | Customer or operational impact | Owner | Decision or fix | Verified by | Status |
| --- | --- | --- | --- | --- | --- | --- | --- |
| REPLACE_ME | REPLACE_ME | REPLACE_ME | REPLACE_ME | REPLACE_ME | REPLACE_ME | REPLACE_ME | Open |

## Post-launch review

- [ ] Reconcile final records and revenue reporting.
- [ ] Review redirects, 404s, crawl behavior, and important search landing pages.
- [ ] Confirm obsolete source jobs and integrations can be disabled safely.
- [ ] Convert accepted defects and improvements into an owned backlog.
- [ ] Document decisions, surprises, and changes for the next release.