FAQ

Base Questions

Where do I start?
Did you read the tutorial about this plugin already? If not, I suggest you to read it first.
What does this plugin do?
It creates the image files required by the Retina devices. In the case the resolution of the original images are not high enough, you will see a warning in the Media Library where you will be able to re-upload bigger images. The plugin then recognizes different devices and send the images required accordingly.
What actually are Image Sizes in WordPress?
Have a look at this article: https://rudrastyh.com/wordpress/image-sizes.html
What are those new images?
The new images use the same name as your original files, with an “@2x” string added right before the extension. For example, if you have a Gundam-150×150.jpg file, a new Gundam-150×150@2x.jpg will be created. Its size will be doubled. This naming convention actually comes from Apple.
Can I create all the Retina images at once for my whole Media Library?
Yes, check the Retina Dashboard screen (under the Media menu).
Can I crop my images and they will be cropped the same in retina?
Yes, but I suggest you strongly to use the YoImages plugin to crop your images.
Will the images be optimized? (EWWW, SmushIt)
I will be honest here. WPMU (SmushIt) is very good at marketing and writing articles to promote their stuff but they aren’t good at collaboration with other developers out there. Well, they only care about themselves and about making money. EWWW works with Retina and at the contrary of WPMU, you will be able to chat with a real human (and a real developer) if you have an issue or a question. Go for it πŸ™‚ I optimize my Retina images with EWWW as well.
I don’t have a Retina device, how can I check whether it works or not?
Go to the closest Apple Store and try it out! More seriously, you can check the “Debug” option in the plugin settings. Then your blog will always behave as if the client is using a Retina Display.
Does it work for other High-DPI devices?
I tried it on a few High-DPI mobile devices and it works fine.
How do I get rid of the banner?
You can add this line to your wp-config.php (main config file) or in your functions.php (theme).
`define( “WP_HIDE_DONATION_BUTTONS”,  true );`

 

Issues

Most issues are related to the sizes of your media. The first thing is to check if the retina image has been generated. Take the URL of your image, add @2x at the end, and load it directly in your browser (if you image is cat-200×200.jpg try to loadcat-200×200@2x.jpg). If it is not found, go in the Retina Dashboard. Click Generate. Is this specific image size is still red, the plugin cannot generate it because the full-size image is too small.

If the retina image is present, then switch between the methods (particularly try PictureFill and Retina.js). Did you clear your cache? If you contact me, please share with me your URL, a screenshot of your dashboard and if possible, a screenshot of your “Details” screen.

It doesn’t work with PictureFill but works with Retina.js, why?
Maybe you are using a plugin that blocks the modification from being made. If you use a SEO plugin with a feature like Rewrite Post Title that might be it. Check this feature off and it will work.
The logo or icons of my theme are not displayed as Retina, why?
The plugin can transform the images that go through the WordPress API and the ‘Image Sizes’ properly (which means that they are part of the Media Library). Themes often uses a one-time customized size for the logo, and for that reason the image wouldn’t be taken care of by the plugin. The easiest way to go around this is to create the Retina image by yourself. For example, if you are logo is 200×100 and named ‘logo.png’, upload a 400×200 version of that logo named ‘logo@2x.png’ next to the other one. It will work immediately.
My logo / images appeared twice bigger on Retina.
Let’s say you have a logo which is 200×400. The retina logo would be 400*800, but it should STILL be shown as a 200×400 image relatively to the rest of your website. The workaround is to keep it simple and neat: always set the (normal) width and the height for all your images (in HTML directly or via CSS).
I have issues with images in my slideshows / sliders.
That is unfortunately the most infamous issue to expect with this “Retina” technology. A lot of developers ignore it, sometimes don’t code properly, think that what they did is “enough”. You should ask the developer to do something about it, and if he cares, he will do it. You can also do it by yourself, check the next question.
I have issues with images loaded on the fly / asynchronously.
This is very tricky. The simple answer would be to ask yourself a developer or ask a good and very geeky friend. This is not a simple matter.

If you are using Retina.js method, you can see how to resolve this issue on this Github discussion.

I have an issue with WP Engine + CDN.
You could try using a re-writing rule in your WP Engine settings (HTML Post Processing). This regex would do the job:
`#http://www.yourwebsite.com/(\S*.(?:jpe?g|png|gif|ttf|otf|svg|woff|js|css))# => http://cdn.yourwebsite.com/$1`

Sometimes, themes and plugins developers will need to add support for the Retina. Using WP Retina 2x, it should be easy, I created functions, filters and actions for them. Please find about this API here: https://wordpress.org/plugins/wp-retina-2x/faq/.

Errors

WordPress stops responding when…
Maybe you don’t have enough memory allocated to PHP or the script takes longer than the maximum execution time limit. You can change those values using the PHP Configuration File (php.ini):

* php_value memory_limit = “128M”;
* max_execution_time = 360;

… or by modifying the WordPress PHP files (wp-settings.php ideally):

