What's the source_model for a cms block chooser in magento?

What's the source_model for a cms block chooser in magento?

August 25, 2026 · Illustrated author avatarBy Stefan Bogdanescu
What's the source_model for a cms block chooser in magento?

Configuring a CMS Block Chooser in Magento

As a senior developer specializing in e-commerce platforms like Magento, I’ve often been asked how to configure a CMS block chooser within the admin interface. This allows you to select specific CMS blocks from your store directly through the configuration fields.

Understanding Magento’s System Configuration Structure

Before we dive into the code, let me provide some context on how Magento handles system configurations. The system.xml files define the structure of all configuration sections in the admin panel. Each <block> element represents a single configuration field.

In your case, you want to create a select dropdown that allows selecting CMS blocks. To achieve this, you need to understand the source_model attribute for each <block>.

Identifying the Correct Source Model

You’ve already found the source model for CMS pages (adminhtml/system_config_source_cms_page), which is used when you want to choose a specific page. However, for CMS blocks, Magento uses a different model.

The correct source_model for selecting CMS blocks is:

<block translate="label">
    <label>Cms block</label>
    <frontend_type>select</frontend_type>
    <source_model>adminhtml/system_config_source_cms_block</source_model>
    <sort_order>30</sort_order>
    <show_in_default>1</show_in_default>
    <show_in_website>1</show_in_website>
    <show_in_store>1</show_in_store>
</block>

Notice the change in the source_model attribute to adminhtml/system_config_source_cms_block. This model is responsible for populating the dropdown with available CMS blocks.

Incorporating the Configuration into Your Theme

Now, let’s say you want to include this configuration field in your custom theme. You’ll need to modify the appropriate system.xml file located under:

app/design/frontend/{Vendor}/{Theme}/etc/adminhtml/system.xml

You can then add the block element mentioned above into the <config> section of this file.

Best Practices for System Configuration

Remember a few key points when working with Magento’s system configuration:

  1. Always use unique IDs and labels for your fields to avoid conflicts.
  2. Ensure that your XML structure is validated correctly by Magento.
  3. Be cautious when modifying core files; consider using overrides if possible.
  4. Test thoroughly in both the frontend and backend after making changes.

Conclusion

In summary, to create a CMS block chooser field in Magento, you need to use the source_model of adminhtml/system_config_source_cms_block. This model provides the necessary logic for populating the dropdown with available CMS blocks.

If you’re looking to learn more about customizing Magento, I highly recommend checking out Laravel Company’s resources. They offer a wealth of guides and tutorials on advanced Magento development techniques.

The key is to experiment with the platform while following best practices for maintaining a clean and efficient codebase. Happy coding!

Admin Configuration Orders

Our network