Generate: Dynamic Elements: Pixabay Image

The Pixabay shortcode inserts a dynamic, random image from Pixabay for each generated Page.

Adding: Classic Editor / TinyMCE

To add a Pixabay image within the Classic Editor:

  • Ensure that you’re using the Visual Editor by clicking the Visual tab:
    Page Generator Pro: Dynamic Elements: TinyMCE: Visual Editor Tab
  • Click the black and white Pixabay icon in the Visual Editor toolbar:
    Page Generator Pro: Shortcode Buttons

Adding: Classic Editor / TinyMCE: Text Editor

If you’re using the Text editor instead of the TinyMCE Visual Editor above:
Page Generator Pro: Dynamic Elements: TinyMCE: Text Editor Tab

  • Click the Pixabay button in the toolbar:
    Page Generator Pro: Dynamic Elements: TinyMCE: Text Editor: Buttons

Adding: Gutenberg

To add a Pixabay image within Gutenberg:

  • Click the plus icon between two existing blocks, or towards the top left corner of the Gutenberg editor
    Page Generator Pro: Generate: Dynamic Elements: Gutenberg: Add Block
  • Start typing Pixabay into the Search for a block field, and click the Pixabay option that appears within the Page Generator Pro section
    Page Generator Pro: Generate: Dynamic Elements: Pixabay: Search Blocks
  • Follow the Configuration section below for each of the fields displayed in the right hand sidebar’s block panel:
    Page Generator Pro: Generate: Dynamic Elements: Pixabay: Sidebar

Adding: Page Builders

To add a Pixabay image within any Page Builder that supports a Text Editor widget/module using the Classic Editor (sometimes known as TinyMCE), refer to the Classic Editor instructions above.

Refer to the Dynamic Elements Documentation for details specific to your Page Builder.

If your Page Builder does not provide a Text Editor widget/block that uses the Classic Editor, you can still use Dynamic Elements.  However, you’ll need to manually build the shortcode, inserting it into your Page Builder’s content – for example:

[page-generator-pro-pixabay parameter="value" ...]

Parameter Accepted Value Description
term string or keyword Fetch an image at random from Pixabay matching the given Term.
orientation all, horizontal, vertical The image orientation to search for
language cs, da, de, en, es, fr, id, it, hu, nl, no, pl, pt, ro, sk, fi, sv, tr, vi, th, bg, ru, el, ja, ko, zh The language the search term is in
image_type all, photo, illustration, vector The type of image to search for (illustration, vector or photo)
category fashion, nature, backgrounds, science, education, people, feelings, religion, health, places, animals, industry, food, computer, sports, transportation, travel, buildings, business, music For more precise matching, optionally choose an image category to search within
color grayscale, transparent, red, orange, yellow, green, turquoise, blue, lilac, pink, white, gray, black, brown Optionally limit results by the given primary image color
copy 0,1 Whether to save the image to the Media Library.
size thumbnail, medium, large The image size to output.  Other values may be available depending on the image sizes registered by your WordPress Theme and third party Plugins.
title string or keyword The title to assign to the image.
caption string or keyword The caption to assign to the image.
caption_display integer (0,1) If enabled, displays the caption below the image.  Available in Page Generator Pro 4.5.2 and higher.
alt_tag string or keyword The alt tag to assign to the image.
description string or keyword The description to assign to the image.
filename string or keyword Define the filename to save the image as in the Media Library, excluding the extension.
attribution 0,1 If enabled, displays an image attribution below the image, linking to the author and license type the image is licensed under.
link_href string or keyword Define the link for the image. Leave blank for no link.
link_title string or keyword Define the link title for the image.
link_rel string Define the link rel attribute for the image.
link_target string Define the link target for the image.
_blank New Window / Tab
_self Same Window / Tab
_parent Parent Frame
_top Full Body of Window
exif_latitude decimal or keyword The image’s location’s latitude.
exif_longitude decimal or keyword The image’s locations’ longitude.
exif_comments string or keyword Comments about the image.
exif_description string or keyword A description of the image.

