Frequently Asked Questions
A collection of common questions asked by Instant Images users.
General Questions
Yes – view the terms and conditions for each provider below:
Unsplash
All photos published on Unsplash are licensed under Creative Commons Zero which means you can copy, modify, distribute and use the photos for free, including commercial purposes, without asking permission from or providing attribution to the photographer or Unsplash.
All photos published on Unsplash are licensed under Creative Commons Zero.
Learn more about Unsplash license terms.
Pixabay
All content (e.g. images, videos, music) on Pixabay can be used for free for commercial and noncommercial use across print and digital, except in the cases mentioned in “What is not allowed”.
Learn more about the Pixabay license terms.
Pexels
All photos and videos on Pexels can be downloaded and used for free… You can modify the photos and videos from Pexels. Be creative and edit them as you like.
Learn more about the Pexels license terms.
Openverse
An extensive library of free stock photos, images, and audio, available for free use.
Learn more about the Openverse Creative Commons license terms.
Yes! In version 3.1 (or greater) of Instant Images you can enter id:{photo_id}
into the search box to return a single result.
e.g. id:YiUi00uqKk8
Note: Image ID search is not supported for Openverse.
The Instant Images Proxy is a dedicated server that acts as an intermediary between the Instant Images WordPress plugin and the various service providers (Unsplash, Pexels, Pixabay etc.)
As of Instant Images 5.0, all API requests to service providers are routed through the custom proxy server at proxy.getinstantimages.com.
Maintaining a 3rd party proxy server for Instant Images allows us to keep default API keys hidden from public view and ensures the image data returned from the providers is returned in a normalized format for display within your WordPress dashboard.
For additional details, please take a moment and read through our Terms of Use and Privacy Policy for when using our proxy service.
Yes, this plugin is required to write temporary images into the /instant-images
folder in your WordPress uploads directory. Images are stored there for processing prior to being uploaded to the media library.
Note: The /instant-images
directory is created automatically on plugin activation.
Yes, images are processed on the server then uploaded to the Media Library into the various sizes set within your theme.
By default, users with a minimum role of edit_theme_options are granted access. If you wish to modify the access restrictions to Instant Images the instant_images_user_role
filter will allow you to update the role.
<?php
// functions.php
function my_instant_images_user_role(){
// https://codex.wordpress.org/Roles_and_Capabilities
return 'upload_files';
}
add_filter('instant_images_user_role', 'my_instant_images_user_role');
PHPYes, by default Instant Images enables the highest level of content safety in all APIs however you can override each using our filter hooks.
Unsplash
Adjust the Unsplash Content Safety parameter using the following hook.
<?php
// functions.php
add_filter( 'instant_images_unsplash_content_filter', function(){
return 'high'; // default 'low'
});
PHPPixabay
Disable the Pixabay Safesearch filter using the following hook.
<?php
// functions.php
add_filter( 'instant_images_pixabay_safesearch', '__return_false' );
PHPYes, use the following constants in your wp-config
or functions.php
file.
define( 'INSTANT_IMAGES_UNSPLASH_KEY', 'YOUR-KEY-HERE' );
define( 'INSTANT_IMAGES_PIXABAY_KEY', 'YOUR-KEY-HERE' );
define( 'INSTANT_IMAGES_PEXELS_KEY', 'YOUR-KEY-HERE' );
define( 'INSTANT_IMAGES_GIPHY_KEY', 'YOUR-KEY-HERE' );
PHPYes, please visit https://connekthq.com/donate/ and you will be redirected to PayPal.
Errors and Issues
Unfortunately, there are a number of reasons why Instant Images may not work in your current hosting/server environment.
- Permissions
Instant Images downloads a temporary image to the /instant-images folder inside the WordPress uploads directory. If this directory does not have at least 0755 permissions, image uploading may fail. - allow_url_fopen
Instant Images requires allow_url_fopen to be on to download images from the remote server to yours. Check your servers php.ini file and confirm it is set to on and not off. - Max Upload Size
If your Media Library has less than 16mb max upload size set, images may be prevented from uploading. - HTTPS (CORS error)
If your WP Admin runs under HTTPS and your front-end does not (or visa versa) you may run into Cross-Orgin Resource Sharing (CORS) issue.
This is because Instant Images uses the WP REST API, which is front-end WordPress and your admin does not. The fix for this is to ensure both your WP Admin and public facing site use the same HTTP protocol. - REST API Blocked
Instant Images uses the WP REST API to process images and some security plugins offer the ability to block access. In this case, you should update the settings to allow access to the WP REST API.