Borders and Effects

You can add a number of borders and effects to your images with Filestack.

Note: The maximum accepted image size is 100,000,000 pixels. An image with this many pixels could have width and height combinations like 10,000 x 10,000 or 5,000 x 20,000, etc. There is also a file size restriction. Filestack will not convert an image that is larger than 256mb. Please contact us if you require the ability to process larger files than our current limits.

Task Quick Jump:

Rounded Corners Vignette Polaroid Torn Edges Shadow Circle Border


Rounded Corners

Rounded Corners URL Format:
https://process.filestackapi.com/rounded_corners=[options]/Filestack_FileLink_Handle
or
https://process.filestackapi.com/<API_KEY>/rounded_corners=[options]/File_URL

rounded_corners
String

The root task cannot be abbreviated

Users can use rounded_corners without any options and the default settings will be used.
rounded_corners=radius:1 to 10000 or max
Integer or String

Can be abbreviated as r:100

The radius of the rounded corner effect on your image. The value for this parameter can be any integer in a range from 1 to 10000, or the string 'max'. The default value for this parameter is 10% of the shortest side of the image.
rounded_corners=blur:0 to 20
Float

Can be abbreviated as l:0.3

Specify the amount of blur to apply to the rounded edges of the image. This parameter will accept any float in a range from 0 to 20. The default blur setting is 0.3.
rounded_corners=background:white or FFFFFFFF
String

Can be abbreviated as b:black

Sets the background color to display where the rounded corners have removed part of the image. This can be the word for a color, or the hex color code. The default value is white. Click here for a list of accepted colors names.

Rounded Corner Examples

Original Image


Image using all the default settings rounded_corners:

image transformed with rounded corners and default settings

Image with the rounded corner radius set to max radius:max:

image transformed with rounded corners and radius parameter set to max

Image with rounded corner blur set to 20 blur:20:

image transformed with rounded corners and blur parameter set to highest level

Image with background color set to black background:000000FF:

image transformed with rounded corners and background color of image set to black

Image with all rounded corner parameters background:000000FF,blur:20,radius:100:

image transformed with rounded corners and blur, radius and background color settings all used together

Vignette

Vignette URL Format:
https://process.filestackapi.com/vignette=[options]/Filestack_FileLink_Handle
or
https://process.filestackapi.com/<API_KEY>/vignette=[options]/File_URL

vignette=amount:0 to 100
Integer

Can be abbreviated as a:20

Controls the opacity of the vignette effect.

The default value for this parameter is 20. The lower the value the more opaque the vignette effect. The greater the value provided, the greater the transparency of the blur effect around the image.
vignette=blurmode:linear or gaussian
String

Can be abbreviated as m:gaussian

Controls the type of blur applied to the vignette - linear or gaussian. The vignette effect uses gaussian blur by default because it produces a more defined vignette around the image. Specifying linear is faster, but produces a less-defined blur effect, even at higher amounts.
vigette=background:white or FFFFFFFF
String

Can be abbreviated as b:black

Replaces the default transparent background with the specified color. This can be the word for a color, or the hex color code. Click here for a list of accepted color names..

Original Image

original image to be transformed with Filestack's vignette filter

Photo by Laitche, CC BY-SA 4.0, https://commons.wikimedia.org/w/index.php?curid=46858220


Vignette using amount:50:

image transformed with polaroid effect and default settings

Image with amount:100,blurmode:gaussian:

image transformed with polaroid effect and default settings

Image with amount:100,blurmode:linear:

image transformed with polaroid effect and default settings

Polaroid

Polaroid URL Format:
https://process.filestackapi.com/polaroid=[options]/Filestack_FileLink_Handle
or
https://process.filestackapi.com/<API_KEY>/polaroid=[options]/File_URL

polaroid
String

The root task cannot be abbreviated

Users can use polaroid without any options and the default settings will be used.
polaroid=color:white or FFFFFFFF
String

Can be abbreviated as c:black

Sets the polaroid frame color. This can be the word for a color, or the hex color code. The default value is snow. Click here for a list of accepted colors names.
polaroid=rotate:0 to 359
Integer

Can be abbreviated as r:90

The degree by which to rotate the image clockwise. This can be an integer in a range from 0 to 359. Note: the default rotation of the polaroid effect is random. So setting the rotation will provide a consistent look.
polaroid=background:white or FFFFFFFF
String

Can be abbreviated as b:black

Sets the background color to display behind the polaroid if it has been rotated at all. This can be the word for a color, or the hex color code. The default value is white. Click here for a list of accepted colors names.

Polaroid Examples

Original Image


Image using all the default settings (rotation is random unless explicitly set) polaroid:

image transformed with polaroid effect and default settings

Image with the polaroid rotation set to 15 rotate:15:

image transformed with polaroid effect and rotation set to 15 degrees clockwise

Image with polaroid frame color set to black color:black:

image transformed with polaroid effect and polaroid border set to black

Image with polaroid background color set to black background:000000FF:

image transformed with polaroid effect and background color set to black

Image with all polaroid parameters background:000000FF,color:blue,rotate:15:

image transformed with polaroid effect and all effect parameters in use

Torn Edges

