Skip to main content
Oro applications are configured through a combination of PHP attributes (applied to entity classes and controller methods) and YAML files placed in Resources/config/oro/. This reference section documents all available configuration options.

​
PHP attributes

#[Acl]

Protect a controller action with an ACL resource of a given type and permission.

#[AclAncestor]

Re-use an ACL resource defined elsewhere to protect a controller action.

#[Config]

Set default entity configuration values for security, ownership, dataaudit, and other scopes.

#[ConfigField]

Set default field-level configuration values for a specific entity field.

#[TitleTemplate]

Define the page title template for a controller action.

​
YAML configuration

Bundles' Configuration

Register and prioritize bundles for auto-discovery.

Access Control Lists

Declare ACL resources with type, class, permission, and controller bindings.

ACL Categories

Group ACL resources into categories shown on the role edit page.

Assets

Register CSS and JavaScript assets for the asset pipeline.

Dashboards

Define dashboard widgets and their configurations.

Datagrids

Configure data grids with columns, filters, sorters, and actions.

Entity Configuration

Set entity-level configuration options that supplement PHP attributes.

Navigation

Add menu items, breadcrumbs, and page titles to the navigation tree.

Placeholders

Insert dynamic blocks into Twig templates from any bundle.

JS Modules

Register AMD/RequireJS JavaScript modules.

Search Index

Configure which entity fields are indexed for the full-text search engine.

System Configuration

Add settings to the system configuration tree (admin UI settings pages).

Workflows

Define OroWorkflowBundle workflow definitions in YAML.

​
Configuration file locations

All Oro-specific YAML configuration files live under Resources/config/oro/ inside a bundle: 
src/Acme/Bundle/DemoBundle/Resources/config/oro/
├── acls.yml              # ACL resources
├── acl_categories.yml    # ACL categories
├── assets.yml            # CSS/JS assets
├── bundles.yml           # Bundle registration
├── dashboards.yml        # Dashboard widgets
├── datagrids.yml         # Data grid definitions
├── entity_config.yml     # Entity configuration
├── jsmodules.yml         # JavaScript modules
├── navigation.yml        # Navigation/menu items
├── placeholders.yml      # Twig placeholders
├── routing.yml           # Route imports
├── search.yml            # Search index config
├── system_configuration.yml  # System settings
└── workflows.yml         # Workflow definitions
See the Bundles documentation for a deeper dive into the system configuration tree.

Build docs developers (and LLMs) love

Get started for freeTalk to us