Configure what's under the hood of your website.

The Favicon, custom code, web services and some advanced settings can be added in the Settings panel of YOOtheme Pro. Most of these setting need to be configured only once. There is also an About section with the Changelog of YOOtheme Pro.


Add the regular browser Favicon and the Apple touch icon to the website.

Option Description
Favicon PNG Select your favicon.png. It appears in the browser's address bar, tab and bookmarks. The recommended size is 96x96 pixels.
Favicon SVG Select an optional favicon.svg. Modern browsers will use it instead of the PNG image. Use CSS to toggle the SVG color scheme for light/dark mode.
Touch Icon Select your apple-touch-icon.png. It appears when the website is added to the home screen on iOS devices. The recommended size is 180x180 pixels.

Show a banner to inform your visitors of cookies used by your website.

Option Description
Cookie Banner Choose between a simple notification that cookies are loaded or require a mandatory consent before loading cookies.
Type Choose between an attached bar or a notification.
Position Choose the position of the cookie banner.
Style Choose the style of the cookie banner.
Content Enter the cookie consent message.
Consent Button Style Choose the consent button style.
Consent Button Text Enter the consent button text.
Reject Button Style Choose the reject button style.
Reject Button Text Choose the reject button text.
Cookie Scripts Add custom JavaScript which sets cookies. It will be first loaded after consent is given. The <script> tag is not needed.

Custom Code

Add custom JavaScript and CSS/Less to the website.

Option Description
Script Add custom JavaScript to your site. The <script> tag is not needed.
CSS/Less Add custom CSS or Less to your site. All Less theme variables and mixins are available. The <style> tag is not needed.

Important Please be careful with incorrect Less code. Syntax errors may cause the Style Customizer to stop working.


Enter the API key for your website.

Enter API key


Configure some advanced settings.

Option Description
Child Theme Select a child theme. Note that different template files will be loaded, and theme settings will be updated respectively. For more information, read the chapter on Child Themes.
Media Folder This folder stores images that you download when using layouts from the YOOtheme Pro library. It's located inside the Joomla /images folder.
Page Category By default, only uncategorized articles are referred as Pages. Alternatively, define articles from a specific category as Pages by using the category alias.
Search Component Select the search module that you want to use when search is enabled in the Header settings.
System Assets Load Bootstrap, Font Awesome and jQuery. Bootstrap is only required when default Joomla template files are loaded, for example for the Joomla frontend editing. Load jQuery to write custom code based on the jQuery JavaScript library.
Next-gen Images Serve optimized image formats with better compression and quality than JPEG and PNG.
Syntax Highlighting Enable automatic syntax highlighting for any code block on your website. Use GitHub for light and Monokai for dark backgrounds.
Cache Clear cached images and assets. Images that need to be resized are stored in the theme's cache folder. After re-uploading an image with the same name, you'll have to clear the cache.
Theme Settings Export all theme settings and import them into another installation. This doesn't include content from the layout, style and element libraries or the template builder.

Note AVIF images are only generated in PHP 8.1 and later, and the GD extension must be compiled with AVIF support.

Note IPTC Photo Metadata can only be preserved for JPEG images. If needed, disable both next-gen images options. Mind that this will slow down loading times.

External Services

Provide API keys to integrate web services into your website.

Option Description
Google Maps Enter your Google Maps API key to use Google Maps instead of OpenStreetMap. It also enables additional options to style the colors of your maps.
Google Analytics Enter your Google Analytics ID to enable tracking. IP anonymization may reduce tracking accuracy.
Mailchimp API Token Enter your Mailchimp API key to use it with the Newsletter element.
Campaign Monitor API Token Enter your Campaign Monitor API key to use it with the Newsletter element.

System Check

This panel displays critical issues, improvements and recommendations for YOOtheme Pro. Refer to this panel in case of any issues with YOOtheme Pro.

System check


This panel shows the YOOtheme Pro version currently used on this site. A What's New modal and a changelog are also provided. Refer to this section after an update to see what has changed and what is new.


YOOtheme Pro Documentation