Skip to content

Pixellating Images using Cloudinary and Next.js

This article demonstrates how to use Nextjs and Cloudinary to create an image pixelation transformation.
Cloudinary will enable us to achieve pixelation programmatically without designer apps using its own SDK tool.

Check the final demo on Codesandbox.

You can also find the GitHub repository using Github.

Entry-level javascript and React/Nextjs knowledge.

Cloudinary refers to an end-to-end image- and video-management tool for various websites and mobile applications. It constitutes a wide range of services including online storage, image, and video manipulations, optimizations e.t.c. In this article, we explore one of Cloudinary’s transformation capabilities, that is, the image pixelation feature.

For more on Cloudinary’s comprehensive APIs and administration capabilities, explore the following link.

Let’s begin!

Create a new nextjs project using npx create-next-app pixelate in your terminal. Head to the directory using cd pixelate.

We will handle all our code in the pages/index directory.

In order to create a cloudinary transformation, we need to import the @cloudinary/url-gen package, then pass the transformed image object to the cldImg attribute in your advancedImage component. The advancedImage component renders the image on your website.

Begin by installing the package dependencies

npm install @cloudinary/url-gen @cloudinary/react

Import them in the pages/index component.


import { Cloudinary } from "@cloudinary/url-gen";
import { AdvancedImage } from '@cloudinary/react';

For our transformations, we will require the fill and the pixelate action. Add them to your imports like below


import { Cloudinary } from "@cloudinary/url-gen";
import { AdvancedImage } from '@cloudinary/react';

import { fill } from "@cloudinary/url-gen/actions/resize";
import { pixelate } from "@cloudinary/url-gen/actions/effect";

With our imports ready, we can begin working on the root function. Start by creating a cloudinary instance and setting your cloud name


  const sample = new Cloudinary({
    cloud: {
      cloudName: 'demo'

Next, we include our image object. In our case, we will instantiate a Cloudinary image object using docs/models I’ll create two of them:

-` original` => Shows the original image version
-`pixelated` => Shows the pixelated version of the original image.

At this point, we can transform our image. The pixelation effect is very simple. Select the image you want to transform. In our case pixelated. Then add the transformation using the effective method.



We will also resize our images at this point. Use the following code to resize the images



We are ready to render our components. Add the code below in the return statement

    <div className="container">
      <h1>Pixellating Images using Nextjs and Cloudinary</h1>
      <div className="row">
        <div className="column">
          <AdvancedImage className="image" cldImg={original} type="fetch" />
        <div className="column">
          <AdvancedImage className="image" cldImg={pixelated} type="fetch" />

The code above will render the components in two separated columns of a single row. The view will be as follows:

complete UI

For more on the UI, css features check the GitHub repo provided at the start of the project.

That completes the project. Ensure to explore this article to enjoy the experience. Happy coding!

Back to top

Featured Post