* ini_set(‘memory_limit’, ‘512M’);
* ini_set(‘max_execution_time’, 300);

Please note that it doesn’t work with some cheap web hosts, as they don’t want you do to that instead. The real issue can also be tracked in the PHP error logs.

I am using CSS3 filters and the Retina images look blurry.
It is a known issue and it is not related to the plugin. You can find the answer on this post: http://matthewhappen.com/fixing-css3-filter-blur-on-retina-displays/
The retina images are too heavy, how can I optimize their size?
Give a try to the EWWW Image Optimizer plugin. It will do the job.
I am a developer and I want to use functions, filters and actions in your plugin.
Sometimes, themes and plugins developers will need to add support for the Retina. Using WP Retina 2x, it should be easy, I created functions, filters and actions for them. Please find about this API here: https://wordpress.org/plugins/wp-retina-2x/faq/.
I still don’t understand a thing!
Please check my tutorial and introduction to Retina Displays. You should also have a look at the WordPress forums. Ask a friend to help you.
It still doesn’t work!
Create a new support thread here. I always look at the new tickets. However, I only reply if it seems there is a bug in the plugin and I will always try my best to resolve it.

I love this plugin!

This plugin is great, how can I thank you?
Thanks for asking, since we, developers, get usually 10x more complains than thanks! I don’t blame anyone, I personally don’t say thank you to every single developer of all the software I am using. But if you are happy, please write a nice review here.
  • GΓΌnther

    Hi,
    i ordered yesterday the pro Version and payed with PayPal. But i didn’t got until now an Activation Code. Please help me. thx GΓΌnther

  • Chris

    Hi,
    Just to get my head around this, if I want to display crisp looking full screen width images on everything device from 27inch mac desktop to an iphone, do I load base images created in photoshop at 1800Γ—1200 / 72dpi? Or do I need load bigger images than that? Thank Chris

    • Hi Chris. That entirely depends on your website theme and potentially your screen size. DPI doesn’t matter on the web. 1800×1200 is usually fine, for big screen and nice themes, is often around 2400.

      • Chris

        Ok Thanks. So if want to have 4 versions of the same image, with each displaying well on 1- mobile, 2 – tablet and say a 3 – desktop at 1920 (+ a larger screen using the 2400), I set my images at 2400 then upload them with your plugin, then can I manually set the different display sizes? If the mobile size is set to say 500px does that mean retina devices that are 500px wide and smaller would display that version of the image?
        I saw one blog post talking about using WP Dashboard Notes plugin to create custom image sizes, is that the best way?
        Also can you please point me towards some good online info on how to handle images inside slides, gallery plugins, and woocommerce products?
        Thanks for your help

        • Chris

          Also, I’m quessing that for all other images used in say galleries and woo products I would load up an image 1800, and just use 2400 for the full screen images in a full width slideshow?

          • All the themes and plugins you use should be compatible with Responsive Images. If they aren’t, complain to them, or find another plugin (otherwise your life will be impossible). Then set your alternative image sizes nicely, but that should be done by your theme automatically. Retina just provide the alternative retina for those already existing alternative images, nothing more πŸ™‚

          • Chris

            Thanks for that. When you say set your “alternative image sizes nicely”, can you please give me an idea of the size settings you use to deliver well to desktop, tablet and phone?

          • I actually don’t, otherwise it’s way too much size to set up for everything, usually themes already set so many of them that it is enough, especially with the Retina images next to them. Then the browser will pick the most adequate one depending on the device. There are too many devices (resolution or dpi), so you can’t really think this way. Create good sizes for your desktop and for an iPhone 6 for instance, let the wordpress/plugins do the rest πŸ™‚ It will be perfect already.

          • Chris

            Hi Jordy, I am having some issues with the selected image sizes https://uploads.disquscdn.com/images/5af6f4122ab551dea9a63a5d4381f7cb7e4c47f0bd6d42b23c5b6e7096b2287c.jpg https://uploads.disquscdn.com/images/ce78819613021479f9eadb7bce06ef1cae777ad3328f5a784e128e8791bb0204.png

            I have selected most of the image sizes in the settings to not produce a retina image, but when go into retina images (eg “shingles”) it is producing a retina image for all the ones I don’t want. Your help would be most appreciated.

          • Do you mind contact me directly? I woulds like to look into it. Did you make sure you Save Changes in the options? Maybe uncheck-save-recheck-save? In the past, there was an issue with saving those settings, that might be this :/

  • Seth Long

    I see the note about EWWW and Smushit but can you confirm it works with Kraken.io? PageSpeed Insights is reporting that my retina images need optimization.

  • After the last update, I’m getting an error saying the Retina 2x plugin isn’t compatible with Jetpack’s Photon module – I’ve had both plugins running for some time without any problems, and love Retina 2x so would rather not replace it. Are you aware of this? Is it something you can fix?

  • Kitty Kilian

    Hi Jordy,

    I just got the new pro version and a key. But for the life of me: I can’t find where to input it. In the plugin dashboard it says: ‘Pro Version (inactive, add your key in the settings)’ – but the link under settings doesn’t go to a place where I can input it.

    What am I missing?

    Thanks, Kitty

    • Hi Kitty, there was a problem with the latest version and the dashboard was not displaying everything, so I think that’s the cause. You will be proposed an update to version 5.0.3, do it πŸ™‚ It will fix it.

      • Mark Parsons

        Hi, Jordy. I’m a Pro user, and redid my Pro status yesterday (at 90% off, etc.). I also updated to 5.0.4 today. In Meow Apps > Retina a red banner tells me that Pro is disabled. I’ve not been able to figure out how to activate it. Can you advise?

        • It’s something else, I think you are using the old version of the plugin. Please delete the one you have now, re-download it through the link you got by email, and install it. Then check that the serial is in there also. That will work πŸ™‚

          • Mark Parsons

            Thanks, Jordy. I did that, and successfully enabled Pro. But the download (through the link I got from you by email) evidently installed 5.0.4. I then performed the update to 5.0.5, which said it was successful, but the Plugins page indicates that the active version is still 5.0.4. I don’t see any problems using 5.0.4, but assume I should be able to do the update to 5.0.5.

          • Mark Parsons

            UPDATE: Problem solved with today’s 5.0.6 update, thank you.

      • Kitty Kilian

        It is not active yet so I can’t update. But I will try via the member page.

  • Kitty Kilian

    Hi Jordy, I can’t find my former comment – of two days ago – could you please look into your disqus archive and answer to my new reply to your reply? I need to get the new version working! Thanks KK

  • Kitty Kilian

    Hi Jordy, it seems you removed my former comment? I got your new version of WP-retina on sunday and could not get it to work. You said: see picture https://uploads.disquscdn.com/images/651730eb9358b9fef232e33894ac4604c8044cdd60e3673555eaf84002aeb8ee.png

    But I already have version 5.0.5. and it won’t let me input my key so I don’t get asked to upgrade πŸ˜‰

    Please advise, any other known bugs?

    Thanks, Kitty Kilian

    • Hi, yes, I prefer to keep the articles clean, the comments were too specific to an issue that is past, it’s better to contact me directly for this. Here is more for general questions πŸ™‚ Please contact me here: https://meowapps.com/contact, and I will look into it πŸ™‚

      • Hi Jordy, this is really a nuisance for your users. I would not have updated if I’d known I’d have to do a whole song and dance to get a new license. Have you heard of pro-actively emailing your pro-users about changing your license system? Not happy.

        • I am sorry about that, you can’t imagine what it has been for me too, thousand of dollars thrown away and now it has been 2 months of useless development and updates. The process is really super easy and straightforward now, as of today nobody complains about it so I wonder what happened in your case. Also, for most of my users I made it so that is is a good deal. Again, sorry you feel about this but that was required (I had no choice anyway). The good thing is that from now everything will be much easier and the store is much better and robust. The biggest issue I guess what was one of the payment gateway is not working with some credit cards (or something else?) and that is really annoying, still now…

          • So why did you just not move our licensed domains over automatically? I really don’t understand why there has to be a personal interaction over something so straightforward and transactional. BTW, the huge banner for WP Engine in the free backend is really shameful. It’s a disgusting low blow to open source like the whole Yoast ecosystem of hype, wild admin notices and ads. I’m surprised at this approach. You came across as serious and respectful at the start of your path. Don’t let greed get the best of you (as it has with Yoast and Matt Mullenweg).

          • They sponsor all my websites, and I wouldn’t force people to see it because it is not my style; there is an option to hide it, just click the option and it will disappear from all my plugins, at once. It has been here for a very very long while, and I don’t intend to add more, like Yoast and ads all over the place, definitely I will never ever do this.

  • Hiya – looking at the Custom CDN Domain options for the pro version I have – can’t find any info here – what does it do? I use cloudflare – so am I supposed to add their URL here or something?

    • Hi πŸ™‚ You don’t need to set up a special URL with Cloudflare, it does it automatically from the Cloudflare side πŸ™‚

  • Hi Jordy, just bought the Pro Version. I am getting the following on my live pages.

    Picture attached. There are also ‘Fwrite’ and ‘Fclose’ errors as well.
    https://uploads.disquscdn.com/images/dd1c1517a5f32ecdb527ec61b1288f167782c276ba76d7b49da21aaea8444bea.png

  • Ronald de Caluwe

    Hi Jordy, I just bought the Pro Lifetime version. On trying to network activate on my WP network I get a 403 forbidden page. I can network activate other plugins though…

    Offcourse I also tried to activate on one of the subsites within the network: also a 403…

    Can you help me out?
    Thx!

I recommend you to use WPEngine or SiteGround. They are both excellent hosting services and work perfectly with all my plugins.