Create Thumbnail in Laravel Using Intervention Image Library

On the website, we always deal with the images. Based on the requirement we use different versions of images. It is a good practice for developers to create different versions aka thumbnails of the single image. These thumbnails can be used while displaying different sizes of images depending on the container size. Showing an image that fits as per container size will save bandwidth and improves a page load time. Showing a large size image in a small container is a bad practice and compromises page load time. As a result, it’s recommended to create multiple thumbnails of an image and use the appropriate version wherever necessary.

In this article, we study how to create a thumbnail in Laravel using the Intervention Image library. Intervention Image is free and one of the popular libraries for image manipulation. In the background, this library uses the GD Library and Imagick for image manipulation.

For this tutorial, I will create 3 thumbnails – small, medium, large with sizes 150*93, 300*185, 550*340 respectively. Change these sizes as per your requirement.

Getting Started

In order to get started, you need to first install the Intervention Image library in Laravel. Open the terminal in your project root directory and run the command below:

composer require intervention/image

After installing the library, open config/app.php file and add the following lines in it.

Add the service providers for this package in the $providers array.


Add the facade to the $aliases array.

'Image' => Intervention\Image\Facades\Image::class

Next, to store the images we need to create a directory. Head over to the terminal and run the command as follows:

php artisan storage:link

This command creates a storage directory(symbolic link) under the public folder. In this folder, I’ll upload the original image and its thumbnails.

Create a Thumbnail in Laravel

We all set with the basic setup and can now write the actual code. Let’s create a form in your view file.

<form action="{{ url('PASS_ACTION_URL') }}" method="post" enctype="multipart/form-data">
    <div class="form-group">
        <label for="exampleInputFile">File input</label>
        <input type="file" name="profile_image" id="exampleInputFile">
    {{ csrf_field() }}
    <button type="submit" class="btn btn-default">Submit</button>

In the controller, you need to add the library facade ‘Image’ which we have added in the config/app.php file.

namespace App\Http\Controllers;
use Illuminate\Http\Request;
use Image;
class ImageController extends Controller

By adding the facade, we are able to call functions of the Intervention Image library. In the below code, I will upload the image in two places. Original image goes directly inside the storage/profile_images folder. The thumbnails would be stored under storage/profile_images/thumbnail directory. We first upload the original image in the thumbnail folder and then resize it.

public function store(Request $request)
    if($request->hasFile('profile_image')) {
        //get filename with extension
        $filenamewithextension = $request->file('profile_image')->getClientOriginalName();
        //get filename without extension
        $filename = pathinfo($filenamewithextension, PATHINFO_FILENAME);
        //get file extension
        $extension = $request->file('profile_image')->getClientOriginalExtension();
        //filename to store
        $filenametostore = $filename.'_'.time().'.'.$extension;

        //small thumbnail name
        $smallthumbnail = $filename.'_small_'.time().'.'.$extension;

        //medium thumbnail name
        $mediumthumbnail = $filename.'_medium_'.time().'.'.$extension;

        //large thumbnail name
        $largethumbnail = $filename.'_large_'.time().'.'.$extension;

        //Upload File
        $request->file('profile_image')->storeAs('public/profile_images', $filenametostore);
        $request->file('profile_image')->storeAs('public/profile_images/thumbnail', $smallthumbnail);
        $request->file('profile_image')->storeAs('public/profile_images/thumbnail', $mediumthumbnail);
        $request->file('profile_image')->storeAs('public/profile_images/thumbnail', $largethumbnail);
        //create small thumbnail
        $smallthumbnailpath = public_path('storage/profile_images/thumbnail/'.$smallthumbnail);
        $this->createThumbnail($smallthumbnailpath, 150, 93);

        //create medium thumbnail
        $mediumthumbnailpath = public_path('storage/profile_images/thumbnail/'.$mediumthumbnail);
        $this->createThumbnail($mediumthumbnailpath, 300, 185);

        //create large thumbnail
        $largethumbnailpath = public_path('storage/profile_images/thumbnail/'.$largethumbnail);
        $this->createThumbnail($largethumbnailpath, 550, 340);
        return redirect('image')->with('success', "Image uploaded successfully.");

In the above code, I store the image with 3 formats small, medium, and large. After storing them we are calling the method createThumbnail and passing the required width, height to the method. Let’s define this function below. This function should go into the same Controller.

 * Create a thumbnail of specified size
 * @param string $path path of thumbnail
 * @param int $width
 * @param int $height
public function createThumbnail($path, $width, $height)
    $img = Image::make($path)->resize($width, $height, function ($constraint) {

Here we are resizing the image proportionally. Doing so, we keep the aspect ratio and the image will not cut off.

If you are looking for hard crop then replace below lines

$img = Image::make($path)->resize($width, $height, function ($constraint) {


$img = Image::make($path)->resize($width, $height)->save($path);

I hope you understand how to create a thumbnail in Laravel using the Intervention Image library. I would like to hear your thoughts in the comment section below.

Related Articles

If you liked this article, then please subscribe to our YouTube Channel for video tutorials.

6 thoughts on “Create Thumbnail in Laravel Using Intervention Image Library

  1. thank you sir this nice post , but i have one question how to use these thumbnails in img src path.

    Sorry I am new in laravel so plzzz kindly help me

  2. Also can you explain the bit bit where you upload the files…
    //Upload File
    $request->file(‘uploaded_file’)->storeAs(‘public/uploaded_files’, $filenametostore);
    $request->file(‘uploaded_file’)->storeAs(‘public/uploaded_files/thumbnail’, $smallthumbnail);
    $request->file(‘uploaded_file’)->storeAs(‘public/uploaded_files/thumbnail’, $mediumthumbnail);
    $request->file(‘uploaded_file’)->storeAs(‘public/uploaded_files/thumbnail’, $largethumbnail);

    But then you create the thumbnail?

    $smallthumbnailpath = public_path(‘storage/uploaded_files/thumbnail/’.$smallthumbnail);
    $this->createThumbnail($smallthumbnailpath, 150, 93);

    Seems backwards?


    1. This library only works with the image. For video, you may want to try another solution like FFmpeg.

Leave a Reply

Your email address will not be published. Required fields are marked *