Troubleshooting common issues

Here are some common issues other users have faced in the past. Before getting in touch, have a look here to see if your problem is mentioned.

Reading the Logs

The Craft logs will usually include details of any errors. You can see them in the following locations within your site:

storage/logs/web.log
storage/logs/queue.log
storage/logs/cli.log

These will hopefully give you an indication of the problem.

Preview images not appearing

If you have successfully configured your preview images, but notice that they are not actually appearing in your matrix fields, then make sure your file system/volume is configured correctly.

Go to the assets section of the Craft admin panel and into "file system". Make sure that you've enabled the Files in this file system have public URLs and set a corresponding Base URL to your volume:

Note that your 'Base Url' will likely be different then in this example

GIFs not working

GIFs are supported by Matrix Field Preview and are a nice way to make your fields even more intuitive.

That said, there can sometimes be issues when using GIFs as assets. The Matrix Field Preview plugin performs transforms on uploaded images to make thumbnails. This is usually quick with regular images but for larger GIFs it can present issues (see here and here for example).

Make sure your server has enough RAM assigned to the PHP process.
Make sure you are using ImageMagick as your image driver (check in Utilities > System Report > Image driver and version)

If that still doesn't work, you can disable transforms altogether by adding the following setting to your config/general.php:

// ...

return [
    "transformGifs" => false,

    //...
];

See the Craft Docs for more on this setting.

🪲 Search Github Issues

Also ave a quick search through the Github Issues page to see if somebody else has faced your issue in the past. If so, feel free to drop a comment there too to get help.