Important

You are browsing documentation for version 5.1 of OroCommerce, supported until March 2026. Read the documentation for version 6.0 (the latest LTS version) to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Customize Products SKU Validation

The ‘/^[a-zA-Z0-9]*$/’ pattern is used for Product SKU validation by default. This pattern provides the possibility to save alphanumeric symbols with additional dash and underscore symbols. If you need to extend the default pattern for Product SKU Validation or make it stricter, override the oro_product.sku.regex_pattern parameter and the translation for the validation message.

Override Parameter oro_product.sku.regex_pattern

There are 2 ways to override the oro_product.sku.regex_pattern parameter in your own bundle:

1. Add the oro_product.sku.regex_pattern parameter to the Resources/config/services.yml file in your bundle.

   src/Acme/Bundle/DemoBundle/Resources/config/services.yml

   parameters:
       # ...
       oro_product.sku.regex_pattern: '/^[a-z]*$/'
   

2. Write appropriate CompilerPass in your bundle

   src/Acme/Bundle/DemoBundle/DependencyInjection/Compiler/OverrideProductSKUCompilerPass.php

   namespace Acme\Bundle\DemoBundle\DependencyInjection\Compiler;
   
   use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
   use Symfony\Component\DependencyInjection\ContainerBuilder;
   
   class OverrideProductSKUCompilerPass implements CompilerPassInterface
   {
       /**
        * @inheritDoc
        */
       public function process(ContainerBuilder $container)
       {
           $container->setParameter('oro_product.sku.regex_pattern', '/^[a-z]*$/');
       }
   }
   

   and register this CompilerPass in the build() method of the bundle class

   src/Acme/Bundle/DemoBundle/AcmeDemoBundle.php

   namespace Acme\Bundle\DemoBundle;
   
   use Acme\Bundle\DemoBundle\DependencyInjection\Compiler\OverrideProductSKUCompilerPass;
   use Symfony\Component\DependencyInjection\ContainerBuilder;
   use Symfony\Component\HttpKernel\Bundle\Bundle;
   
   class AcmeDemoBundle extends Bundle
   {
       /**
        * @inheritDoc
        */
       public function build(ContainerBuilder $container): void
       {
           parent::build($container);
   
           $container->addCompilerPass(new OverrideProductSKUCompilerPass());
       }
   }
   

Override the Validation Message

If you need to change the default ‘This value should contain only latin letters, numbers and symbols “-” or “_”.’ validation message, override the oro.product.sku.not_match_regex translation key. To do that, add the appropriate translation to the translations/validators.en.yml file in your bundle:

src/Acme/Bundle/DemoBundle/Resources/translations/validators.en.yaml

oro.product.sku.not_match_regex: This value should contain only latin letters in lower case.