In Mosaic, installation starts with downloading a ZIP from your account and uploading it in WordPress. The free version needs no activation. Updates can be applied by uploading a newer ZIP, while your designs and settings remain intact.
Upload
On the admin panel
Step 1
Download the Mosaic zip installer from our website.
Step 2
Go to your Plugins → Add new → Upload Plugin and browse the zip file you just downloaded.
If your zip file contains UNZIP_FIRST in its name, then unzip the file first and use the zip file inside it!
Step 3
Press Install Now, and if the installation was successful, click on Activate Plugin.
If you are getting an “The uploaded file exceeds the upload_max_filesize directive in php.ini.” message, follow the FTP installation method instead!
Step 4
Now Mosaic will appear in your plugins list. After activating it, you will see the Mosaic menupoint appearing in your left WordPress menu.
If the installation wasn’t successful, try out the Upload through FTP method instead.
Through FTP
Step 1
Download the Mosaic zip installer from our website.
Step 2
Unzip it into your computer. You’ll end up with a folder named Mosaic-pro-beta.
Step 3
Go to your FTP, then upload the mosaic folder to your website’s wp-content\plugins\ folder.
Step 4
Go to your admin area → Plugins, and you will see the Mosaic plugin in your list. Activate it, and the Mosaic menupoint will appear in your left WordPress menu.
Installation errors
Upload max filesize
There was an error loading this file to the server. The uploaded file exceeds the upload_max_filesize directive in php.ini.
If you can see an error message like this, when you are trying to install Mosaic, that means that your server has a low upload_max_filesize or post_max_size limitation. You should contact your server host and ask them to raise these server values for you!
An alternative could be the FTP installation method, but a low upload file size limitation can cause many issues in the future too, so we rather suggest getting this resolved with your server host.
The filename starts with UNZIP_FIRST
Error message:
Installing plugin from uploaded file: UNZIP_FIRST_
Unpacking the package
Installing the plugin
The package could not be installed. No valid plugins were found.
Plugin installation failed.
Go to Plugin Installer
If the Mosaic installer you’re trying to install starts with UNZIP_FIRST then you need to unzip this file first and use the zip file inside with a name that starts like this: mosaic-pro-, without any UNZIP FIRST text.
Clean install / Uninstall
Sometimes you may want to completely reset Mosaic, for example, after testing features on your site and deciding to start fresh.
In the WordPress Plugins list, Mosaic includes a dedicated Uninstall option. Unlike simply deactivating or deleting the plugin, this option removes all Mosaic-specific data from your site.
This action is permanent and cannot be undone. Once you uninstall, all Mosaic data will be erased from your site.
Where is the FTP?
When you purchased your website from the hosting company you have received an email with the ftp account to be able to access its folders and files. That is the account you need, and for example with Filezilla you can access your ftp.
If you are not sure what your ftp account is, contact your server host and ask them for it.
Update
You can update Mosaic from your WordPress Dashboard → Updates, or from the Plugins.
If it doesn’t work, follow the Alternative update method.
After you updated Mosaic make sure you clear all cache on your website to avoid problems.
Alternative update
After you updated Mosaic make sure you clear all cache on your website to avoid problems.
Replace package
From the admin panel
If you’re using WordPress 5.5 or newer, simply install Mosaic again from the admin panel.
At the installation you should just press the Replace current with uploaded button. Your themes will stay, so you don’t have to worry about them!
From FTP
Connect to your FTP and delete the folder of Mosaic:
- \wp-content\plugins\mosaic\
Then install Mosaic again via FTP.
Reinstall
Step 1
Go to your Plugins list and deactivate and delete your current Mosaic installation. Don’t worry, your themes will stay!
If you would have a problem, where you don’t even see Mosaic on your Plugins list, you should delete its folder with everything in it from FTP. We suggest making a backup, to be sure you are deleting the correct folder. You can find Mosaic’s folder on the following location:
- \wp-content\plugins\mosaic\
Step 2
Install Mosaic again, either from the admin panel or via FTP.
Update errors
Unable to copy
Update Failed: The update cannot be installed because we will be unable to copy some files. This is usually due to inconsistent file permissions.
The problem on your server will be, that the files and folders have different permissions. You could try to change all permissions on your FTP (for example with Filezilla), but usually the real issue is, that the services are running under different owners. For example:
Ftp server runs with owner: xy Apache runs with owner: z
If you install new plugin with WordPress upload, the plugin’s files will have the owner ‘xy’ as Apache creates them. In this case you can update this plugin from WordPress.
Then you choose to upload a new plugin with FTP, you place the files into the right folder, but those files will be owned by “z” and when you try to update these files from WordPress, the Apache process with owner “xy” might not have permission to write “z”s files.
Solution
Send this to your server host: ls -lia . This will list out the files and folders from the current folder. On this image ish is the owner and ish is the group too:
When you know the owner and group, you could try to run the following command. It will recursively set the owner and the group for the files and folders of the current folder:
xy is the user and www is the group in this example:
chown -R xy:www ./
Then update permission on those files. This call is also recursive:
chmod -R 755 ./
Upload max filesize
There was an error loading this file to the server. The uploaded file exceeds the upload_max_filesize directive in php.ini.
If you can see an error message like this, when you are trying to update Mosaic, that means that your server has a low upload_max_filesize or post_max_size limitation. You should contact your server host and ask them to raise these server values for you!