FuzeFront
▦
DO

Selection Lists

The values your organization's forms offer — your own lists, and the common lists FuzeFront provides to every organization.

Common
Include common lists
Name Key Visibility Your access Values Updated
Your organization · Acme Logistics · 3 loaded
Priority priority ◉ Organization ⑂ Fork ✎ You can edit 5 2 days ago
Lead sources lead-sources ◉ Organization Read-only 3 Sep 30
Warehouse zones warehouse-zones ○ Private ✎ You can edit 12 Sep 12
Common lists · provided by FuzeFront to every organization · 2 loaded
Yes / No yes-no ◎ Common Read-only 2 Aug 28
Work status work-status ◎ Common Read-only 6 Aug 28
priority is your organization's fork; a common list with the same key is not listed here. Show common lists only

The note is driven by a loaded row with forked_from set, and is deliberately source-neutral: the include_shared response carries no source-existence metadata, so a fork whose common source was purged (dangling forked_from, legal per design record §5) looks exactly like one that shadows a live common list. The copy therefore never says a common list “is hidden” or “replaced” — only that this row is a fork and that no common list with that key is listed. Whether one exists is answered on the fork's own page (frame 7 provenance).

Visibility filter set → shadowing off (administrator view)

The filter exists only while Include common lists is ON, so a choice other than Any always sends include_shared=true&visibility=…, which the service treats as “show me exactly these” and stops hiding common lists behind forks. Here: Common. The common Priority reappears next to the others. No grouping — the filter already is the group.

NameKeyVisibilityYour access
Priority priority ◎ Common Read-only
Yes / Noyes-no ◎ Common Read-only
Work statuswork-status ◎ Common Read-only

The filtered page does not mark which common lists your organization has replaced: it holds only platform rows, so the answer is not on the page, and guessing it from an earlier page would be wrong after any change. Opening a common list asks the service once (getEffectiveList(key)) and the detail says so — see “your organization uses its own version”.

States

Loading

Group headers are skeletons too — they appear with the rows, never before (no empty “Common lists” header flashing).

Error

Couldn't load lists

Nothing was changed. The toggle and filters keep their values for the retry.

Empty — common lists ON, nothing readable at all

No lists yet

Your organization has no lists, and no common lists are published. Create one to start offering values in forms.

+ New list

“+ New list” shows only after a successful load; a 403 on create is the approved 4.0.0 handling.

Empty — common lists OFF, no roles

No lists you have a role on

You can still read your organization's shared lists and the common lists — they're hidden by the toggle.

Common lists OFF — the visibility filter is removed and reset

Include common lists

Turning the switch OFF removes the visibility filter (not disabled — absent) and resets it to Any; the request is GET /v1/selection-lists?status=&cursor= with neither include_shared nor visibility. Without include_shared the result is only the lists you hold a role on and visibility merely filters that set — “Common” would always come back empty and “Organization” would silently omit every list you read through membership. Turning the switch back ON restores the filter at Any; a filter choice is never carried across the switch.

Feature flag OFF — fuzefront.selection-lists.shared-lists

NameKeyStatus
Warehouse zoneswarehouse-zonesactive

Absent, not disabled: no “Include common lists” switch, no visibility filter, no group rows, no Visibility or Your-access columns, no badges. Requests carry neither include_shared nor visibility — exactly the approved 4.0.0 index (selection-lists/01-list-index).

Test hooks: [data-frame='01-shared-index'] · [data-panel='list-index'] · [data-control='include-shared'] · [data-toolbar='list-index'][data-include-shared='false'] · [data-filter='visibility'] · [data-visibility-filter='platform'] · [data-group='own'] · [data-group='common'] · [data-source='platform'] · [data-badge='common'] · [data-badge='fork'] · [data-editable='false'] · [data-shadow-note='priority'] · [data-action='load-more'] · [data-state='loading'] · [data-state='empty'] · [data-state='empty-shared-off'] · [data-state='error'] · [data-state='flag-off'] · [data-action='retry']
Contract: GET /v1/selection-lists?include_shared=true&status=&cursor= (shadowing on) · ?include_shared=true&visibility=platform|org|private (shadowing off) · switch OFF: neither param. Rows read visibility, forked_from, editable; an absent editable renders no access marker (unknown ≠ read-only).
Tokens only — no raw hex, spacing or type outside tokens.css / frame.css.

Review · selection-lists-shared approve or reject each flow ↓
shared-readapproved · izzywdev
forkapproved · izzywdev
fork-provenanceapproved · izzywdev
visibilityapproved · izzywdev
effective-pickerapproved · izzywdev