Skip to main content


Cropping an image before its uploaded is a common task but not necessarily easy to accomplish. With Uploady, its actually quite simple. This guide shows how to do this by tapping into the upload flow of Uploady. After the user chooses the file(s) to upload, the REQUEST_PRE_SEND event can be used to augment/change the data that will be sent to the server. This is the perfect time to allow the user to crop their image and replace the selected file with the crop action result.

For this guide, we use @rpldy/upload-preview together with the withRequestPreSendUpdate HOC. upload-preview allows us to use a custom preview component and withRequestPreSendUpdate makes it easy to intercept the upload data and change it when we're ready.

Use of upload-preview isn't mandatory, of course. It simply makes it easier as it loads a preview of the uploaded image for us. It also provides the batch item id which is needed for withRequestPreSendUpdate.


First we define our preview with crop component, wrapping it with withRequestPreSendUpdate. We use react-image-crop for the cropping functionality.

import React, { useState, useCallback, useRef } from "react";
import ReactCrop from "react-image-crop";
import { withRequestPreSendUpdate } from "@rpldy/uploady";
import { PREVIEW_TYPES } from "@rpldy/upload-preview";
import cropImage from "./my-fancy-canvas-cropper";

const ItemPreviewWithCrop = withRequestPreSendUpdate((props) => {
const { url, isFallback, updateRequest, requestData } = props;
const [crop, setCrop] = useState(null);
const imgRef = useRef(null);

const onUploadCrop = useCallback(async() => {
if (updateRequest && (crop?.height || crop?.width)) {
requestData.items[0].file = await cropImage(imgRef.current, requestData.items[0].file, crop);;
updateRequest({ items: requestData.items });
}, [imgRef, requestData, updateRequest, crop]);

const onLoad = useCallback((img) => {
imgRef.current = img;
}, []);

return isFallback || type !== PREVIEW_TYPES.IMAGE ?
<img src={url} alt="fallback img"/> :
{requestData ? <ReactCrop
/> : null}
<button style={{ display: updateRequest && crop ? "block" : "none" }}
Upload Cropped


When a fallback image is used (ex: when uploading non-image) we dont render the crop.


Implementation of the cropImage function can be found here.

Then we define our "app" with Uploady, an UploadButton and UploadPreview. We use our own ItemPreviewWithCrop as the PreviewComponent instead of the default one UploadPreview provides.

import React from "react";
import Uploady from "@rpldy/uploady";
import UploadButton from "@rpldy/upload-button";
import UploadPreview from "@rpldy/upload-preview";

export const App = () => {
return <Uploady
destination={{ url: "" }}>