Skip to main content

Migrate From Another Theme

7 min readApplies to every PremiumPress theme · 12.x

Migrate From Another Theme

Moving to PremiumPress Directory from MyListing, ListingPro, Listeo, Listivo or Listify? You can do it on the same WordPress site, and we'll bring your listings across for you.

When you switch to PremiumPress on a site that used one of those themes, your old listings are still in your database, saved the way the old theme left them. The Migrate screen reads them from there and turns them into PremiumPress listings. You don't need to export or upload anything. Photos are reused from your media library, and every owner keeps their account.

This guide is for the Directory product only. The other PremiumPress products (Jobs, Real Estate, Shop and so on) hold different kinds of items, so you won't see the Migrate screen on them.

Before you start​

  1. Take a backup. The migration never deletes or changes your old theme's listings, but it's a good habit to take a backup before any big change.
  2. Finish the installer. The Migrate screen only appears once the theme's installer has finished. That way, a site being set up for another product never sees it.
  3. Keep the old theme's plugin installed if it had one. ListingPro, Listeo and Listivo come with a companion plugin. It doesn't need to be switched on. The migration reads your database directly, so it works either way. Keeping the plugin around just makes it easy to switch back and compare while you check the results.

What comes across​

From the old themeIn PremiumPress
Title, description, short description, publish date, URL slugThe same fields on the listing
Published / pending / draft statusThe same status
Expired listingsKept as drafts, published again, or held for review. You choose on the screen
Categories, including sub-categoriesListing categories, set up in the same parent and child order
Regions / locations (Country › State › City)The listing's city, region and country fields
Tags or keywordsListing tags
Features / amenitiesA Features taxonomy, created the first time it's needed, that shows in the editor and search filters
Address and map coordinatesAddress and map pin
Phone, website, emailContact fields
Opening hoursBusiness hours, including split shifts and 24-hour days
Social linksSocial links (Twitter links become X)
Featured image and galleryFeatured image and gallery, in the same order
OwnerOwner. It's the same user account, so members see their listings in the member hub straight away
Featured / promoted flagFeatured
Claimed / verified flagVerified, with the claim recorded against the owner
Expiry dateListing expiry
Reviews and star ratingsReviews, with the listing's average rating worked out again
Price range ($ / $$ / $$$)The Price range custom field

A few things can't come across, because Directory has nothing to match them: listing packages and paid plans, bookings, pricing menus, event dates, and per-category "additional details" fields. Don't worry, that information stays in your database, untouched.

Running the migration​

  1. Go to Listings → All Listings. If we've found listings from a supported theme, you'll see a notice at the top. Click its Migrate listings button to open the Migrate screen.
  2. Each theme we find on your site has its own card, showing how many listings, reviews and photos it has. Have a read of the notes under the card. They list anything from that theme that can't be brought across.
  3. Choose your options:
    • Bring reviews and star ratings across is on by default.
    • Download photos hosted elsewhere is best left off, unless your old theme linked to images on another server. Photos already in your media library are reused without downloading them again.
    • Listings that had expired can be kept as drafts (the default), published again, or held for review.
  4. Click Migrate from …. The migration works through your listings in small batches while you watch the progress bar. A large directory takes a few minutes, so please keep the tab open until it's done.
  5. When it finishes, the page reloads with a summary. It shows how many listings were created, how many reviews and photos came across, and any listings that couldn't be converted.

Listivo: check the fields first​

Listivo saves every field under a number that's different on every site, so its card has an extra Confirm the fields table. We look at your data and pick the most likely match for each field for you (category, location, gallery, price, phone and so on). Check the sample value next to each choice, correct anything that looks wrong, and leave a field as "skip" if you'd like to ignore it. You can always map a skipped field on a later run.

Running it again​

It's safe to run the migration more than once. Every listing and review we bring across remembers which old listing or review it came from. So a second run updates them in place, rather than making copies.

After the first run, the notice on Listings → All Listings won't show any more. To open the Migrate screen again, switch off Hide sub-menu items on Settings → Misc. You'll then find Migrate under PremiumPress in WordPress's own menu. It's worth running it again if:

  • the first run was interrupted (the screen offers Resume migration, so you don't have to start over),
  • you've fixed something on the old theme's side and want the change to come across,
  • you skipped a Listivo field and want to map it now.

After you've migrated​

  • Look at a few listings on your site. The map pin, the opening hours badge and the gallery order are the quickest way to spot anything that needs a tweak.
  • Have a look at the Features taxonomy under Listings → Taxonomies if your old theme had amenities. You can rename or merge them there however you like.
  • Put listings on pricing plans. Migrated listings arrive without a plan. Use the plan controls in the listing editor, or bulk actions, to add them.
  • Add map pins to anything without one. If some listings had an address but no map coordinates, Listings → All Listings shows a one-click Geocode listings now notice once you've set up a maps provider.
  • Let your members know. They can sign in with the same account as before, and they'll find their listings in the member hub.

Tidying up the old data​

We leave your old theme's listings in place so you can compare and run the migration again. Once you're happy, simply deactivating and deleting the old theme and its plugin is all your site needs. The leftover old listings won't cause any harm. If you'd like them gone, a database clean-up plugin can remove posts of the old theme's post type. Please only do that after taking one last backup.

If something doesn't look right​

The Migrate listings notice doesn't show. This usually means one of these: your site runs a product other than Directory, the installer hasn't finished, you're not signed in as an administrator, or the listings have already been migrated once (see Running it again).

"No previous directory theme found." We look for the listings of the five supported themes. If you've just restored a database, click Scan again. For any other source, you can use Import / Export (the last tab on Listings → All Listings) with a CSV file.

Some photos say "external photos not fetched". Those images were kept on another server. Run the migration again with Download photos hosted elsewhere ticked, and we'll fetch them for you.

Reviews came across without stars. Your old theme saved its ratings in a way we didn't recognise. The review text is kept, and the listing's overall rating uses the average your old theme had already worked out.