extends-grid

Extend an existing Sylius Grid

Customize a Sylius core grid (e.g. sylius_admin_product, sylius_admin_customer, sylius_admin_product_review) without replacing it. Sylius merges the override on top of the inherited definition — only declare the keys you change.

Not for new grids — use /sylius-app:add-grid instead.

1. Identify the target grid

Ask the user for the grid alias if not provided. Inspect the current definition:

bin/console sylius:debug:grid {alias}

Run without an argument to get an interactive list of all registered grids — useful when the exact alias is unknown.

Read the output before writing: override keys must exactly match existing field/filter/action names. Setting enabled: false on a key that does not exist is a silent no-op.

2. Write the override

File location matches the rest of the project: config/packages/grids/{alias}.yaml (e.g. sylius_admin_product.yaml). Naming the file after the alias keeps overrides self-documenting.

Assumes config/packages/_sylius.yaml already imports grids/*.yaml at its top. If not, run /sylius-app:add-grid once to scaffold it.

Only include the keys being modified — everything else stays inherited.

Hide a field / filter / action

sylius_grid:
    grids:
        sylius_admin_product_review:
            fields:
                title:
                    enabled: false
            filters:
                title:
                    enabled: false
            actions:
                item:
                    delete:
                        enabled: false

Reorder fields

position: N controls display order (lower = earlier). Declare it on the fields to reorder.

sylius_grid:
    grids:
        sylius_admin_product_review:
            fields:
                status:
                    position: 1
                rating:
                    position: 2
                author:
                    position: 3

Change a label

sylius_grid:
    grids:
        sylius_admin_product_review:
            fields:
                date:
                    label: app.ui.product_review.date