Skip to content

How-to Guides

Technical References

Prepare for Site Launch /

Migrate content: Media

To migrate content onto VIP Go, we need two assets:

  1. The database file as a SQL dump, and
  2. The media as a compressed archive.

Files to import can be attached to a Zendesk ticket — or files larger than 20 MB can be transferred via sending us a web-accessible link to the files (eg https://www.mysite.com/uploads.tar.gz). You may also use Amazon S3, Dropbox, Box, WeTransfer, or another similarly secure service. Please also be sure to include the domain name of the VIP Go environment the import is for.

Exporting media

WordPress stores its media in /wp-content/uploads/ (or whatever directory is specified in your database’s uploads constant). You can ZIP or tarball this directory for VIP to import. It should be named “uploads.”

If you are importing media into a multisite, note that subsite number 1’s media are found in the /wp-content/uploads folder — but all subsequent sites in the network will be in the /wp-content/uploads/sites/ folder, in their own subfolder based on the site number, as designated by the database. For example, a specific file would be found in /wp-content/uploads/sites/{SITE ID}/{YEAR}/{MONTH}/{FILE NAME}, where the site ID would not have any leading 0’s (e.g. use 2, not 02).

We expect your archive to decompress to an /uploads/ folder with only the media required for your site(s).

Media may only be imported to a production environment and does not need to be imported into your development environment separately. All files uploaded to production are immediately made available to the child environments as well.

Preparing media

WordPress will rename files containing these special characters upon upload to the media library~?,[]/\=<>:;'\&$#*()|~`!{}%+ and whitespace ().

However, for media file imports, all special characters are allowed, such as: spaces ( ) [ ] ~ + & # % = ' ” \ < > : ; , / ? $ * | ` ! { } . Encoded or alternate whitespace, such as %20or + will be converted to proper spaces during the import.

WordPress normally creates intermediate images, or smaller versions of each uploaded image. VIP does not create, import, or store these files, as our filesystem generates them on the fly, reducing the amount of storage your site requires at no loss of speed. You may exclude these intermediate images from your export, though if provided, they will be skipped during the import process.

Since SVG files allow embedded JavaScript, which can pose a security risk, these files must be reviewed prior to import. To include SVGs, please commit SVG files to the theme, which will then be subjected to our code review.

Submitting media

Please open a new Zendesk ticket when sending files for import. Files to be imported can be transferred via sending us a web-accessible link to the files (e.g. https://www.example.com/uploads.tar.gz). You may also use Amazon S3, Dropbox, Box, WeTransfer, Firefox Send, or another similar service.

We can also stream media into VIP’s filesystem directly from an AWS bucket. To use this method:

  1. You need to provide an AWS key and secret in the VIP support ticket. You can use a secure method, such as Quickforget.com to send those credentials to VIP support.
  2. The media needs to be located in a directory with /uploads/ in the path.

Reference

VIP Go filesystem

Last updated: November 04, 2020