Repository navigation
Description
Scope
Five pages under docs/user-guide/client-management/ over-reuse a small set of admin-list screenshots for content that should show modals, dialogs, frontend views, or per-customer pages.
| Page | Heaviest reuse |
|---|---|
account-page.md |
dashboard.png × 10, domains-list.png × 3, customers-list.png × 2 |
upgrading-a-plan.md |
memberships-list.png × 5, product-upgrades.png × 3 |
canceling-a-membership.md |
memberships-list.png × 6 |
downgrading-a-plan.md |
memberships-list.png × 3 |
client-websites.md |
customers-list.png × 6 |
Note: account-page.md is frontend — it documents what the customer sees on /account/, not the network admin. Most of the existing references to dashboard.png (a Network Admin dashboard image) are completely the wrong screen.
See the master tracking issue for the capture playbook.
Pages
docs/user-guide/client-management/account-page.md
This page must use frontend, customer-facing screenshots — the customer is logged in to their own subsite, not Network Admin.
- Set up a test customer with one active membership, one custom domain, billing address filled in.
- Capture (save under
static/img/frontend/account-*.png):Account menu in the customer dashboard→account-menu-entry.png(subsite WP-admin sidebar with "Account" highlighted).Customer account page overview→account-page-overview.png.Membership overview showing plan, amount, and billing details→account-membership-block.png.About This Site and Site Limits blocks showing plan limitations→account-site-limits.png.Billing Address section with Update button→account-billing-address.png.Update billing address form→account-billing-address-modal.png.Product site templates tab with template selection mode→ reuse the product editor capture from the Configuration issue (product-site-templates.pngif accurate).Change Site Template button on account page→account-change-template-button.png.Available site templates list for the plan→ reusesite-templates-list.pngif it shows the customer-facing picker; otherwise capture asaccount-template-picker.png.Site template switch confirmation dialog→account-template-switch-confirm.png.Custom Domains tab with Allow Custom Domains toggle→ reuse the product editor capture.Add Domain button on the account page→account-add-domain-button.png.DNS instructions shown when adding a custom domain→account-add-domain-instructions.png.Add New Domain Instructions setting in Domain Mapping→ wire in or recapturesettings-domain-mapping.png(Network Admin side).Custom domain name entry with primary domain option→account-add-domain-form.png.Change Password button on account page→account-change-password-button.png.Change password form with current and new password fields→account-change-password-form.png.Danger Zone with Delete Site and Delete Account options→account-danger-zone.png.Delete Site confirmation dialog→account-delete-site-confirm.png.Delete Account confirmation dialog→account-delete-account-confirm.png.
This page is a primary entry point for "what does my customer see"; the current Network Admin placeholders are actively misleading and should be the highest-priority fix in this section.
docs/user-guide/client-management/upgrading-a-plan.md
- Capture the upgrade flow from the customer's account page: pick a higher plan → confirm pro-rated charge → see new plan.
- Capture the corresponding Network Admin memberships view showing the upgraded membership.
- Capture the Product → Upgrades configuration tab if
product-upgrades.pngis no longer accurate.
docs/user-guide/client-management/canceling-a-membership.md
- Capture each step of cancellation from both admin and customer perspectives. The current 6 reuses of
memberships-list.pngshould become: list (1), individual membership view (1), cancel modal (1), confirmation (1), cancelled status in list (1), customer-facing cancellation in account (1). - Wire in orphan
membership-edit.png/membership-edit-full.pngif still accurate.
docs/user-guide/client-management/downgrading-a-plan.md
- Same approach as upgrading: three distinct captures (start, confirm, after).
docs/user-guide/client-management/client-websites.md
- Replace the 6
customers-list.pngreferences. Likely the doc actually wants: customer list (1), individual customer edit (customer-edit.pngorphan) (1), the customer's sites tab (1), site-edit screen (site-edit-full.pngorphan) (1), the customer's memberships tab (1), the customer's payments tab (1).
Existing orphan files relevant here
static/img/admin/customer-edit.pngstatic/img/admin/membership-edit.pngstatic/img/admin/membership-edit-full.pngstatic/img/admin/site-edit-full.pngstatic/img/admin/domain-edit.png
Acceptance criteria
account-page.mduses only frontend customer-side captures, not Network Admin screenshots.- No more than one reference to the same image per page (unless it's the same screen).
- Each existing orphan listed is either wired in (and accurate) or deleted.
Tracked by: master screenshot audit issue.
aidevops.sh v3.15.64 plugin for OpenCode v1.15.5 with claude-sonnet-4-6 spent 4d 9h and 383 tokens on this as a headless worker.
Activity
superdav42 commentedon May 19, 2026
Part of the screenshot audit tracked in #78 — see that issue for the shared capture playbook (wordpress.local:8080 / admin / admin, viewport, seed-data, file-naming conventions).
aidevops.sh v3.15.64 plugin for OpenCode v1.15.5 with claude-sonnet-4-6 spent 4d 9h and 383 tokens on this as a headless worker.
superdav42 commentedon May 19, 2026
Duplicate of #68 (Customer account page) for the
account-page.mdportion.The other four pages this issue surfaced —
upgrading-a-plan.md,canceling-a-membership.md,downgrading-a-plan.md,client-websites.md— are not yet covered by existing per-page issues. They have been transferred to the master gap-analysis comment on #64:#64 (comment)
Closing.