Articles on: Migrations

Migrating Assets


We recommend that the first thing you do once you have created a new site is import your assets.

This means that when you import your WebApps and WebApp Layouts later on, 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.

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.

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 <env>, 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 <env> . When prompted to, type a capital "Y" to confirm.

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.

5) 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

6) Run the terminal command siteglide-cli deploy <env> -w . This deploys your marketplace_builder folder, including the assets, to your website.

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

Migrations Overview
Migration Method Checklist
Migrations- Creating the Siteglide Site
Static Site Import - How To Use
Migrating Assets
Migrating (Importing) WebApps
Menu Builder Module
Menus - Getting Started
Troubleshooting Migrated Menu Layouts
Code Editor - Introduction
Migrating Templates
Templates - Getting Started
Migrating Forms
URL Redirects - Import
Migrating WebApp Layouts
How To Put A Site Live
FAQ - What's the difference between an ID and an external ID?

Updated on: 22/10/2021

Was this article helpful?

Share your feedback


Thank you!