How to Use Blade Component and Include Aliases

How to Use Blade Component and Include Aliases

In the Laravel 5.6.0 release Sebastian De Deyne contributed Blade component aliases and then in Laravel 5.6.4, he added a similar feature for Blade include aliases. Let’s go over how you can use both in your Laravel 5.6 projects!

Component Aliases

You define a component alias with a string to the template path as you would a typical @component, and the second argument is the name of the alias:

Blade::component('app.components.alert', 'alert');

Given the alias, usage in a template looks something like this:

@alert(['type' => 'danger'])

    You are not allowed to access this resource!

{{-- Instead of --}}

The first noticeable improvement of using component aliases is that your templates don’t need to change everywhere if you decide to relocate the component file:

Laravel @alert Blade component alias example

The second thing I like about Blade component aliases is that you don’t have to remember the location of the file when using them in your templates. On the other hand, you must find which aliases are defined (which isn’t hard, just use your AppServiceProvider::boot() method) to know what component aliases are available in a project.

Component aliases are convenient to avoid typing the full path to the component file and allows your components to look more expressive as directives.

Include Aliases

Blade include aliases are available as of Laravel 5.6.5. It’s the same thing as component aliases, but for @includes. It comes in handy for HTML that doesn’t have a slot:

@input(['type' => 'email'])

Given the above template usage, here’s how the include might look:

<input type="{{ $type ?? 'text' }}">

You register include aliases with the following:


You can optionally pass a second argument for the alias if you want to be more verbose about defining the alias:

{{-- What happens by default --}}
Blade::include('includes.input', 'input');

{{-- A custom include name --}}
Blade::include('includes.input', 'textinput');

You can learn more about Blade component aliases in the Components and Slots section of the documentation.

Filed in: Laravel 5.6 / Blade


Join the weekly newsletter and never miss out on new tips, tutorials, and more.

Laravel News Partners

Laravel Jobs

Senior PHP Developer (Full Stack | CakePHP | Laravel | Vue | jQuery)
Senior Laravel Developer (Full-Stack)
Volunteer Vision GmbH
Full-Stack Developer
Nu Image Medical
Senior Software Developer
Remote (US ONLY)/Kenilworth, NJ
Senior Back-end Laravel API Developer - Immediate Contract (Full Time)
ApproveMe // Document Signing
Web Development Project Manager
Houston, TX
Swyft Filings
Experienced Laravel/VueJS Developer (Freelance)
Remote (preferably in the US)
Prosperly LLC