Basic usage | image | Spatie

 SPATIE

  Image
========

spatie.be/open-source

  [Docs](https://spatie.be/docs)  [Image](https://spatie.be/docs/image/v1)  Usage  Basic usage

 Version   v3   v2   v1

 Other versions for crawler [v3](https://spatie.be/docs/image/v3) [v2](https://spatie.be/docs/image/v2) [v1](https://spatie.be/docs/image/v1)

- [ Introduction ](https://spatie.be/docs/image/v1/introduction)
- [ Postcardware ](https://spatie.be/docs/image/v1/postcardware)
- [ Installation and setup ](https://spatie.be/docs/image/v1/installation-and-setup)
- [ Questions & issues ](https://spatie.be/docs/image/v1/questions-and-issues)
- [ Changelog ](https://spatie.be/docs/image/v1/changelog)
- [ About us ](https://spatie.be/docs/image/v1/about-us)

Usage
-----

- [ Basic usage ](https://spatie.be/docs/image/v1/usage/basic-usage)
- [ Saving images ](https://spatie.be/docs/image/v1/usage/saving-images)
- [ Retrieving properties ](https://spatie.be/docs/image/v1/usage/retrieving-properties)
- [ Preparing manipulations ](https://spatie.be/docs/image/v1/usage/preparing-manipulations)
- [ Advanced manipulations ](https://spatie.be/docs/image/v1/usage/advanced-manipulations)

Image manipulations
-------------------

- [ Overview ](https://spatie.be/docs/image/v1/image-manipulations/overview)
- [ Resizing images ](https://spatie.be/docs/image/v1/image-manipulations/resizing-images)
- [ Optimizing images ](https://spatie.be/docs/image/v1/image-manipulations/optimizing-images)
- [ Adjustments ](https://spatie.be/docs/image/v1/image-manipulations/adjustments)
- [ Image canvas ](https://spatie.be/docs/image/v1/image-manipulations/image-canvas)
- [ Effects ](https://spatie.be/docs/image/v1/image-manipulations/effects)
- [ Watermarks ](https://spatie.be/docs/image/v1/image-manipulations/watermarks)

      You are viewing the documentation for **an older version** of this package. You can check the version you are using with the following command:

 `                                    composer show spatie/image                                                                                                                                                                                                                                    `

Basic usage
===========

###  On this page

1. [ Loading the image ](#content-loading-the-image)
2. [ Applying manipulations ](#content-applying-manipulations)
3. [ Saving the image ](#content-saving-the-image)

Loading the image
-----------------------------------------------------------------------------------------------------------

Load an image by calling the static `load` method on the `Image` and passing in the `$pathToImage`.

```
$image = Image::load(string $pathToImage);
```

Applying manipulations
--------------------------------------------------------------------------------------------------------------------------

Any of the [image manipulations](/image/v1/image-manipulations/overview) can be applied to the loaded `Image` by calling the manipulation's method. All image manipulation methods can be chained.

```
Image::load('example.jpg')
    ->sepia()
    ->blur(50)
    ->save();
```

![Sepia + blur manipulation](../images/example-sepia-blur.jpg)

Saving the image
--------------------------------------------------------------------------------------------------------

Calling the `save` method on an `Image` will save the modifications to the original file. You can save your modified image by passing a `$outputPath` to the `save` method.

```
Image::load('example.jpg')
    ->width(50)
    ->save('modified-example.jpg');
```

To save the image in a different image format or with a different jpeg quality [see saving images](/image/v1/usage/saving-images).