saleor-dashboard-lists
Skill1.1k starsChanged 8 days agoBSD-3-ClauseView on GitHub
Rules for Saleor Dashboard lists and tables: row selection and bulk actions, sorting, ConditionalFilter fields, pagination edge cases, counts and status columns. Use when building or fixing a datagrid list, a list inside a detail page (codes, variants, assigned items), a bulk delete or export, a sortable column, a filter field, or when auditing an existing list for bugs. Includes an audit checklist and how to verify in the browser.
Trending
Less talk lately.about the whole repository
Who's talking about saleor/saleor-dashboard
- saleor/saleor“Unable to update Company info from Dashboard”GitHub · May 31, 2022 · 2 reactions
- saleor/apps“Implement logo field in AppManifest”GitHub · Feb 22, 2023 · 1 reactions
- saleor/saleor“Support for payment transaction actions”GitHub · Aug 11, 2022 · 1 reactions
- saleor/saleor“feat(attribute): add staff-only internalDescription to Attribute”GitHub · Oct 15, 2026
- waelhe/app-java-v3“docs(admin): plan Saleor Dashboard adaptation for marketplace”GitHub · Oct 15, 2026
The biggest 5 of 50 mentions linking to the repository that our crawl found. Each line is their own headline.
See all 50
Talked about on GitHub (50 times).
On GitHub · 50
- May 31, 2022Unable to update Company info from Dashboard — saleor/saleor2 reactions · 3 comments
- Feb 22, 2023Implement logo field in AppManifest — saleor/apps1 reaction · 3 comments
- Aug 11, 2022Support for payment transaction actions — saleor/saleor1 reaction · 27 comments
- Oct 15, 2026feat(attribute): add staff-only internalDescription to Attribute — saleor/saleor0 reactions · 1 comment
- Oct 15, 2026docs(admin): plan Saleor Dashboard adaptation for marketplace — waelhe/app-java-v30 reactions · 3 comments
45 more on GitHub
- Jul 31, 2026feat(avatax): add tax code action to Dashboard command palette — saleor/apps0 reactions · 5 comments
- Jul 13, 2026Add reason for price override — saleor/saleor0 reactions · 1 comment
- Jul 8, 2026Improved Gift Card APIs — saleor/saleor0 reactions · 1 comment
- Jun 9, 2026[Feature] Support pasting boolean values in other that English — WillSmithTE/saleor-saleor-dashboard0 reactions · 1 comment
- Jun 9, 2026Fix Background task provider tests — WillSmithTE/saleor-saleor-dashboard0 reactions
- Jun 9, 2026Missing filter when calling exportGiftCards mutation for selected giftcards — WillSmithTE/saleor-saleor-dashboard0 reactions
- Jun 9, 2026Variant view, no scroll on warehouse list and only first 50 warehouses displayed for the user — WillSmithTE/saleor-saleor-dashboard0 reactions
- Jun 9, 2026[Bug]: `requestPasswordReset` mutation returns incorrect error when user is not staff user — WillSmithTE/saleor-saleor-dashboard0 reactions
- Jun 9, 2026Missed info about no access to the channels — WillSmithTE/saleor-saleor-dashboard0 reactions
- Jun 9, 2026 `create order` button should be disabled in case of no permissions — WillSmithTE/saleor-saleor-dashboard0 reactions
- Jun 9, 2026User can create group with permission from plugin but cannot assign members via UI — WillSmithTE/saleor-saleor-dashboard0 reactions
- Jun 9, 2026[Enhancement]: Misleading UI when charge is pending — WillSmithTE/saleor-saleor-dashboard0 reactions · 1 comment
- Jun 9, 2026[Bug]: Modal leave without saving after logout — WillSmithTE/saleor-saleor-dashboard0 reactions
- Jun 9, 2026[Feature]: Change navigation structure — WillSmithTE/saleor-saleor-dashboard0 reactions
- Jun 9, 2026[Bug]: Only first 50 warehouses are loaded in the grid — WillSmithTE/saleor-saleor-dashboard0 reactions
- Jun 9, 2026[Bug]: Weight rate create - not consistent error messages — WillSmithTE/saleor-saleor-dashboard0 reactions
- Jun 9, 2026[Bug]: Price rate and weight base availability button inactive — WillSmithTE/saleor-saleor-dashboard0 reactions
- Jun 9, 2026[Bug]: Changing attribute value on product triggers SKU fail — WillSmithTE/saleor-saleor-dashboard0 reactions
- Jun 9, 2026[Bug]: Restrict order weight in shipping method not saved — WillSmithTE/saleor-saleor-dashboard0 reactions
- Jun 9, 2026[Bug]: Datagrids jump to end when resizing column — WillSmithTE/saleor-saleor-dashboard0 reactions
- Jun 9, 2026Enable refunding specific product lines — WillSmithTE/saleor-saleor-dashboard0 reactions · 1 comment
- Jun 9, 2026[Bug]: Deleting variant attribute changes variant name — WillSmithTE/saleor-saleor-dashboard0 reactions · 1 comment
- Jun 9, 2026[Bug]: Column picker refinement — WillSmithTE/saleor-saleor-dashboard0 reactions
- Jun 9, 2026No information about required fields in product variant form — WillSmithTE/saleor-saleor-dashboard0 reactions
- Jun 9, 2026Error handling in product variant page - user can delete required field and still be able to save - then success banner shows up followed by error banner — WillSmithTE/saleor-saleor-dashboard0 reactions
- Jun 9, 2026[Bug]: Remove add product — WillSmithTE/saleor-saleor-dashboard0 reactions · 1 comment
- Jun 9, 2026[Bug]: Not all attributes are validated — WillSmithTE/saleor-saleor-dashboard0 reactions · 1 comment
- Jun 9, 2026[Bug]: Error label misplaced — WillSmithTE/saleor-saleor-dashboard0 reactions
- Jun 9, 2026[Bug]: Error messages missmatch — WillSmithTE/saleor-saleor-dashboard0 reactions
- Jun 9, 2026[Epic]: Improve UX flow for order refunds using Transactions API — WillSmithTE/saleor-saleor-dashboard0 reactions
- Jun 9, 2026[Bug]: Can not refund fulfilled order — WillSmithTE/saleor-saleor-dashboard0 reactions · 1 comment
- Jun 9, 2026[Bug]: Incorrect background in label cell — WillSmithTE/saleor-saleor-dashboard0 reactions
- Jun 9, 2026[Bug]: City and Postal code is getting cleared while modifying and saving the country field and country area in warehouse modification — WillSmithTE/saleor-saleor-dashboard0 reactions · 1 comment
- Jun 9, 2026[Bug]:Error displayed while selecting Category name header checkbox and click pagination in category Listing Page — WillSmithTE/saleor-saleor-dashboard0 reactions · 1 comment
- Jun 9, 2026[Bug]: dashboard not using all settings field in query (Can't set limitQuantityPerCheckout) — WillSmithTE/saleor-saleor-dashboard0 reactions · 1 comment
- Jun 3, 2026Add support for editorJS table syntax — saleor/saleor0 reactions · 1 comment
- May 5, 2026HOMEPAGE_WIDGETS types for manifest — saleor/app-sdk0 reactions · 2 comments
- Mar 25, 2026Fix LSP not loading `.js` and `.ts` files correctly — graphql/graphiql0 reactions · 5 comments
- Mar 13, 2026Add proper gift card events when gift card is used as a payment method — saleor/saleor0 reactions · 1 comment
- Mar 12, 2026Fix smoke tests - add prefix for artifact upload — saleor/apps0 reactions · 3 comments
- Mar 6, 2026Introduce password login mode — saleor/saleor0 reactions · 2 comments
- Mar 5, 2026Add SaleorGiftcardPaymentMethodDetails to transaction — saleor/saleor0 reactions · 2 comments
- Feb 25, 2026Fix failing smoke tests workflow — saleor/apps0 reactions · 3 comments
- Feb 13, 2026document payment method details in dashboard — saleor/saleor-docs0 reactions · 1 comment
- Feb 10, 2026Refund reasons phase 2 (POC) — saleor/saleor0 reactions · 1 comment
In this repository15 other files it gives its agents.
- AGENTS.mdAGENTS.md
- pinactSkill
- saleor-dashboard-cloud-extensionsSkill
- saleor-dashboard-detail-pagesSkill
- saleor-dashboard-entity-detailSkill
- saleor-dashboard-feedbackSkill
- saleor-dashboard-formsSkill
- saleor-dashboard-github-workflowsSkill
- saleor-dashboard-graphql-batchingSkill
- saleor-dashboard-loadingSkill
- saleor-dashboard-microcopySkill
- saleor-dashboard-pr-quality-checkSkill
- saleor-dashboard-security-auditSkill
- saleor-dashboard-smooth-shadowSkill
- saleor-dashboard-stylesSkill
The file
We split this skill into the rules it gives an agent
6 rules. About 0 are common, 3 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 48
Check the generated enum (src/graphql/types.generated.ts) for @deprecated sort fields.
- Distinctive: line 50
If a column id is also a URL key or a saved column setting, keep the key and change only the mapping, so bookmarks and saved settings keep …
- Distinctive: line 52
Test it by column title: build the columns, find the one titled "Name", and check the sort variables.
- Very specific: line 60
One row per field: when the API takes one value per field (the legacy filter inputs).
- Very specific: line 78
Test filters through the domain's create…QueryVariables with real FilterElements, and check the exact variables.
- Distinctive: line 121
Run through this for any list you build or touch:
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Saleor Dashboard Lists
Most list bugs found in an external QA benchmark of the voucher screens came from a few patterns that every list shares. Check each one when you build or fix a list.
Also see: saleor-dashboard-forms (saving,
dates, time zones), saleor-dashboard-loading (skeletons and empty states) and
saleor-dashboard-feedback (bulk action toasts), both in .claude/skills/.
1. Selection follows ids, not row positions
The shared Datagrid keeps its selection by row index. When the rows change after a
sort, a filter, a search, a page change or a refresh, the same positions now hold other
items. A bulk delete then sends the ids of items nobody picked.
- Clear the selection whenever the ids of the rows shown change: call
useClearRowSelectionOnRowsChange({ rows, clearRowSelection })fromsrc/hooks/useRowSelection.tsright after the list query. - Pass
rowsasundefinedwhile there is no data (query skipped or loading). Don't default it to[]for this call: a dialog can reload the filters and briefly skip the query, and the dialog still needs the selection. - A refetch that returns the same rows must keep the selection, so opening the delete dialog keeps working.
- The same applies to tables inside detail pages (codes, subcategories, assigned items) and to local (client-side) pagination.
- This is a workaround in every list. The root fix belongs in
Datagrid: keep the selection by row id, or clear it when the row ids change. That would cover every list, including grids that don't useuseRowSelection. Until then, a list that forgets the hook ships wrong-row bulk actions.
2. Each sortable column sorts by what it shows
- Map every column id to the API sort field that orders the value the column displays. A Name column that shows names must not sort by code.
- Check the generated enum (
src/graphql/types.generated.ts) for@deprecatedsort fields; a deprecated field can be ignored by the API. - If a column id is also a URL key or a saved column setting, keep the key and change only the mapping, so bookmarks and saved settings keep working.
- Test it by column title: build the columns, find the one titled "Name", and check the sort variables. This catches the mapping, not just the switch statement.
3. Filter fields match what the API accepts
ConditionalFilter turns rows into filter or where variables
(src/components/ConditionalFilter/).
- One row per field when the API takes one value per field (the legacy
filterinputs). Otherwise a second row silently replaces the first. SetmaxOccurrences: 1on the field inconstants.ts; multi-select rows already hold several values. This only hides the field in the add-row menu (OccurrenceLimiter). A URL or a saved preset can still hold two rows for the field, so merge or drop the extra rows when the filters load. - Dates go through a date builder. A bare
datetime-localvalue such as2025-01-31T16:24is read by the API as UTC.DateTimeRangeQueryVarsBuilderconverts it from the browser's time zone to UTC, but only for the field names in itsDATE_FIELD_NAMESlist. Add a new date field there, or it falls through toDefaultQueryVarsBuilderand is sent bare. - Date-only values are not converted to local time.
buildDateFilterparses2025-01-31withnew Date, which gives UTC midnight, not local midnight. A range on a date-only field (dateJoined) is off by the time-zone offset at both ends. Build local midnight (2025-01-31T00:00) when the edges matter. - Half-filled ranges. A "between" with one bound empty must not send
""; the API rejects the whole query and the list fails to load.buildDateFiltersends only the bound that is set; other range builders must do the same. - Test filters through the domain's
create…QueryVariableswith realFilterElements, and check the exact variables.
4. Pagination edge cases
- Emptied last page. Deleting or unassigning the only item on the last page must keep the pager and step back (or restart from page 1). An empty page that hides the pager strands the remaining items.
- Local pagination (drafts, assigned items before save): when every page is local,
use
useLocalPageInfowithclampToLastPageso a removal that empties the last page steps back. Leave it off when the pager continues past the local items into server pages: a saved voucher's codes run from local drafts into server codes, souseVoucherCodesPaginationkeeps it off by default. Pass the page info at the level the pager reads. - Cursor pagination after removals. Cached pages still list removed items; drop them
(see
dropCachedCodePagesinuseVoucherCodesServer.tsx) or restart from the first page. - Page size changes reset to the first page.
5. Counts and statuses come from one source
- Count each thing once. If drafts are both listed and kept in form state, count saved
items from the list (they have an
id) and drafts from the form, not both lists. - A status column must use every condition the API uses, not only dates. Example: a voucher whose usage limit is used up is not "Active", and the API's filter already calls it expired.
- Match the API's precedence, e.g. a voucher that hasn't started stays "Scheduled" even if its limit is used up.
6. Dialogs and URL state
- Mount pickers and filter dialogs only while they're open. Every picker on a page reads
the same numeric URL filter keys (
useUrlFilterStorehas no per-dialog keys), so a hidden dialog can throw on another dialog's filter. A picker that unmounts when it closes clears those keys (useModalFilterscallsuseClearModalFiltersOnUnmount), so filters don't carry over to the next picker. - Items in mixed collections (categories, collections, products, variants) have different
shapes. Never map one kind as another; branch on the tab or
__typename.
Audit checklist
Run through this for any list you build or touch:
- Select rows, then sort, filter, search and change page: the selection clears.
- Select rows, open the bulk action dialog: the count matches, and the request carries exactly the selected ids.
- Every sortable column orders by the value it shows (try both directions).
- Two rows for the same filter field are impossible, or both apply.
- Date filters in a non-UTC browser zone include the right items at the edges.
- A half-filled "between" range doesn't break the list.
- Deleting the only item on the last page keeps the pager and the other items.
- Counts in headers, tabs and checklists match the rows.
- Status columns agree with the API's own status filter.
- Loading shows skeletons, an empty result shows an empty state.
Verifying in the browser
Unit tests don't catch most of these. Script the check in a real browser against a local
API, as described in saleor-dashboard-forms ("Verifying in the browser", and section 5
for time zones). For lists, also:
- Never run destructive requests for real. Intercept the API URL with
page.route, let through only the operations the check needs (an allowlist), and record and abort every other mutation. A name pattern such asBulkDeletemissesVoucherDelete,VoucherCataloguesRemoveor a channel listing update that removes channels. - Change sort and filters through the URL (
history.pushStateplus apopstateevent) to reproduce what the column header and filter bar do. Confirm each case once through the real controls too: the filter bar can write a different URL than one typed by hand (a half-filled "between" writes an empty second bound).
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

