PHPackages                             dutchheight/aws-serverless-image-handler - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File &amp; Storage](/categories/file-storage)
4. /
5. dutchheight/aws-serverless-image-handler

ActiveCraft-plugin[File &amp; Storage](/categories/file-storage)

dutchheight/aws-serverless-image-handler
========================================

Craft CMS plugin to generate resource URL

1.1.3(6y ago)74181[4 issues](https://github.com/dutchheight/aws-serverless-image-handler/issues)[1 PRs](https://github.com/dutchheight/aws-serverless-image-handler/pulls)proprietaryPHPCI failing

Since Jul 30Pushed 5y ago2 watchersCompare

[ Source](https://github.com/dutchheight/aws-serverless-image-handler)[ Packagist](https://packagist.org/packages/dutchheight/aws-serverless-image-handler)[ RSS](/packages/dutchheight-aws-serverless-image-handler/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (7)Dependencies (1)Versions (9)Used By (0)

Craft CMS AWS serverless image handler
======================================

[](#craft-cms-aws-serverless-image-handler)

[![All Contributors](https://camo.githubusercontent.com/4e96de37ea680371089642c8762ee051f42043eb64b50c4119a4e48970a2d434/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f616c6c5f636f6e7472696275746f72732d312d6f72616e67652e7376673f7374796c653d666c61742d737175617265)](#contributors)

Generates image handle from inside twig for AWS serverless image handler. [More info](https://aws.amazon.com/solutions/serverless-image-handler/)Automatically detects client webp support.

[![Flow](https://github.com/dutchheight/aws-serverless-image-handler/raw/master/resources/img/serverless.png "Flow")](https://github.com/dutchheight/aws-serverless-image-handler/blob/master/resources/img/serverless.png)

Requirements
------------

[](#requirements)

- This plugin requires Craft CMS 3.0.0-beta.23 or later.
- A working S3 volume is required. Use [Craft AWS S3](https://github.com/craftcms/aws-s3).
- A working cloudformation stack [For more info an instuctions](https://aws.amazon.com/solutions/serverless-image-handler/). (Instructions comming soon)

Installation
------------

[](#installation)

### S3

[](#s3)

1. Install S3 volume plugin Use [Craft AWS S3](https://github.com/craftcms/aws-s3). The following IAM Policy allow's craft to access your bucket:

```
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": [
                "s3:DeleteObject",
                "s3:GetObject",
                "s3:GetObjectAcl",
                "s3:GetBucketLocation",
                "s3:ListBucket",
                "s3:PutObject",
                "s3:PutObjectAcl"
            ],
            "Resource": [
                "arn:aws:s3:::bucket-name/*",
                "arn:aws:s3:::bucket-name"
            ]
        }
    ]
}

```

2. Create a volume with the following settings:
    - `Base URL` is your cloudfront url (\*.cloudfront.net)
    - `Access Key ID` is your IAM ID
    - `Secret Access key` is your IAM secret key
    - `Bucket name` is the name of your S3 bucket
    - `Bucket region` the region for exaple us-east-1
    - `Make Uploads Public` false
    - `Focal point` false

### AWS serverless image handler

[](#aws-serverless-image-handler)

After setting up the S3 volume follow these instructions to install the plugin.

1. Open your terminal and go to your Craft project:

    ```
     cd /path/to/project

    ```
2. Then tell Composer to load the plugin:

    ```
     composer require dutchheight/aws-serverless-image-handler

    ```
3. In the Control Panel, go to Settings → Plugins and click the “Install” button for AWS Serverless Image Handler.
4. Add `Toggle aws image processor` to your s3 volume field layout.

Usage
-----

[](#usage)

In your twig template you can use:

```
{% set settings = {
    width: 2600,
    height: 450
} %}

{{ craft.awsserverlessimagehandler.getImgUrl(entry.slider.one(), settings) }}
```

This will generate the propper URL for the asset.

If you load the image with `asset.url` the original source will be served.

### Availible settings

[](#availible-settings)

PropertiesValuesDefaultNotewidthpx value in `number``1980px`heightpx value in `number``null`Leave blank to keep ratiofit`cover`, `contain`, `fill`, `inside` or `outside``cover`position`top`, `right top`, `right`, `right bottom`, `bottom`, `left bottom`, `left` or `left top``focalpoint`flip`true`, `false``false`flop`true`, `false``false`rotationBetween `0` and `360``0`blurBetween `0.5` and `1000``0`greyscale`true`, `false``false`Contributing
------------

[](#contributing)

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. Please make sure to update tests as appropriate.

Extra information
-----------------

[](#extra-information)

For more info about AWS serverless image handler and other ways to use AWS SIH with Craft CMS take a look at: [Setting up your own image transform service](https://nystudio107.com/blog/setting-up-your-own-image-transform-service)

License
-------

[](#license)

[Craft](https://craftcms.github.io/license/)

Contributors ✨
--------------

[](#contributors-)

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

  [![Andrew Menich](https://avatars2.githubusercontent.com/u/29585821?v=4)
**Andrew Menich**](https://andrewmeni.ch)
[💻](https://github.com/dutchheight/aws-serverless-image-handler/commits?author=andrewmenich "Code") This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance9

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 86.2% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~43 days

Recently: every ~62 days

Total

7

Last Release

2214d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e369e37a9a4a6c7b1ef351d762649e6cbb2267cb8a0d245778a362ecfa52a916?d=identicon)[dutchheight](/maintainers/dutchheight)

---

Top Contributors

[![KevinBeckers](https://avatars.githubusercontent.com/u/4037137?v=4)](https://github.com/KevinBeckers "KevinBeckers (25 commits)")[![allcontributors[bot]](https://avatars.githubusercontent.com/in/23186?v=4)](https://github.com/allcontributors[bot] "allcontributors[bot] (2 commits)")[![andrewmenich](https://avatars.githubusercontent.com/u/29585821?v=4)](https://github.com/andrewmenich "andrewmenich (2 commits)")

---

Tags

cmsCraftcraftcmscraft-pluginaws-serverless-image-handler

### Embed Badge

![Health badge](/badges/dutchheight-aws-serverless-image-handler/health.svg)

```
[![Health](https://phpackages.com/badges/dutchheight-aws-serverless-image-handler/health.svg)](https://phpackages.com/packages/dutchheight-aws-serverless-image-handler)
```

###  Alternatives

[superbig/craft3-beam

Generate CSVs and XLS files in your templates

1933.9k](/packages/superbig-craft3-beam)[servd/craft-remote-assets

Move CP assets to an external filesystem such as S3

1215.8k](/packages/servd-craft-remote-assets)[olivierbon/craft-squeeze

Zip one or multiple craft assets on the fly for frontend user to download.

137.5k](/packages/olivierbon-craft-squeeze)[weareferal/remote-backup

Backup your database and assets to a remote location

125.5k](/packages/weareferal-remote-backup)[venveo/craft-compress

Create smart zip files from Craft assets on the fly

124.6k](/packages/venveo-craft-compress)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
