docs: clarify Manage Sites Table and Grid modes

[bkatusic]

Summary

• replace outdated List terminology with the current Table mode label
• document Grid mode's experimental status, limited site actions, and WordPress.com screenshot dependency
• clarify that switching modes reloads the page and that the preference persists per user
• improve the existing screenshot alt text while retaining the source-verified image

Why

The page used terminology that no longer matches the MainWP Dashboard UI and omitted important Grid mode behavior and limitations. The updated guidance now follows the current local MainWP Dashboard implementation.

Validation

• verified Table/Grid rendering, mode switching, and persistence against the local MainWP Dashboard source
• confirmed the referenced screenshot exists and matches the current toggle placement
• ran focused MDX component and character checks
• ran git diff --check

mint dev was not run, per repository instructions.

Summary by CodeRabbit

• Documentation
  • Updated Manage Sites view-selection guidance to use Table/Grid terminology.
  • Added details about sortable table columns, Grid mode limitations, toggle placement, reload behavior, and choosing the appropriate view.
  • Included information about site screenshots and related display behavior.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
mainwp	🟢 Ready	View Preview	Jul 31, 2026, 4:14 PM

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 0cecf4d4-0d7a-4e08-a9f1-7b392d55160d

📥 Commits

Reviewing files that changed from the base of the PR and between 3c5b017 and 830ad88.

📒 Files selected for processing (1)

• dashboard/overview/choose-list-or-grid-view-for-manage-sites-table.mdx

Disabled knowledge base sources:

• Linear integration is disabled

You can enable these sources in your CodeRabbit configuration.

---

Walkthrough

The Manage Sites view-selection documentation now uses Table and Grid terminology. It describes sorting, screenshots, Grid limitations, screenshot queries, toggle behavior, reload behavior, and layout usage.

Changes

Manage Sites view documentation

Layer / File(s)	Summary
Table and Grid view guidance dashboard/overview/choose-list-or-grid-view-for-manage-sites-table.mdx	The page replaces List terminology with Table terminology and updates instructions for both views. It adds sortable column details, Grid limitations, screenshot query information, revised toggle and reload behavior, an updated image caption, and expanded usage guidance.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

• mainwp/docs#100: Updates related Manage documentation to match current Dashboard terminology and instructions.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs-review/choose-list-or-grid-view-for-manage-sites-table

---

_{Comment @coderabbitai help to get the list of available commands.}