{"id":3311,"date":"2026-09-02T00:30:47","date_gmt":"2026-09-01T16:30:47","guid":{"rendered":"http:\/\/www.kd-trip.com\/blog\/?p=3311"},"modified":"2026-09-02T00:30:47","modified_gmt":"2026-09-01T16:30:47","slug":"how-to-add-a-border-to-an-image-using-pillow-44aa-7b1e94","status":"publish","type":"post","link":"http:\/\/www.kd-trip.com\/blog\/2026\/09\/02\/how-to-add-a-border-to-an-image-using-pillow-44aa-7b1e94\/","title":{"rendered":"How to add a border to an image using Pillow?"},"content":{"rendered":"

Adding a border to an image can significantly enhance its visual appeal, making it stand out in various contexts, from personal photo editing to professional graphic design. As a dedicated Pillow supplier, I’ve witnessed firsthand how versatile and powerful the Pillow library in Python can be for such tasks. In this blog, I’ll guide you through the process of adding a border to an image using Pillow, sharing tips and tricks along the way to help you achieve the best results. Pillow<\/a><\/p>\n

<\/p>\n

Understanding Pillow<\/h3>\n

Pillow is a fork of the Python Imaging Library (PIL) and is widely used for opening, manipulating, and saving many different image file formats. It provides a simple yet powerful API for performing a wide range of image processing tasks, including resizing, cropping, and adding borders. One of the key advantages of using Pillow is its cross – platform compatibility, which means you can use it on Windows, macOS, and Linux systems without any major issues.<\/p>\n

Installation<\/h3>\n

Before you can start adding borders to images, you need to have Pillow installed. If you haven’t installed it yet, you can use pip<\/code>, the Python package installer. Open your terminal or command prompt and run the following command:<\/p>\n

pip install pillow\n<\/code><\/pre>\n
This command will download and install the latest version of Pillow from the Python Package Index (PyPI).<\/p>\n
Basic Steps to Add a Border<\/h3>\n
Let’s start with the basic steps of adding a border to an image using Pillow. First, you need to import the necessary modules. In Python, the Image<\/code> module from Pillow is the main entry – point for working with images.<\/p>\n
from PIL import Image\n\n# Open the image file\nimage = Image.open('your_image.jpg')\n\n# Define the border width and color\nborder_width = 20\nborder_color = 'black'\n\n# Create a new image with the border\nnew_image = Image.new(image.mode, (image.width + 2 * border_width, image.height + 2 * border_width), border_color)\n\n# Paste the original image onto the new image\nnew_image.paste(image, (border_width, border_width))\n\n# Save the new image\nnew_image.save('new_image_with_border.jpg')\n\n<\/code><\/pre>\n
In this code snippet, we first open an existing image using the Image.open()<\/code> method. Then, we define the width and color of the border. We create a new, larger image with the specified background color, and finally, we paste the original image onto the new image at the appropriate position. The result is saved as a new file.<\/p>\n
Customizing the Border<\/h3>\n
The basic example above gives you a simple, solid – colored border. However, you can customize the border in many ways to achieve different effects.<\/p>\n
Changing the Border Color<\/h4>\n
You’re not limited to using basic colors like black or white. Pillow supports a wide range of color formats, including RGB tuples. For example, if you want a bright red border, you can use the following code:<\/p>\n
from PIL import Image\n\nimage = Image.open('your_image.jpg')\nborder_width = 20\nborder_color = (255, 0, 0)  # RGB for red\n\nnew_image = Image.new(image.mode, (image.width + 2 * border_width, image.height + 2 * border_width), border_color)\nnew_image.paste(image, (border_width, border_width))\nnew_image.save('red_border_image.jpg')\n<\/code><\/pre>\n
Creating a Gradient Border<\/h4>\n
Creating a gradient border is a bit more complex but can add a very professional and eye – catching look to your image. You can achieve this by creating a gradient image and then slicing and pasting it around the original image.<\/p>\n
from PIL import Image, ImageDraw\n\n# Open the image\nimage = Image.open('your_image.jpg')\nborder_width = 20\n\n# Create a gradient image\ngradient = Image.new('RGB', (border_width, image.height), color=(0, 0, 0))\ndraw = ImageDraw.Draw(gradient)\nfor y in range(image.height):\n    r, g, b = int((y \/ image.height) * 255), int((y \/ image.height) * 255), int((y \/ image.height) * 255)\n    draw.line((0, y, border_width, y), fill=(r, g, b))\n\n# Create a new image with the border\nnew_image = Image.new(image.mode, (image.width + 2 * border_width, image.height + 2 * border_width), (0, 0, 0))\nnew_image.paste(image, (border_width, border_width))\n\n# Paste the gradient on the left and right sides\nnew_image.paste(gradient, (0, border_width))\nflipped_gradient = gradient.transpose(Image.FLIP_LEFT_RIGHT)\nnew_image.paste(flipped_gradient, (image.width + border_width, border_width))\n\n# Save the image\nnew_image.save('gradient_border_image.jpg')\n<\/code><\/pre>\n
In this example, we first create a vertical gradient image. Then we create a new image with space for the border and paste the original image in the middle. Finally, we paste the gradient image on the left and right sides of the original image, after flipping it for the right – hand side.<\/p>\n
Advanced Border Effects<\/h3>\n
Beyond simple colors and gradients, you can also create more advanced border effects, such as a rounded – corner border.<\/p>\n
from PIL import Image, ImageDraw, ImageOps\n\n# Open the image\nimage = Image.open('your_image.jpg')\nborder_width = 20\nradius = 30\n\n# Create a mask for rounded corners\nmask = Image.new('L', (image.width + 2 * border_width, image.height + 2 * border_width), 0)\ndraw = ImageDraw.Draw(mask)\ndraw.rounded_rectangle((0, 0, mask.width, mask.height), radius=radius, fill=255)\n\n# Create a new image with the border\nborder_color = (255, 255, 255)\nnew_image = Image.new(image.mode, (image.width + 2 * border_width, image.height + 2 * border_width), border_color)\nnew_image.paste(image, (border_width, border_width))\n\n# Apply the mask\nnew_image = Image.composite(new_image, Image.new(image.mode, new_image.size, (0, 0, 0)), mask)\n\n# Save the image\nnew_image.save('rounded_border_image.jpg')\n<\/code><\/pre>\n
In this code, we first create a mask for the rounded corners using ImageDraw.rounded_rectangle()<\/code>. Then we create a new image with the border and paste the original image onto it. Finally, we use Image.composite()<\/code> to apply the mask, which results in an image with rounded – corner borders.<\/p>\n
Use Cases<\/h3>\n
Adding borders to images has numerous practical use cases. In digital marketing, a well – designed border can make an image more prominent in social media posts or email newsletters. For photographers, borders can add a professional touch to their portfolio images. Graphic designers can use borders to create a cohesive look across different elements in a design project.<\/p>\n
Why Choose Our Pillow Products<\/h3>\n
<\/p>\n
As a leading pillow supplier, we offer high – quality Pillow – related resources. Our libraries are well – maintained, with regular updates to ensure compatibility with the latest Python versions and security patches. We also provide comprehensive documentation and excellent customer support. Whether you’re a beginner just starting to explore image processing or an experienced developer looking for advanced features, our Pillow products can meet your needs.<\/p>\n
Microfiber Pillow<\/a> If you’re interested in using our Pillow – related resources for your image processing projects, or if you have any questions about adding borders or other image manipulation tasks, we’d love to hear from you. Contact us to start a procurement discussion and find out how we can help you achieve your goals.<\/p>\n
References<\/h3>\n