🔼Migrating Assets

Introduction

When migrating a site from one platform to another, we recommend that the first thing you do is import your assets.

This means that when you import your WebApps and WebApp Layouts later on, the paths to the images can easily be mapped.

There are two main ways to upload assets:

• via the Siteglide CLI

• via the Admin CMS/ File Manager

Using File Manager to Upload Assets

File Manager currently allows you to bulk upload files within your browser. This is a great alternative to CLI for day-to-day use. You can create folders and upload assets within each as you go.

However, there could be browser limitations over how much can be uploaded at once (e.g. large file sizes), so we still recommend you use Siteglide CLI for bulk upload and for migrations.

Uploading Your Assets Using Siteglide CLI

If you have a very large number of assets to upload (especially large images or videos), the best way to upload is via the Siteglide CLI.

In order to do this: you'll need to follow these steps. Where a step has a placeholder like , add in your own environment, for example production:

1. First follow this tutorial to set up siteglide-cli, including adding an environment.

2. Create a new folder for your project if you've not already got one.

3. Change directory to that folder with the terminal command cd path/to/folder

4. Run the terminal command siteglide-cli pull . When prompted to, type a capital "Y" to confirm.

Pulling the Site File Structure

You will now have the Site stored in your new Project folder. On the root, level, you'll see a root folder called marketplace_builder.

New marketplace_builder Folder

1. In your new Project folder, make sure the counterpart versions of these folders exist inside marketplace_builder/assets/ - by default after a pull, only a css and js folder will be shown. If needed, create any other folders here

Assets Folder

1. Run the terminal command siteglide-cli deploy -w . This deploys your marketplace_builder folder, including the assets, to your website.

2. Check your assets have arrived successfully on Admin by navigating to CMS/File Manager and checking each of the four tabs.

Check your new assets are visible in File Manager

Outputting your Assets

Assets are stored and accessed a bit differently on our platform. We do this to receive various benefits, check out our doc on Assets to find out more.