Configuration: Search Parameters

Page Generator Pro: Pixabay: Search Parameters

  • Term: Fetch an image at random from Pixabay matching the given Term.
    • Keywords can be used.
  • Image Orientation: The image orientation to search for
  • Language: The language the search term is in
  • Image Type: The type of image to search for (illustration, vector or photo)
  • Image Category: For more precise matching, optionally choose an image category to search within
  • Image Color: Optionally limit results by the given primary image color

Configuration: Output

The Display Caption option is available in Page Generator Pro 4.5.2, releasing Thursday 25th January 2024 23:59 UTC.

Page Generator Pro: Dynamic Elements: Pixabay: Output

  • Save to Library: If enabled, stores the found image in the Media Library.
    • Additional attributes, such as Caption, Filename and EXIF metadata can then be set.
    • If disabled, the image will not be imported into the Media Library. This may result in faster generation times, and the image will be loaded direct from the third party image source.
  • Image Size: The image size to output.
    • Other values may be available depending on the image sizes registered by your WordPress Theme and third party Plugins.
  • Title: The title to assign to the image.
    • This can be a keyword.
  • Alt Tag: The alt tag to assign to the image.
    • This can be a keyword.
  • Caption: The caption to assign to the image.
    • This can be a keyword.
    • If Save to Library isn’t enabled, this value is not set.  This is because the value is stored in the WordPress Media Library, and therefore requires that the image be saved to the Media Library
  • Display Caption: If enabled, displays the caption below the image.
    • If Save to Library isn’t enabled, this configuration option is not available.  This is because the caption is only stored when saving the image to the WordPress Media Library.
  • Description: The description to assign to the image.
    • This can be a keyword.
    • If Save to Library isn’t enabled, this value is not set.  This is because the value is stored in the WordPress Media Library, and therefore requires that the image be saved to the Media Library
  • Filename: Define the filename to save the image as in the Media Library, excluding the extension.
    • This can be a keyword.
    • It’s useful to use a keyword and/or other terms to ensure that the filename is SEO friendly and related to your content.
    • If Save to Library isn’t enabled, this value is not set.  This is because the value is stored in the WordPress Media Library, and therefore requires that the image be saved to the Media Library
  • Show Attribution: If enabled, displays an image attribution below the image, linking to the author and license type the image license.

Page Generator Pro: Generate: Shortcodes: Pixabay: Link: TinyMCE Modal

  • Link: Define the link for the image. Leave blank for no link.
    • This can be a keyword.
  • Link Title: The title attribute for the link.
    • This can be a keyword.
  • Link Rel: Define any rel attributes, such as nofollow.
  • Link Target: Whether clicking the link should open in the same window/tab, new window/tab etc.

Configuration: EXIF

Page Generator Pro: Generate: Shortcodes: Pixabay: EXIF: TinyMCE Modal

The EXIF tab provides options to optionally write EXIF metadata to the image file.  This can be useful for Image SEO.

  • Latitude: The image’s location’s latitude.
    • If Save to Library isn’t enabled, this value is not set.  This is because the image must be stored on the local web site for the EXIF metadata to be written
  • Longitude: The image’s locations’ longitude.
    • If Save to Library isn’t enabled, this value is not set.  This is because the image must be stored on the local web site for the EXIF metadata to be written
  • Comments: Comments about the image.
    • If Save to Library isn’t enabled, this value is not set.  This is because the image must be stored on the local web site for the EXIF metadata to be written
  • Description: A description of the image.
    • If Save to Library isn’t enabled, this value is not set.  This is because the image must be stored on the local web site for the EXIF metadata to be written

If any value is blank and the imported image contains an existing value in the EXIF metadata, the existing value will be retained.

Any other EXIF metadata is retained.