Torn Edges URL Format:
https://process.filestackapi.com/torn_edges=[options]/Filestack_FileLink_Handle
or
https://process.filestackapi.com/<API_KEY>/torn_edges=[options]/File_URL

torn_edges
String

The root task cannot be abbreviated

Users can use torn_edges without any options and the default settings will be used.
torn_edges=spread:[10,50]
Array

Can be abbreviated as s:[15,35]

Sets the spread of the tearing effect. The values must be an array of two integers in a range from 1 to 50. The default setting is spread:[1,10].
torn_edges=background:white or FFFFFFFF
Array

Can be abbreviated as b:black

Sets the background color to display behind the torn edge effect. This can be the word for a color, or the hex color code. The default value is white. Click here for a list of accepted color names.

Torn Edges Examples

Original Image

original image to be transformed with torn edges effect

Image using all the default settings torn_edges:

image transformed with torn edges effect with default settings

Image with the torn edges spread set to spread:[5,20]:

image transformed with torn edges effect and spread parameter increased

Image with torn edges background color set with background:black:

image transformed with torn edges effect and black background

Image with both torn edges parameters set using background:000000FF,spread:[15,45]:

image transformed with torn edges effect and background and spread parameter set

Shadow

Shadow URL Format:
https://process.filestackapi.com/shadow=[options]/Filestack_FileLink_Handle
or
https://process.filestackapi.com/<API_KEY>/shadow=[options]/File_URL

shadow
String

The root task cannot be abbreviated

Users can use shadow without any options and the default settings will be used.
shadow=blur:10
Integer

Can be abbreviated as l:4

Sets the level of blur for the shadow effect. The value must be an integer in a range from 0 to 20. The default setting is blur:4.
shadow=opacity:35
Integer

Can be abbreviated as o:60

Sets the opacity level of the shadow effect. The values must be an integer in a range from 0 to 100. The default setting is opacity:60.
shadow=vector:[25,25]
Array

Can be abbreviated as v:[25,25]

Sets the vector of the shadow effect. The values must be an array of two integers in a range from -1000 to 1000. These are the X and Y parameters that determine the position of the shadow. The default setting is vector:[4,4].
shadow=color:white or FFFFFFFF
String

Can be abbreviated as c:black

Sets the shadow color. This can be the word for a color, or the hex color code. The default value is black. Click here for a list of accepted color names.
shadow=background:white or FFFFFFFF
String

Can be abbreviated as b:black

Sets the background color to display behind the image, like a matte the shadow is cast on. This can be the word for a color, or the hex color code. The default value is white. Click here for a list of accepted color names.

Shadow Effect Examples

Original Image

original photo to transform with the shadow effect

"Dead Vlei 4" by Ikiwaner Licensed under GFDL 1.2 via Commons.


Image using all the default shadow settings shadow:

photo transformed with shadow effect default settings

Image with the shadow blur parameter set to 15 and vector set to [25,25] blur:15,vector:[25,25]:

image transformed with shadow effect and blur and vector parameters set

Image with shadow opacity parameter set to 95 and vector set to [25,25] opacity:95,vector:[25,25]:

image transformed with shadow effect with opacity and vector parameters set

Image with shadow vector parameter set to vector:[-25,-25]:

image transformed with shadow effect and vector switched to opposite side

Image with shadow color set to blue and background set to background set to color:blue,background:grey:

image transformed with a blue shadow effect and grey background

Circle effect

Circle URL Format:
https://process.filestackapi.com/circle=[options]/Filestack_FileLink_Handle
or
https://process.filestackapi.com/<API_KEY>/circle=[options]/File_URL

circle
String

The root task cannot be abbreviated

Users can use circle without any options and the default settings will be used.
circle=background:white or FFFFFFFF
String

Can be abbreviated as b:black

Sets the background color to display behind the image.

This can be the word for a color, or the hex color code. The default value is white. Click here for a list of accepted color names.

Circle Effect Examples

Original Image

original photo to be transformed with the circle effect

Image using all the default circle settings circle:

photo transformed with the circle effect with default settings

Image with the circle background parameter set to snow background:snow:

image transformed with the circle effect and the background color set to snow

Borders

Border URL Format:
https://process.filestackapi.com/border=[options]/Filestack_FileLink_Handle
or
https://process.filestackapi.com/<API_KEY>/border=[options]/File_URL

border
String

The root task cannot be abbreviated

Users can use border without any options and the default settings will be used.
border=width:5
Integer

Can be abbreviated as w:5

Sets the width in pixels of the border to render around the image.

The value for this parameter must be an integer in a range from 1 to 1000. The default value is width:2.
border=color:white or FFFFFFFF
String

Can be abbreviated as c:black

Sets the color of the border to render around the image. This can be the word for a color, or the hex color code. The default value is black. Click here for a list of accepted color names.
border=background:white or FFFFFFFF
String

Can be abbreviated as b:grey

Sets the background color to display behind the image. This can be the word for a color, or the hex color code. The default value is white. Click here for a list of accepted color names.

Border Examples

Original Image

original photo to be transformed using the border effect

"Sunflower sky backdrop" by Fir0002 Licensed under GFDL 1.2 via Commons.


Image using all the default border settings border:

the original photo transformed with the default border settings applied

Image with the border width set to 10 and the border color set to orange width:10,color:orange:

the photo transformed with a thicker orange border applied