When things don't work as expected
List is empty but I expect posts
Check the status filter (e.g. switch to "All" or "Published"). Clear advanced filters and search. Click Refresh to refetch from the server.
Inline edit didn't save
Look for a toast or error. If the API failed (e.g. permissions, validation), the grid may not update. Click Refresh to resync with the server.
Duplicate failed or new post not visible
Check the success toast and network tab for the duplicate API. If it succeeded but the row didn't appear, click Refresh. If you have filters on, the new post might be on another page or filtered out (e.g. if it's draft and you're viewing Published).
Column order or visibility reset
Column state is stored in localStorage per context and post type. Clearing site data or using another browser/profile will reset it. Use Column manager → Reset to defaults to restore the default set and then re-customize.
Wrong post type or wrong columns
Ensure the URL has the correct post_type (e.g. #/posts?post_type=page). The page title and columns are driven by that. If a custom type has no specific column config, the grid may fall back to a generic set.
Schema or custom fields not showing
The edit form and optional custom columns depend on schema and metadata. If your CPT or meta isn't exposed via the REST API or FleekDash schema endpoint, those fields won't appear. Check REST registration and schema discovery for your post type.
Summary
| Section | What it covers |
Overview | One grid for all post types; filters, search, inline edit, duplicate, column management, schema. |
Access | Menu and URL; post type from query param; loading of metadata, stats, posts, column state. |
Header | Title, WP mode, Refresh, Column manager, Add New. |
Filters | Status buttons with counts, advanced filters (author, labels, urgency), PostFilterAdd, search, clear. |
Grid | AG Grid, columns, renderers, pagination, page size persistence, virtualization, performance. |
Column management | Reorder, show/hide, rename, reset; per-context and per–post type persistence. |
Inline editing | Status, author, date, category, labels; API and cache update; dashboard sync. |
Row actions | Edit (Gutenberg), Duplicate, Delete (trash / press-hold). |
Quick duplicate | Server-side copy; new row in grid; optional scroll to top. |
Post types | URL and menu; column config and stats per type. |
Custom fields & schema | useFormSchema, PostEditForm, REST/schema; grid columns and form fields. |
Multiple views | Grid as default; PostsViews and DataController for grid/calendar/kanban. |
Caching | usePostsCache, TTL, invalidation on update/delete/refresh; events. |
Workflows | Approve pending, duplicate and edit, customize columns, filter + search. |
Tips | Empty list, inline not saving, duplicate visibility, column reset, post type, schema. |