add-autocomplete

Add an Autocomplete Type for a Sylius Resource

This skill is for exposing a resource as an autocomplete in a form. For a grid filter, use ux_autocomplete / ux_translatable_autocomplete directly in the grid YAML (see /sylius-app:add-grid) — no custom form type needed.

Ask the user for:

• ModelName: the resource to make searchable (e.g. Article)
• TargetModelName: the existing Sylius entity whose form should receive the field (e.g. Product). Optional — skip steps 3–4 if not provided.

Read src/Entity/{ModelName}/{ModelName}.php to detect the entity's fields and whether it uses TranslatableTrait.

Prerequisites: /sylius-app:add-model (and /sylius-app:add-translatable-model if applicable) must have been run first.

Key rules

For translatable entities (uses TranslatableTrait)

• Use TranslatableAutocompleteType as parent
• Always set entity_fields: [] in extra_options — the default is ['code'], which crashes if the entity has no code field
• Set translation_fields to the actual translated field names (e.g. ['title'])
• Set choice_label directly via $resolver->setDefault('choice_label', fn(Options $options) => ...) — NOT inside extra_options

For non-translatable entities

• Use BaseEntityAutocompleteType as parent
• Set searchable_fields via $resolver->setDefault('searchable_fields', fn(Options $options) => [...])

Always

• Inject the model class via constructor (%app.model.{model_snake}.class%)
• Register explicitly in services.yaml with both form.type and ux.entity_autocomplete_field tags — PHP attributes alone are not enough without autoconfigure
• filter_query is a PHP callable — it can NOT be passed via extra_options (only scalars/arrays travel via URL). Define it inside configureOptions instead.

1. Create the AutocompleteType

Translatable entity

src/Form/Type/{ModelName}/{ModelName}AutocompleteType.php:

<?php

declare(strict_types=1);

namespace App\Form\Type\{ModelName};

use Doctrine\ORM\QueryBuilder;
use Sylius\Bundle\AdminBundle\Form\Type\TranslatableAutocompleteType;
use Sylius\Bundle\ResourceBundle\Doctrine\ORM\EntityRepository;
use Symfony\Component\Form\AbstractType;
use Symfony\Component\OptionsResolver\Options;
use Symfony\Component\OptionsResolver\OptionsResolver;
use Symfony\UX\Autocomplete\Form\AsEntityAutocompleteField;

#[AsEntityAutocompleteField(
    alias: 'app_{model_snake}',
    route: 'sylius_admin_entity_autocomplete',
)]
class {ModelName}AutocompleteType extends AbstractType
{
    public function __construct(private readonly string ${model_snake}Class)
    {
    }

    public function configureOptions(OptionsResolver $resolver): void
    {
        $resolver->setDefaults([
            'class' => $this->{model_snake}Class,
            'extra_options' => [
                'entity_fields' => [],                          // ⚠️ required if entity has no 'code' field
                'translation_fields' => ['{label_field}'],     // translated fields to search in
            ],
            // filter_query must be defined here — NOT via extra_options (no callables via URL)
            // 'filter_query' => function (QueryBuilder $qb, string $query, EntityRepository $repository): void {
            //     $qb->andWhere('entity.enabled = :enabled')->setParameter('enabled', true);
            // },
        ]);

        $resolver->setDefault('choice_label', function (Options $options): string {
            return $options['extra_options']['choice_label'] ?? '{label_field}';
        });
    }

    public function getBlockPrefix(): string
    {
        return 'app_{model_snake}_autocomplete';
    }

    public function getParent(): string
    {
        return TranslatableAutocompleteType::class;
    }
}