Create admin front with a simple form via a module [Magento]

Create admin front with a simple form via a module [Magento]

September 15, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Create admin front with a simple form via a module [Magento]

Displaying a Simple Form in Magento Admin Without Modifying Theme Layout

As a new Magento developer, you’re likely eager to create admin front pages with forms directly from your extension. However, the restriction on modifying theme layout files can be a bit challenging. Let’s explore how to overcome this limitation and display a simple form in the backend without touching the user’s system.

Understanding the Layout Structure

Before we dive into the solution, it helps to understand Magento’s layout structure:

  1. layout folder: Located under app/design/frontend/package/theme/layout.
  2. local.xml: The main layout file where you’d normally define new blocks and their placement.

Since you can’t modify this user-specific folder directly, your extension needs a different approach.

Using Your Extension’s Layout XML

Instead of modifying the theme’s local.xml or base/default.xml files, create a custom layout XML within your own module. This allows you to define new blocks without touching the user’s system.

  1. In your module, navigate to view/adminhtml/layout.
  2. Create a new file, e.g., admin_form_page.xml.

Defining a New Block and Layout Update

Now let’s create a new block that will hold our form:

<layout xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:app/etc/layout.xsd">
    <update handle="default"/>

    <referenceBlock name="content">
        <block class="Magento\Framework\View\Element\Template"
               name="my_module_form_block"
               template="My_Module::form.phtml"/>
    </referenceBlock>
</layout>

In this example:

  • handle="default" ensures the block is included in all pages.
  • The new block is named my_module_form_block.
  • It uses a custom template located at view/frontend/templates/form.phtml.

Creating Your Simple Form

Now you need to create an HTML form that will be rendered by your PHTML file.

  1. Create a new file, e.g., form.phtml, under view/frontend/templates/.
  2. Add some simple HTML for your form:
<form action="<?php echo $block->getUrl('my_module/index/submit') ?>" method="post">
    <input name="some_field" type="text"/>
    <button type="submit">Submit</button>
</form>

Registering the Layout Update

Finally, you need to register your new layout file in config.xml:

<layout>
    <updates>
        <module_layout_module>
            <file>admin_form_page.xml</file>
        </module_layout_module>
    </updates>
</layout>

Conclusion

By following this approach, you can display a simple form in the Magento admin without modifying any user-specific files. This ensures your extension remains portable and doesn’t require access to the theme’s layout configuration.

Remember that you’ll need to handle the form submission logic within your module controller. For more advanced forms with validation, consider using Magento 2 forms.

Happy coding! Let me know if you have any further questions.

API Extensions Themes Admin

Our network