---
title: How to Convert a WordPress Gallery Block to Galleryberg
description: Use Transform to turn a core WordPress Gallery block into a Galleryberg Gallery, keeping images and captions.
url: "https://galleryberg.com/docs/convert-core-gallery-to-galleryberg/"
updated: "2026-11-14"
category: Getting Started
---

# How to Convert a WordPress Gallery Block to Galleryberg

> **At a glance:** Plan: core plugin · Available since version 1.0.4 · Keeps images and captions · Last checked: Galleryberg 1.2.1 (November 2026)

You can turn an existing WordPress core Gallery block into a Galleryberg Gallery without re-adding your images. Select the core Gallery block, click its block icon in the toolbar, choose **Transform**, and pick **Galleryberg Gallery**. Your images, captions, alt text, links, columns, spacing, borders and shadows move over, and you can then use Galleryberg layouts, the lightbox and caption styles.

## How to convert a core Gallery block to Galleryberg

1. Make sure Galleryberg is installed and active.
2. Open the post or page that contains the core **Gallery** block.
3. Select the whole gallery, not a single image. Click the gallery once, or use the List View to select the Gallery block.
4. Click the block icon at the left of the block toolbar to open the Transform menu.
5. Choose **Galleryberg Gallery**.
6. Check the result, pick a layout and columns in the **Settings** panel, turn on the lightbox if you want it, and update the page.

## What carries over

| Item | Kept after converting? |
| --- | --- |
| Images and their order | Yes |
| Captions and alt text | Yes |
| Image links, size, aspect ratio and scale | Yes |
| Number of columns and image cropping | Yes |
| Gap between images, padding and margin | Yes |
| Borders, rounded corners and shadows (gallery and images) | Yes |
| Lightbox | Turn on Enable Lightbox in the Lightbox panel |
| Layout | Starts as Tiles. Pick any other layout in Settings |

## Tips for converting many galleries

- Convert one gallery first and check it on the front end before doing the rest.
- WordPress keeps revisions, so you can restore the previous version of a post if needed.
- Galleries are converted one at a time in the editor. There is no bulk converter.
- Converting does not change or delete your images in the Media Library.

## Related docs

- [Creating Your First Gallery](https://galleryberg.com/docs/creating-your-first-gallery/)
- [Tiles Layout Guide](https://galleryberg.com/docs/tiles-layout-guide/)
- [How to Use the Lightbox](https://galleryberg.com/docs/how-to-enable-and-use-lightbox/)

## Frequently asked questions

### **Can I convert a WordPress Gallery block to Galleryberg?**

Yes. Select the core Gallery block, open the Transform menu from the block icon in the toolbar, and choose Galleryberg Gallery. Images and captions are kept. This works in Galleryberg 1.0.4 and later.

### **Will I lose my images when converting?**

No. Converting only changes the block. Your images stay in the Media Library and in the same order in the gallery.

### **Why is Galleryberg Gallery missing from the Transform menu?**

Make sure you selected the whole Gallery block and not one image inside it, and that the Galleryberg plugin is active and updated.

### **Can I convert galleries made with other gallery plugins?**

Not automatically. The Transform option works for the core WordPress Gallery block. For galleries from other plugins, add a new Galleryberg Gallery block and select the same images from the Media Library.
