Repository navigation
Description
For #64.
Problem
docs/user-guide/domain-mapping/how-to-configure-domain-mapping.md references 16 distinct concepts across two recycled images. Lines using settings-domain-mapping.png × 7 describe the installation-wizard sunrise.php step, two unrelated settings rows, the subsite-mapping permission, product-level domain settings, and hosting-integration settings. Lines using domains-list.png × 9 describe the admin domains list, the Add Domain modal, three different status states, the domain detail page, and four subsite-side mapping captures.
docs/user-guide/domain-mapping/how-to-configure-domain-mapping.md
L22 
L30 
L40 
L62 
L66 
L74 
L76 
L80 
L98 
L102 
L106 
L110 
L114 
L116 
L126 
L128 
L116 has a markdown collision with the following paragraph — fix during the edit pass.
Captures required
Setup: enable Ultimate Multisite domain mapping, configure at least two mapped domains (one in Ready state with SSL, one in Checking DNS), and have a customer subsite where domain mapping is allowed.
| # | Doc line | Capture target | New filename |
|---|---|---|---|
| 1 | L22 | Multisite installation wizard step showing the sunrise.php instructions | static/img/installation/multisite-wizard/wizard-sunrise.png |
| 2 | L30 | Settings → Domain Mapping with Enable Domain Mapping toggle | static/img/config/settings-domain-mapping-enable.png |
| 3 | L40 | Force Admin Redirect radio group, cropped | static/img/config/settings-domain-mapping-force-redirect.png |
| 4 | L62 | UM → Domains list with at least one Ready + one Checking DNS row | static/img/admin/domains-list.png (replace existing if stale) |
| 5 | L66 | Add Domain modal with domain-name + site fields visible | static/img/admin/domain-add-modal.png |
| 6 | L74 | Domains list highlighting a row transitioning Checking DNS → Ready | static/img/admin/domain-stage-checking.png |
| 7 | L76 | Domains list row with Ready status (close-up) | static/img/admin/domain-row-ready.png |
| 8 | L80 | Single domain detail page with stage / site / active / SSL options | static/img/admin/domain-edit.png (orphan exists — verify and wire in, otherwise overwrite) |
| 9 | L98 | Settings → Domain Mapping showing the "Allow subsite users to map domains" toggle | static/img/config/settings-domain-mapping-subsite-users.png |
| 10 | L102 | Product edit → Custom Domains tab with Allow Custom Domains toggle | static/img/config/product-custom-domains.png (already exists — verify) |
| 11 | L106 | Customer subsite Account page Domains metabox | static/img/account-page/domains-metabox.png |
| 12 | L110 | Customer subsite Add Domain modal with DNS instructions | static/img/account-page/add-domain-dns.png (share with #68) |
| 13 | L114 | Customer subsite Add Domain form with Primary domain option | static/img/account-page/add-domain-primary.png (share with #68) |
| 14 | L116 | Customer subsite Add Domain submit step — start of DNS verification | static/img/account-page/add-domain-submit.png |
| 15 | L126 | Settings → Integrations tab in UM settings | static/img/config/settings-integrations.png |
| 16 | L128 | Hosting-provider integration card on the Integrations tab | static/img/config/settings-integrations-hosting.png |
Capture at 1280×800, crop to the relevant card. Customer-side captures from a non-admin browser. < 200 KB.
Doc edit
Update every line in docs/user-guide/domain-mapping/how-to-configure-domain-mapping.md to its new path, fix the L116 markdown collision, and refine alt text. Share filenames with account-page.md (#68) where the same screen is referenced.
Done when
- All 16 new PNGs added.
-
docs/user-guide/domain-mapping/how-to-configure-domain-mapping.mdupdated, L116 fixed. - Orphan
domain-edit.pngeither wired in or overwritten. - Customer-side captures distinguishable from admin-side.
- PR opened with
Resolvesfor this issue andRef #64.
Activity
superdav42 commentedon May 19, 2026
Progress: 6/16 screenshots captured, 1 orphan wired. Markdown updated for all 16 references.
Completed (7):
Deferred (10):
L116 markdown collision (image + caption on same line) fixed.
Note: this version of UM (2.12.0) does not have a top-level 'Enable Domain Mapping' toggle on the Domain Mapping settings tab — the doc text refers to that toggle but the current UI uses Admin Redirect dropdown + Customer DNS Management toggle instead. Doc copy may need rewriting in a follow-up.
Commit: 917412f