# Introduction

Thank you for choosing Kalium!  🎉&#x20;

You’re all set to create a great website, and we’re here to make it easy. Kalium has powered nearly 50,000 websites so far, and we’re excited to add yours to that list. This page will guide you through the basics, so you can get started quickly. Just follow the clear steps, and you’ll be on your way to building an amazing website!

<table data-column-title-hidden data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Getting Started</strong></td><td><a href="/pages/h7CJt5LEDfJVocGaCcdJ">/pages/h7CJt5LEDfJVocGaCcdJ</a></td></tr><tr><td><strong>Installation</strong></td><td><a href="/pages/ffCKWhW9rGEy434TaCd7">/pages/ffCKWhW9rGEy434TaCd7</a></td></tr><tr><td><strong>License</strong></td><td><a href="/pages/6mKICIi2Hv32uXcumOHt">/pages/6mKICIi2Hv32uXcumOHt</a></td></tr><tr><td><strong>Header</strong></td><td><a href="/pages/E9uJzJgJkYWWCVaLdl2E">/pages/E9uJzJgJkYWWCVaLdl2E</a></td></tr><tr><td><strong>Footer</strong></td><td><a href="/pages/v1DGYHKqWy65436O3ykM">/pages/v1DGYHKqWy65436O3ykM</a></td></tr><tr><td><strong>Sidebars</strong></td><td><a href="/pages/nLjlKuEh2FucsGj0kH5z">/pages/nLjlKuEh2FucsGj0kH5z</a></td></tr><tr><td><strong>Template Parts</strong></td><td><a href="/pages/U3mowJAIgACPZ2u17PgF">/pages/U3mowJAIgACPZ2u17PgF</a></td></tr><tr><td><strong>Blog</strong></td><td><a href="/pages/ap7UtChvFwZiwqDs8fZS">/pages/ap7UtChvFwZiwqDs8fZS</a></td></tr><tr><td><strong>Portfolio</strong></td><td><a href="/pages/3rlN40s7fNcFnE98WWQH">/pages/3rlN40s7fNcFnE98WWQH</a></td></tr><tr><td><strong>WooCommerce</strong></td><td><a href="/pages/eNtEa4Tc8GatORYsGSZL">/pages/eNtEa4Tc8GatORYsGSZL</a></td></tr><tr><td><strong>Typography</strong></td><td><a href="/pages/0bOLKxRigNCrZ7r8iYAU">/pages/0bOLKxRigNCrZ7r8iYAU</a></td></tr><tr><td><strong>Styling</strong></td><td><a href="/pages/us1I39KVyqnYPdUtmZVh">/pages/us1I39KVyqnYPdUtmZVh</a></td></tr><tr><td><strong>Translation</strong></td><td><a href="/pages/TDby0cboOGrVTbMD92yE">/pages/TDby0cboOGrVTbMD92yE</a></td></tr><tr><td><strong>Other</strong></td><td><a href="/pages/5OkiTgF5xKFi5mDrqsgp">/pages/5OkiTgF5xKFi5mDrqsgp</a></td></tr><tr><td><strong>Troubleshooting</strong></td><td><a href="/pages/1bQ6D2F5B0BU3yuByFXY">/pages/1bQ6D2F5B0BU3yuByFXY</a></td></tr></tbody></table>


# Before Getting Started

### What is Kalium?

Kalium is a WordPress theme that helps you create beautiful and functional websites easily. Whether you’re setting up a personal blog, a portfolio, a business site, or an online store, Kalium makes it simple to build websites for any kind of business. It’s a theme that works with WordPress, so it gives you lots of options to customize and design your site exactly the way you want.

### What Do You Need to Use Kalium?

* [**Hosting and Domain Name**](/getting-started/introduction/before-getting-started/hosting-and-domain): To use WordPress and Kalium, you’ll need a web hosting service and a domain name.
* [**WordPress Installation**](/getting-started/introduction/before-getting-started/wordpress-installation): Kalium is a theme for WordPress, so you need to have a working version of a WordPress.org installed on your server to use the theme.&#x20;
* [**Server Requirements**](/getting-started/introduction/before-getting-started/server-requirements): Before using Kalium, make sure your server meets the requirements for both WordPress and the theme. We’ll go over these requirements in detail later in this article.

For those who already have hosting, WordPress installed, and a server that meets the required specifications, you can skip directly to the [installation section ->](/getting-started/installation).


# Hosting and Domain

Choosing the right hosting provider is crucial for getting the most out of our themes. It’s important to pick a WordPress-friendly host that fits your needs in terms of location, pricing, and services.

While we don’t offer hosting services ourselves, we can recommend some great options. Check out our [Recommendations Page](https://kaliumtheme.com/recommendations/) to find a hosting provider that works for you.

From our experience, we suggest avoiding basic or shared hosting plans, as they often lack the necessary features and resources. These plans can lead to issues like failed starter site imports, problems with plugins, and incomplete page rendering.

To get the best performance with Kalium, select a hosting plan that meets the minimum [server requirements](/getting-started/introduction/before-getting-started/server-requirements).


# WordPress Installation

To install and start using Kalium, you need to have a working version of WordPress already set up on your site. If you haven’t installed WordPress yet or need help with the process, don’t worry—we’ve got you covered. Below are some valuable resources that provide detailed instructions and support for installing and setting up WordPress:

* [WordPress Codex](https://developer.wordpress.org/advanced-administration/before-install/howto-install/) – General info about WordPress and how to install it on your server.
* [First Steps With WordPress](https://wordpress.org/documentation/article/first-steps-with-wordpress-block-editor/) – General info about multiple topics about WordPress.
* [How to Use WordPress](https://firstsiteguide.com/learn-wordpress/)  – Easy to follow step-by-step guides on how to use WordPress.

{% hint style="info" %}
If you’re using **WordPress.com**, you’ll need the [Business plan](https://automattic.pxf.io/Y9moJq) to use Kalium. The Free, Personal, and Premium plans don’t support custom themes or plugins.
{% endhint %}


# Server Requirements

To get the most out of Kalium and have smooth experience with WordPress, it’s important that your hosting meets the following requirements:

* Using the latest version of [WordPress](https://wordpress.org/).
* [PHP](https://www.php.net/) version 7.4 or greater. *(Note: Kalium is compatible with PHP 8.2)*
* [MySQL](https://www.mysql.com/) version 8.0 or greater OR [MariaDB](https://mariadb.org/) version 10.5 or greater.
* [HTTPS](https://wordpress.org/news/2016/12/moving-toward-ssl/) support
* The minimum [requirements](https://wordpress.org/about/requirements/) to run WordPress.

### Recommended PHP configuration limits <a href="#recommended-php-configuration-limits" id="recommended-php-configuration-limits"></a>

If you’re experiencing issues like a white screen, problems with importing starter sites, blank pages, or issues with saving settings, it’s likely due to low PHP configuration limits. The best fix is to increase these limits.

You can either adjust these settings yourself or ask your web host to increase them for you. We recommend setting the limits to at least the following:

```
max_execution_time = 120
```

```
memory_limit = 128M
```

```
post_max_size = 32M
```

```
upload_max_filesize = 32M
```

```
max_input_time = 60
```

```
max_input_vars = 3000
```

### How to Check Your Current PHP Limits

To check your PHP limits, go to the WordPress admin dashboard and under **Kalium > Status** find the **Server Environment** section . If you need help, you can also contact your hosting provider to find out your current settings and ask them to make adjustments if needed. Remember, you’re paying for your hosting service, so make sure you’re getting the full value.

<figure><img src="/files/nkWzwh5tiJZJVbykfzqX" alt=""><figcaption></figcaption></figure>

### How to upgrade PHP version and increase server limits

In cases where you cannot update the PHP version yourself, you need to contact your host about this. The upgrade process is an easy process and should be something your host can do for you without impacting your website or charging you a fee. Here’s a letter you can send to your hosting company:

<details>

<summary>Emailing your hosting provider</summary>

Dear Support Team,

I hope this message finds you well. I am currently using the Kalium theme on my WordPress site, which recommends using PHP 7.4 or higher and MySQL 8.0 or MariaDB 10.5. WordPress also lists PHP 7.4 as the recommended version: <https://wordpress.org/about/requirements/>

Could you please confirm if my hosting supports PHP 7.4 or higher and provide instructions on how to upgrade? Additionally, I would appreciate it if you could increase the server limits to the following minimum values:

```
max_execution_time = 180
memory_limit = 128M
post_max_size = 64M
upload_max_filesize = 64M
max_input_time = 60
max_input_vars = 3000
```

Thank you for your assistance.

Best regards,\
\[Your Name]

</details>


# How To Purchase Kalium

Kalium is available for purchase exclusively through our website, it is a quite simple and straightforward process. Our payment processing platform, managed by [Freemius](https://freemius.com), provides a secure and flexible payment option. Let’s get started with the purchase process by visiting the pricing page:&#x20;

{% embed url="<https://kaliumtheme.com/pricing>" %}

### Step 1: Choose a Plan

<figure><img src="/files/SprwUBDr3EAGETq7Au9j" alt=""><figcaption></figcaption></figure>

Kalium offers three plans to suit different needs:

* **Personal**
* **Business**
* **Agency**

Each plan is available in two payment options:

* **Annual:** Provides access to the theme and support for one year, allowing you to receive updates, starter sites, and support for that duration.
* **Lifetime:** Offers lifetime access to the theme, including 3 years of support. The Lifetime plan ensures that you always have access to the theme and its features without worrying about annual renewals, providing long-term value and peace of mind.

After checking which plan fits you best, click the "**Buy Now**" button to continue with the purchasing journey.

If you change your mind about the plan you selected, don’t worry! You can easily upgrade or downgrade your license later on to better fit your needs.

### Step 2: Checkout

<figure><img src="/files/WXO7cgkcOXDqW6LH4z8S" alt=""><figcaption></figcaption></figure>

During the checkout process, you will need to provide the following information:

* **Email Address:** This is crucial as the license key will be sent to this email, and an account will automatically be created in our system.
* **First Name**
* **Last Name**
* **Phone Number (Optional)**

After entering your personal details, proceed to enter your billing information.

#### Select Your Payment Method

We support a variety of payment methods for flexibility and convenience:

* **Card:** You can pay using all major credit cards such as Visa, MasterCard, American Express, and Discover.
* **PayPal:** Alternatively, you can use your PayPal account for purchasing Kalium.

Once you have provided the necessary information and selected your payment method, click on the "**Review Order**" button to continue to the next step.

### Step 3: Review Your Order

<figure><img src="/files/jmnOGOc82EPt4ak5HYFP" alt=""><figcaption></figcaption></figure>

After you have provided your personal and billing details, you will be directed to a new step where you can review your order. Here, you will see a summary of the information you’ve entered and the plan you’ve selected.

Take a moment to review the details, and once you’re satisfied, click on the **"Pay & Subscribe"** button to finalize your purchase.

### Step 4: Confirmation

Upon successful payment, a new screen will appear confirming that your subscription was successful. This screen will provide you with a confirmation message, as shown in the image below:

<figure><img src="/files/tidfHhXSg5TnM4k3Smmu" alt=""><figcaption></figcaption></figure>

### Step 5: Check Your E-mail

After completing your purchase, check your email to confirm that your transaction was successful. The email will include all the important information as seen in the image below:

<figure><img src="/files/GZaC2n6SzlGOExhSBRzn" alt=""><figcaption></figcaption></figure>

Thank you for choosing Kalium! Enjoy exploring all the powerful features and capabilities of your new theme. We’re excited to see what you create!


# Installation

Now that you’ve purchased the Kalium theme, you’re all set to install it on your WordPress site. The installation process is quick and easy. There are two methods you can use:&#x20;

{% content-ref url="/pages/9jGsQFeKM2hqvB6lDtSN" %}
[Installing theme via WordPress](/getting-started/installation/installing-theme-via-wordpress)
{% endcontent-ref %}

{% content-ref url="/pages/NxoXHodj1eAUtNGX9tEA" %}
[Installing theme via FTP](/getting-started/installation/installing-theme-via-ftp)
{% endcontent-ref %}

To get started, we recommend using the WordPress method as it’s the most straightforward. If you prefer or need to use the FTP method, we’ve provided instructions for both in the following articles.


# Installing theme via WordPress

{% embed url="<https://www.youtube.com/watch?v=RbeiFrC1jp0>" %}

Installing the Kalium theme via WordPress is the simplest and most efficient method. This approach allows you to upload and activate the theme directly from your WordPress dashboard, making it quick and straightforward. Just follow the steps below to get Kalium up and running with minimal hassle.

### Step 1: Download Kalium

1. Log in to your [**Kalium Account**](https://kaliumtheme.com/account) page.
2. Go to the "**Downloads"** tab.
3. Click “**Download**” button next to the Kalium theme to download the **kalium.zip** file.

<figure><img src="/files/Q47x71JWmfhvWhyYXiPR" alt="Download Kalium from My Account page"><figcaption><p>My acount page with the Downloads tab active</p></figcaption></figure>

### Step 2: Install the Theme

1. Log in to your **WordPress dashboard**.
2. Go to **Appearance -> Themes**\
   &#x20;

   <figure><img src="/files/Xqw1iZDJ2pex3AKXlMEz" alt=""><figcaption></figcaption></figure>
3. Click on the **Add New Theme** button at the top of the page<br>

   <figure><img src="/files/Ia7anPNA2rD3WRCsPyIg" alt=""><figcaption></figcaption></figure>
4. Now click **Upload Theme** button in the same place<br>

   <figure><img src="/files/dMEiMuVZafQIw6ie75mB" alt=""><figcaption></figcaption></figure>
5. Click **Choose File**, then select the **kalium.zip** file you just downloaded.&#x20;
6. Click **Install Now**.
7. The installation is complete, click **Activate** to enable Kalium theme on your site<br>

   <figure><img src="/files/5xXmCgK1MKTfR0Tr4WjA" alt=""><figcaption></figcaption></figure>


# Installing theme via FTP

{% hint style="info" %}
If you haven’t tried [installing Kalium via WordPress](/getting-started/installation/installing-theme-via-wordpress) yet, please read that guide first before proceeding with this FTP method.
{% endhint %}

If you prefer or need to use FTP to install the Kalium theme, this method involves uploading the theme files directly to your server. While it requires a few more steps compared to the WordPress method, it’s useful if you encounter any issues with the dashboard installation. Follow the instructions below to upload and activate Kalium using FTP.

### Step 1: Download Kalium

1. Log in to your [**Kalium Account**](https://kaliumtheme.com/account) page.
2. Go to the "**Downloads"** tab.&#x20;
3. Click “**Download**” button next to the Kalium theme to download the **kalium.zip** file.

<figure><img src="/files/Q47x71JWmfhvWhyYXiPR" alt="Download Kalium from My Account page"><figcaption><p>My acount page with the Downloads tab active</p></figcaption></figure>

### Step 2: Set Up or Use an FTP Client

To start, you’ll need an FTP client. Popular options include [FileZilla](https://filezilla-project.org/) *(available for Windows and Mac)* and [Transmit](https://panic.com/transmit/) *(for Mac users)*. If you already use a different FTP client, you can continue with that.

1. Open your FTP client and log in to your website using your FTP credentials.
2. Once logged in, go to the `~/wp-content/themes/` directory on your server.

### Step 3: Upload the Theme Files

1. Unzip the downloaded Kalium theme file, named `kalium.zip`.&#x20;
2. Upload the unzipped `kalium` directory to the `themes` folder on your server. Make sure that you are placing the entire `kalium` folder inside `~/wp-content/themes/`.

<figure><img src="/files/G1gLkztioMs0TrZqy4uU" alt=""><figcaption><p>The <strong>kalium</strong> directory should appear inside the <strong>~/wp-content/themes/</strong> folder</p></figcaption></figure>

### Step 4: Activate the Theme

1. Login to your WordPress admin panel.
2. Go to **Appearances > Themes**.
3. Locate Kalium theme and click **Activate** to enable it on your site.

<figure><img src="/files/f9YhJP9kTTHH5owwXMR4" alt=""><figcaption></figcaption></figure>

By following these steps, you’ll have Kalium installed and activated on your WordPress site. If you run into any issues, make sure to check that all files were uploaded correctly and that you’re using the latest version of the theme.


# License Activation

{% embed url="<https://www.youtube.com/watch?v=RbeiFrC1jp0>" %}

Now that you've successfully installed and activated the Kalium theme, you need to activate the license to start enjoying all the features and updates. Follow these simple steps to activate your license:

### Step 1: Log In to Your Account

Go to the [Kalium Account](https://kaliumtheme.com/account) page and log in with your credentials.

{% embed url="<https://kaliumtheme.com/account>" %}

### Step 2: Copy Your License Key

Click on the "**Licenses**" tab on the left side of the page to see the licenses you have purchased, next to your Kalium license you have the key, when hovering you’ll see a copy icon — click this icon to automatically copy the license key to your clipboard.

<figure><img src="/files/3befL67vFhi3gGOV0wFc" alt=""><figcaption></figcaption></figure>

### Step 3: Activate License

Navigate to your WordPress admin dashboard and on the left side click **Kalium**, a license activation page should appear. Paste the license code you copied into the input field and click on the **Activate License** button to activate your license..

<figure><img src="/files/b0SoqSMkLXMjV1lxyDiy" alt=""><figcaption></figcaption></figure>

Once you complete the activation you should see the Kalium Dashboard page with a welcome message, you're all set — the license has been successfully activated and you have access to all theme features, updates and premium plugins.&#x20;

<figure><img src="/files/08yrnzsJSjHBFsrEjQ0L" alt=""><figcaption></figcaption></figure>


# Importing a Starter Site

{% embed url="<https://www.youtube.com/watch?v=fx1gx1e0u9A>" %}

Kalium offers a wide variety of full-paged starter sites, making it easy to kickstart your website for various types of businesses. These starter sites are crafted with Elementor and WPBakery Page Builder. With each big update, new starter sites are added, providing you with a growing selection of sites to choose from for your business.

### Before You Begin

Before importing any of our available starter sites, please make sure to check the system status. Go to the **System Status** tab to ensure your server meets all requirements for a successful import. Settings that need attention are listed in red.

### Step 1: Go to Starter Sites

First, access the Starter Sites section by navigating to the Kalium dashboard. In the top menu, click on “**Starter Sites**.” This section contains all the available starter sites:

<figure><img src="/files/7XIMHrHQYhgTiXqOsEVT" alt=""><figcaption></figcaption></figure>

### Step 2: Choose The Page Builder

Next, choose your preferred page builder. At the top right corner of the Starter Sites page, you will find a dropdown menu. Here, you can select either Elementor or WPBakery as your page builder.&#x20;

<figure><img src="/files/Xt1v6QOKlhrV2pMObUCD" alt=""><figcaption></figcaption></figure>

### Step 3: Select a Starter Site

Once you have selected your page builder, you can browse through the collection of starter sites. Hover over the desired template to see options to either import or preview it. Previewing the template allows you to see how it will look and function on your site before committing to the import. If you decide to use a template, click the “**Import**” button to proceed.

<figure><img src="/files/PXAFUoy2gcCT531J4xGC" alt=""><figcaption></figcaption></figure>

### Step 4: Choose What To Import

On the left side of this popup, you will see a list of required plugins for the starter site. These plugins will be automatically installed as part of the import process. On the right side of the popup, you can select specific content elements you want to import from the starter site. This customization allows you to import only the parts of the starter site that are relevant to your project.&#x20;

To begin the import process, click the “**Import**” button within the popup.&#x20;

<figure><img src="/files/LErQn3n5cv5ZwiTIhjxa" alt=""><figcaption></figcaption></figure>

The import process will start, and you will see a progress indicator explaining the status of the import. This indicator will provide real-time updates on what is being imported at each moment, from the list you have chosen will be imported, ensuring that you are informed about the progress and status of each element being imported.

<figure><img src="/files/WspLr9wActSpWUpyIjrj" alt=""><figcaption></figcaption></figure>

### Site Successfully Imported

Now that your starter site is imported, you can start customizing it to fit your business needs. The imported site will include all the necessary elements and plugins, making it easy for you to tweak and personalize the design.&#x20;

<figure><img src="/files/I9vyigrSX9zsiZwBXDdg" alt=""><figcaption></figcaption></figure>


# Installing Required Plugins

Installing required plugins for Kalium is straightforward and simple process, typically involving just a few clicks. Each plugin has a brief description of its functionality, version, and action buttons such as Install, Update, or Activate.

To maintain optimal site performance, it’s crucial to install only the plugins you need. While some plugins are marked as required and essential for the theme’s functionality, others are optional and should only be installed if necessary.&#x20;

Avoid installing extra plugins that are not needed, as they can impact your site’s speed and overall performance. Keeping your plugin list streamlined ensures that your site runs efficiently and provides the best user experience.

{% hint style="info" %}
If you are importing a [Starter Site](/getting-started/installation/importing-a-starter-site), there is no need to install plugins manually. The **Starter Site Import** process will automatically handle the installation and activation of required plugins for you.
{% endhint %}

### Required Plugins

**Advanced Custom Fields PRO** is the only required plugin for Kalium, necessary for the Parameters and Options area.

For some starter sites, additional plugins may also be needed. These plugins are not required for the core functionality of Kalium but are necessary for the full import and functionality of specific starter sites. They will be automatically installed when you import any of these starter sites.

### Installing Plugins

1. Login to **WordPress Admin** Dashboard

2. Go to **Kalium -> Plugins**<br>

   <figure><img src="/files/XPQRAfQXpBPDPXE8tzSF" alt=""><figcaption></figcaption></figure>

3. Click **Install** button

4. The plugin will be installed and activated automatically

### Updating Plugins

1. Login to **WordPress Admin** Dashboard

2. Go to **Kalium -> Plugins**

3. Plugins that have update are shown clearly with new version information<br>

   <figure><img src="/files/I0Mlhp233krTsig5Mbve" alt=""><figcaption></figcaption></figure>

4. Click **Update** button

5. The plugin will be updated and activated again

## Premium Bundled Plugins

When you buy Kalium, it comes with premium plugins like Slider Revolution, Advanced Custom Fields, WPBakery Page Builder, and LayerSlider included for free. We have paid for an extended license that lets us bundle these plugins with the theme at no extra cost to you.

Over time, the plugin authors have added extra features that we’re not allowed to include in our theme. Some of these plugins might ask you to enter a license key for those additional features or for direct support. You don’t need a separate license to use the core features included with Kalium.

You’ll always have access to the latest versions of these plugins with your Kalium theme, so you can enjoy their main functions without any extra charge. If you want to unlock advanced features or get support directly from the plugin creators, you would need to purchase a separate license.

\ <br>


# Child Theme

Sometimes, you might need to add extra code or make personalized modifications. A child theme allows you to make these changes without modifying the original Kalium theme files. This guarantees your customizations remain unchanged even when you update the main theme. It’s a smart approach to keep your site looking and functioning exactly how you want it, while also staying up-to-date with Kalium’s latest features.

### What is a Child Theme?

A child theme is essentially a theme that builds on the features and style of another theme, known as the parent theme. In this case, the Kalium theme serves as the parent. Instead of modifying the Kalium theme’s files, you make the changes in the child theme directly. This way, your changes stay as they are and won't get lost even when Kalium is updated.

### Benefits of Using a Child Theme

1. **Keep Your Customizations Safe**: Changes made in a child theme are kept separate from the Kalium parent theme. This means your custom tweaks are preserved when the parent theme is updated.
2. **Easy Updates**: Updating the Kalium parent theme is straightforward since your changes are stored in the child theme. You’ll benefit from the latest features and security updates without losing your custom work.
3. **Better Management**: Child themes help you keep your customizations organized. You can focus on your specific changes without dealing with the entire parent theme’s code.
4. **Simplified Troubleshooting**: If issues arise, you can switch back to the default settings of the Kalium parent theme to troubleshoot and resolve problems.

### How to Install the Kalium Child Theme

{% hint style="info" %}
**Note:** The child theme will not work if the [Kalium parent theme](/getting-started/installation/installing-theme-via-wordpress) is not installed first. Make sure that you have the Kalium parent theme installed and activated before setting up and using the child theme.
{% endhint %}

Installing the Kalium child theme is simple. Follow these steps to get started:

1. [**Download Kalium Child Theme**](https://api.kaliumtheme.com/downloads/kalium-child.zip) :arrow\_down:&#x20;
2. Log in to your **WordPress dashboard**.
3. Go to **Appearance -> Themes**\
   &#x20;

   <figure><img src="/files/Xqw1iZDJ2pex3AKXlMEz" alt=""><figcaption></figcaption></figure>
4. Click on the **Add New Theme** button at the top of the page<br>

   <figure><img src="/files/vGVnNWiG7noozPqT7oLJ" alt=""><figcaption></figcaption></figure>
5. Now click **Upload Theme** button in the same place<br>

   <figure><img src="/files/dMEiMuVZafQIw6ie75mB" alt=""><figcaption></figcaption></figure>
6. Click **Choose File**, then select the **kalium-child.zip** file you just downloaded.&#x20;
7. Click **Install Now**.
8. The installation is complete, click **Activate** to enable Kalium Child Theme theme on your site<br>

   <figure><img src="/files/u7hiFvCsGui12lJ5N9N0" alt=""><figcaption></figcaption></figure>

Once you have installed and activated the Kalium child theme, your WordPress dashboard's **Appearance -> Themes** section should display both the Kalium parent theme and the Kalium child theme. The Kalium child theme should be listed as the active theme, with the Kalium parent theme shown as an inactive theme. This setup confirms that the child theme is properly installed and ready for customization.

<figure><img src="/files/XFUL81svDkyIZsEEOFsh" alt=""><figcaption></figcaption></figure>

### Migrating from Parent Theme to Child Theme

If you have already completed your site using the Kalium parent theme and want to switch to the child theme without losing any of your customizations, you can do so easily by following a few simple steps. The Kalium child theme allows you to continue customizing your site while preserving all your previous settings and adjustments.

By following this process, you can ensure that all your theme options and personal settings are carried over to the child theme seamlessly, allowing you to take full advantage of the child theme’s benefits without starting from scratch. Let's migrate:

1. **Export Parent Theme Options**
   * Before activating the child theme, go to **Appearance -> Customize -> Manage Options**.
   * Export the options of the parent theme by clicking the **Export Theme Options** button.
   * A **yoursite-export.json** file should automatically start downloading in your computer.
2. **Activate the Child Theme**
   * Go to **Appearance -> Themes** and activate the **Kalium - Child Theme**, if you have not installed it yet follow the [guide above](#how-to-install-the-kalium-child-theme).
3. **Import Your Theme Options to Child Theme**
   * After activating the child theme, go to **Appearance -> Customize -> Manage Options**.
   * In the Import Options section select the **yoursite-export.json** file you just downloaded and click the **Import Theme Options** button.

That’s all! Your theme options will now be inherited by the child theme, preserving all your customizations.


# Updating Kalium

Updating Kalium is a simple process, similar as with any other WordPress theme. By keeping your theme up to date, you ensure you have the latest features, improvements, and security updates. Follow these simple steps to update your theme:

### 1. Check for Updates:

* Log in to your WordPress dashboard
* Go to **Dashboard** -> **Updates**
* If a new version of Kalium is available, it will be listed here

### 2. Update the Theme:

* In the Updates section, select Kalium and click **Update Themes**
* Alternatively, go to **Appearance** -> **Themes**, find Kalium, and click **Update Now** if an update is available

{% hint style="info" %}
Make sure your Kalium theme license is active, as it is necessary to download and install updates, and if it is expired, renew it through your account on the [Kalium](https://kaliumtheme.com) website.
{% endhint %}

### 3. Verify the Update:

After update completes, check your website to ensure everything is working correctly.

### Optional: Manual Update

Manual updates should be avoided as the automatic update process is preferred for a smoother and more reliable experience.&#x20;

The manual method requires more steps, including downloading the theme and uploading it via the WordPress admin panel or FTP, which can increase the risk of errors and complicate the update process.

#### Manual Update via WordPress

1. Go to [Kalium Account](https://kaliumtheme.com/account) page and login
2. Go to **Downloads** tab and click **Download** button
3. Go to **Appearance** -> **Themes**
4. Click **Add New Theme** button in the upper part of the page
5. Then click **Upload Theme** button and the upload form will be shown
6. Select or drag the downloaded archive file **kalium.\[version].zip**
7. Replace current version of the theme by clicking **Replace active with uploaded**
8. Theme is updated!

#### Manual Update via FTP

1. Go to [Kalium Account](https://kaliumtheme.com/account) page and login
2. Go to **Downloads** tab and click **Download** button
3. Delete the existing `kalium` folder inside `~/wp-content/themes`
4. Extract the zip file and upload it to your WordPress theme directory [via FTP](/getting-started/installation/installing-theme-via-ftp)
5. Theme is updated!

### Important Notes & Best Practices

#### Backup the theme

Whenever you update the theme, it’s essential to ensure that you have an up-to-date backup of your website and database, in case of errors or unwanted results.

Our theme automatically creates a backup of the previous theme version (files only) during the update process. This feature is enabled by default in **Kalium** -> **Settings** -> **Theme Backups**.

#### Clear the caches

It is always recommended to clear your browser cache, any caching plugins, and server cache after updating. Old cached files can cause visual issues or other problems following an update. Clearing your cache ensures that these issues are avoided and that your site reflects the latest changes.


# License

{% hint style="info" %}
This section focuses on the license as integrated mechanism into the theme, rather than the legal aspects of licensing.&#x20;

It explains how the license controls theme functionality, including the allowed number of activations, theme updates, starter site imports, bundled plugin installations, and support, as well as how to manage your license within our platform.
{% endhint %}

When you purchase the Kalium theme, your license comes with specific terms and restrictions based on the plan you selected.&#x20;

This license controls how you can use the theme, including updates, importing starter sites, installing or updating required plugins, and getting support.&#x20;

Understanding these restrictions and the number of allowed activations is essential for effectively managing your licenses.&#x20;

### License Activations

The number of license activations allowed is subject of the plan you selected at the time of purchase. Each plan specifies how many sites you can activate the theme on, and it’s [important to understand these limits](/getting-started/license/activation-scope). Be sure to review the details of your chosen plan to understand the activation limits and manage your licenses accordingly.

### Feature Restrictions

The table below describes the functionality restrictions based on license status:

|                                            | No license activated       | Expired license activated  | Valid license activated    |
| ------------------------------------------ | -------------------------- | -------------------------- | -------------------------- |
| Customize Theme                            | :ballot\_box\_with\_check: | :ballot\_box\_with\_check: | :ballot\_box\_with\_check: |
| [Dashboard Access](#user-content-fn-1)[^1] | :heavy\_multiplication\_x: | :ballot\_box\_with\_check: | :ballot\_box\_with\_check: |
| Update Theme                               | :heavy\_multiplication\_x: | :heavy\_multiplication\_x: | :ballot\_box\_with\_check: |
| Install or Update Bundled Plugins          | :heavy\_multiplication\_x: | :heavy\_multiplication\_x: | :ballot\_box\_with\_check: |
| Import Starter Sites                       | :heavy\_multiplication\_x: | :heavy\_multiplication\_x: | :ballot\_box\_with\_check: |
| Support                                    | :heavy\_multiplication\_x: | :heavy\_multiplication\_x: | :ballot\_box\_with\_check: |

[^1]: Theme Dashboard


# Managing Licenses

Our licensing mechanism is efficiently managed by our trusted partner, [Freemius](https://freemius.com), ensuring a seamless and secure licensing experience for all our users.

This account management system allows you to view, update, and renew your licenses with ease. Additionally, it provides an overview of your license status, renewal dates, theme download, and access to any related documentation.

### Account Dashboard

The Account page is your central hub for managing licenses, subscription and billing details, and for downloading theme files.

To access the account dashboard visit this link:

{% embed url="<https://kaliumtheme.com/account>" %}
<https://kaliumtheme.com/account>
{% endembed %}

Enter the login credentials you created at the time of purchase. If you previously bought from Freemius, you should already have your account credentials.

<figure><img src="/files/9iVHHptaYLSz4oT4X8Fw" alt=""><figcaption><p>Users dashboard for managing licenses, downloading theme files and updating profile and billing details</p></figcaption></figure>

### Licenses

Access your licenses by clicking **Licenses** link in the menu:

<figure><img src="/files/VoAI0QiJC3J9Eps2u0GX" alt=""><figcaption><p>The list of purchased licenses</p></figcaption></figure>

### License Details

In the list of licenses above, click on your desired license to view more details and perform additional tasks, such as viewing/copy **License Key,** **White Labeling**, **Restricting Sites**, or upgrading or downgrading your license. In case of upgrading or downgrading its important to read the [Prorating Plan Updates](/getting-started/license/prorating-plan-updates)

### Other Ways

You can also access your license information through the emails you received at the time of Kalium purchase. These emails contain all the important information about your license, including your credentials, which you can refer to as needed.


# Activation Scope

Understanding the activation scope of Kalium is crucial for selecting the plan that best fits your needs. This article will help you determine what constitutes an active installation and how the licensing mechanism supports different activation instances.

An active installation refers to the number of live websites where Kalium has been activated using the license. Each plan specifies a limit on the number of sites where the theme can be activated. This limit ensures that the license is used in accordance with the terms of the selected plan.

### Staging Environment

To support development and testing, the licensing mechanism allows for a staging environment that is not counted towards your activation limit. This means you can set up a staging site for testing or development purposes without affecting the number of active installations covered by the license.

#### TLDs that are considered as dev or staging <a href="#tlds_that_are_considered_as_dev_or_staging" id="tlds_that_are_considered_as_dev_or_staging"></a>

* `*.dev`
* `*.dev.cc` (DesktopServer)
* `*.test`
* `*.local`
* `*.staging`
* `*.example`
* `*.invalid`
* `*.myftpupload.com` (GoDaddy)
* `*.cloudwaysapps.com` (Cloudways)
* `*.wpsandbox.pro` (WPSandbox)
* `*.ngrok.io` (tunneling)
* `*.mystagingwebsite.com` (Pressable)
* `*.tempurl.host` (WPMU DEV)
* `*.wpmudev.host` (WPMU DEV)
* `*.websitepro-staging.com` (Vendasta)
* `*.websitepro.hosting` (Vendasta)
* `*.instawp.xyz` (InstaWP)

#### Subdomains that are considered as dev or staging: <a href="#subdomains_that_are_considered_as_dev_or_staging" id="subdomains_that_are_considered_as_dev_or_staging"></a>

* `local.*`
* `dev.*`
* `test.*`
* `stage.*`
* `staging.*`
* `stagingN.*` (SiteGround; `N` is an unsigned int)
* `*.wpengine.com` (WP Engine)
* `dev-*.pantheonsite.io` (Pantheon)
* `test-*.pantheonsite.io` (Pantheon)
* `staging-*.kinsta.com` (Kinsta)
* `staging-*.kinsta.cloud` (Kinsta)

Additionally, if your domain is `localhost` (with any port), it will also be treated as a localhost domain.

### Activation Scope on a Multi-Site Network

Kalium is compatible with multi-site networks, allowing you to use the theme across multiple sites within the same network. However, it’s important to note that each unique domain outside of the staging or development list is counted towards your activation limit. If your multi-site setup includes different domains, each one will require a separate license to comply with the activation scope.


# Prorating Plan Updates

We support prorating of plan upgrades & downgrades.

Unlike the commonly used prorating implementations which preserve the renewal payment processing time, Freemius’ proration works slightly different and will restart the billing date based on the time of the plan update. This methodology simplifies understanding the discount for the customers and also benefits the sellers who will receive the initial worth of the new plan (minus the discounts) for the full billing period right away.

### Proration from a Lifetime License <a href="#proration_from_a_lifetime_license" id="proration_from_a_lifetime_license"></a>

Customers who purchased a lifetime plan will be eligible for a *proration* discount only if they update their plan within 30 days from the time of purchase. The *proration* discount is calculated as follows:

```
proration_discount = min(prev_lifetime_payment, new_lifetime_price)
```

**Examples:**

* If a user purchased a single-site lifetime pro license for $300 and after 3 days upgrades to a 5-site lifetime pro license for $600, they are only charged $300 for the upgrade.
* If a user purchased a single-site lifetime starter license for $150 and after 6 days upgrades to a single-site lifetime business plan for $400, they are only charged $250 for the upgrade.
* If a user purchased a single-site lifetime pro license for $300 and after 2 months upgrades to a 5-site lifetime pro plan for $600, they are charged the full $600.

To understand why lifetime upgrades aren’t just calculated as the difference in price, regardless of how long ago the original purchase was, the following two scenarios may help:

> A customer purchases a lifetime license for $300. Then, after 5 years (intentionally exaggerated time for emphasis) decides to upgrade for a higher $500 plan. If you discount them with $300 it basically means that they’ve used your product/license/support for free for 5 years. If a different customer purchase that same lifetime plan for $500 at the same time the other user upgrades from the $300 to the $500 plan, they both end up paying the exact same amount in total ($500), yet, the 1st customer already been using the product for 5 years.

> Or another example, to drive it home (pun intended!). Let’s say you buy a car and then after 5 years decide to buy a more expensive one from the same brand. Would you expect to get your money back? No, because you’ve already used the product, which is analogous to receiving support (aka warranty).

Therefore, we have the 30-day time limit in place to protect from this edge case.

### Proration from a Subscription <a href="#proration_from_a_subscription_monthly_or_annual" id="proration_from_a_subscription_monthly_or_annual"></a>

Customers which are updating a plan that was purchased as a subscription will receive a *proration* discount, based on the unused portion of their previous plan:

```
remaining_period = (1 - number_of_days_past_from_the_old_plan_last_payment / number_of_days_in_past_billing_cycle )
proration_discount = max(0, remaining_period x old_plan_last_payment )
```

**Examples:**

* If a user purchased a single-site monthly pro package for $10 per month and after 2 months and 15 days upgrades to the annual billing cycle of the same single-site pro plan for $100 per year – the customer will have already paid $10, and will have used half of their current billing cycle. Therefore, the initial *prorated* amount will be $95 ($100 – $10 / 2).
* If a user subscribed to a single-site annual pro license for $100 per year and after 3 months decides to downgrade to a single-site annual starter plan for $80 per year – the customer will already have paid $100, and have used only a quarter of the current billing cycle. Therefore, the *proration* discount for the remaining period will be $75, and the initial price for the single-site annual starter plan will be $5 ($80 – $75). The first renewal payment will be scheduled for a year from the downgrade date and will cost $80.

### Proration with Coupons <a href="#proration_with_coupons" id="proration_with_coupons"></a>

When updating a plan with a percentage-based coupon, the *proration* discount will be calculated first, and the coupon discount will apply to the discounted price as the last discount.

<br>


# Dashboard

Theme Dashboard is an important section where you can find useful information about the theme, manage your license, access quick links for site editing, find help resources, and explore other features related to Kalium.

You will see your currently purchased plan, including the remaining support period and the theme version number. These elements are interactive: they will display when your support is about to expire and notify you of available theme updates without needing to visit the Updates page.

You can easily navigate through several sections: **Starter Sites** for importing demo content, **Plugins** for managing and installing essential tools, **Status** for monitoring your site’s health, **Settings** for adjusting global theme options, and **Changelog** for reviewing recent updates and changes.

<figure><img src="/files/7XIMHrHQYhgTiXqOsEVT" alt=""><figcaption><p>On overview of the welcome screen on Theme Dashboard</p></figcaption></figure>


# Customizer

The Customizer is where you can edit Kalium’s look and functionality. It allows you to adjust theme options such as colors, layouts, and widget placements. With real-time previews, you can see how changes affect your site before applying them, making it easy to customize the theme to fit your design preferences.

Changes made in the Customizer can be scheduled and drafted according to your preferences, or published immediately. This feature enables you to plan and prepare updates in advance, ensuring that your site reflects the desired changes at the right time without immediate publication.

### How to Start Customizing

To access the Customizer, simply go to **Appearance** -> **Customize** from the WordPress Admin menu.

<figure><img src="/files/w7MfhMHcB35gHGkubdfT" alt=""><figcaption><p>The left side are Customizer Sections and Options, right side is the Site Preview frame</p></figcaption></figure>

You can use the search function to quickly navigate to your desired sections or options.

Each control option is self-explanatory, and for additional information, you can hover over the question mark icon <img src="/files/w6wKgoZPd0XWJHtKXlf7" alt="" data-size="line">  to read more about the function of that setting.

Responsive controls are located at the bottom of the Customizer, allowing you to switch between device viewports and preview changes within the site frame.

### Responsive Controls

Responsive controls feature an icon representing different device screens.&#x20;

Clicking this icon allows you to switch between viewports such as *Desktop*, *Tablet*, and *Mobile*. Any values you enter are applied specifically to the selected viewport.&#x20;

Values are inherited from *Desktop* -> *Tablet* -> *Mobile*, meaning that if you set a value for *Desktop*, it will also apply to *Mobile* unless you specify a different value for *Mobile*. However, setting a value for *Mobile* will not override the *Desktop* or *Tablet* settings.


# Migrating from Kalium 3 to 4

Upgrading from **Kalium 3** to **Kalium 4** is more than just a simple update—it’s a significant leap forward.

Kalium 4 brings many exciting updates that make building your website easier and more powerful. It has faster performance, better customization options, and a simpler, more user-friendly design, making it feel like a brand-new tool that meets today’s web design trends.

With this major upgrade, we’ve also moved from the ThemeForest marketplace to our own dedicated platform. This shift allows us to offer you more pricing options, exclusive deals, and a better user experience. By bringing everything under one roof, we can provide better support and a more personalized approach to your needs. For the reasons behind this change, you can [read more here](https://kaliumtheme.com/platform-change).

In this article, you’ll find step-by-step instructions on how to creata a staging site, migrate your license, access new features, and make the most of Kalium 4.

## 1. Create a Staging Website

The safest way to upgrade is to create a staging copy of your current site. There are several ways to create a staging site, including the following methods:

{% tabs %}
{% tab title="Using WP Toolkit" %}
**Using WP Toolkit**

{% embed url="<https://www.youtube.com/watch?v=bKrNZENgils>" fullWidth="false" %}

This free and straightforward method allows you to quickly create a staging site by cloning your existing WordPress installation. WP Toolkit manages the process, including copying files and the database, to set up a separate staging environment in few seconds.

1. Log in to **cPanel** and open **WP Toolkit**.
2. Select the WordPress installation you want to create a staging site for.
3. In the **Dashboard** tab click **Clone** link right below the tabs.
4. Clone the site in **staging** subdomain.
   {% endtab %}

{% tab title="Using WordPress Plugins" %}
**Using WordPress Plugins**

{% embed url="<https://www.youtube.com/watch?v=_YLHGuWf80k>" %}

This method involves using plugins to create a staging site and provides a straightforward way to duplicate your site for testing.

Popular plugins for this purpose include:

* **All-in-One WP Migration:** Provides an easy way to export and import your site for staging purposes.
* **UpdraftPlus:** Offers staging features in its premium version.

These plugins handle the duplication process and set up a staging environment efficiently.

{% hint style="info" %}
When creating a staging site from the WordPress admin dashboard, ensure that the necessary PHP limits are configured to prevent the process from failing. This includes increasing the **memory limit**, **max execution time**, and **upload size**.
{% endhint %}
{% endtab %}

{% tab title="Using WP-CLI" %}
**Using WP-CLI**

{% embed url="<https://www.youtube.com/watch?t=0&v=Mgsg1LdbiCw>" %}

This method is for more advanced users. [WP-CLI](https://wp-cli.org) is a command-line tool for managing WordPress installations. This method automates the process and is ideal for users familiar with command-line interfaces. Unlike some WP plugins, it doesn't require any additional costs.

We'll create a staging site within the same environment as your live site. We assume you have:

* Blank Database: `my_staging_db`
* Live Site Path: `/path/to/live-site/`
* Staging Site Path: `/path/to/staging-site/`

Step-by-Step Process:

1. Navigate to the Live Site Directory:

   ```sh
   cd /path/to/live-site/
   ```
2. Copy Files to the Staging Directory:

   ```sh
   cp -r . /path/to/staging-site/
   ```
3. Export the Live Site Database:

   ```bash
   wp db export /path/to/staging-site/my-exported-db.sql
   ```
4. Move to the Staging Site Directory:

   ```bash
   cd /path/to/staging-site/
   ```
5. Remove .htaccess to Avoid Redirection Issues:

   ```bash
   rm .htaccess
   ```
6. Update the Database details in the Configuration File:

   ```bash
   wp config set DB_NAME my_staging_db
   wp config set DB_USER my_user
   wp config set DB_PASS my_pass
   wp config set DB_HOST localhost
   ```
7. Import the Live Site Database into the Staging Database:

   ```bash
   wp db import my-exported-db.sql
   ```
8. Replace All URLs in the Database:

   ```bash
   wp search-replace 'my-live-site.com' 'staging.my-live-site.com'
   ```

And that’s it! Your staging site should now be up and running with the copied content and database from your live site.
{% endtab %}
{% endtabs %}

## 2. Migrate to Kalim 4

Migrating from Kalium 3 to Kalium 4 is designed to be as smooth and straightforward as possible, there are two methods of migrating and updating to Kalium 4: automatic and manual migration.

**Automatic Migration** provides a streamlined process directly within your WordPress dashboard. This method is ideal if you prefer a hassle-free upgrade experience. By following the step-by-step instructions, you can transfer your license and update your theme with just a few clicks.&#x20;

On the other hand, **Manual Migration** offers a more hands-on approach for those who may need or prefer to handle the upgrade process manually. This method involves several steps, including transferring your license and updating the theme manually.&#x20;

{% content-ref url="/pages/YwtGKKq0GtB0CNHLOOaH" %}
[Migrating Automatically](/getting-started/migrating-from-kalium-3-to-4/migrating-automatically)
{% endcontent-ref %}

{% content-ref url="/pages/t1lQ5XrRWaHVwF52VP7p" %}
[Migrating Manually](/getting-started/migrating-from-kalium-3-to-4/migrating-manually)
{% endcontent-ref %}

After transferring your license, you will receive an additional 3 months of support.&#x20;

* **If your support subscription is inactive**, this will give you 3 months of support and updates.&#x20;
* **If you have an active support subscription**, it will be extended by 3 months. For example, if your support ends on January 1, 2025, it will now end on April 1, 2025.

{% hint style="warning" %}
**Important:** Only users who purchased Kalium from ThemeForest **before October 1, 2024**, are eligible to receive an extra 3 months of free support and updates when transferring their license to Kalium 4.
{% endhint %}

After your 3 months of support expire, you can choose to renew your license to continue receiving future updates and support. It’s important to note that renewing your license is not required for your website to continue functioning. Websites built with Kalium will remain fully operational without any issues. However, renewing your license is recommended to maintain access to updates, starter sites, and dedicated support. Without renewal, you may miss out on these benefits, but your website itself will continue to operate smoothly.


# Migrating Automatically

Upgrade from Kalium 3 to Kalium 4 effortlessly by following our step-by-step guide for automatic migration. This method streamlines the process through your WordPress dashboard, handling license transfer and theme updates with minimal effort on your part. Ideal for a smooth and hassle-free upgrade.

As part of our transition from Kalium 3 to Kalium 4, we’ve moved to a new licensing platform, Freemius. To continue receiving updates and access Kalium 4, you need to transfer your existing ThemeForest license to Freemius. This process is straightforward and ensures you maintain access to all the features of the new version.

{% embed url="<https://www.youtube.com/watch?v=iN4sqbo59T0>" %}

### Step 1: Go to WordPress Dashboard

Start by logging into the WordPress dashboard on the site where you have Kalium installed. This is where you will initiate the license transfer and upgrade process.

***

### Step 2: Navigate to Laborator -> Kalium 4

In the WordPress dashboard, look for the Laborator section in the left-hand menu. Click on the **Kalium 4** button to proceed to the license transfer section. Once you’re on the Kalium 4 page, scroll down to find the “**Transfer Your License & Upgrade to Kalium 4**” section. This area will guide you through the steps needed to migrate your license and update your theme.

***

### Step 3: Enter your theme Purchase Code

You will need to use your Kalium 3 purchase code from ThemeForest, this can be obtained from ThemeForest by going to the top right area <mark style="color:blue;">Profile -> Downloads</mark>, in the Downloads page locate Kalium and choose any of the <mark style="color:blue;">License Certificate & Purchase Code</mark>. A file will be downloaded, where you can copy the purchase code.

<div><figure><img src="/files/7zUv95WOD77HVGyUjVS3" alt="" width="375"><figcaption><p>How to get the Purchase Code</p></figcaption></figure> <figure><img src="/files/EozPKJnZhs1jU8v6w8Wk" alt="" width="375"><figcaption><p>Purchase code can be found here</p></figcaption></figure></div>

### Step 4: Transfer License and Upgrade to 4

Go back to your WordPress dashboard. Under the “**Transfer Your License**” section, enter the email address you want to use for your Freemius account. Paste the Item **Purchase Code** you copied into the appropriate field.&#x20;

After entering your email and purchase code, a pop-up will appear asking if you have reviewed the migration steps. Confirm your understanding and click “**Upgrade Now**” to start the license transfer process.

The license transfer and theme upgrade will now proceed in the background. This process may take a few moments. Once the transfer is complete and your theme is updated to Kalium 4, you will be automatically redirected to the new Kalium 4 dashboard.

### Step 5: Run the Database Upgrade

Upon being redirected to the new dashboard, you will see a notice indicating “Database Upgrade Required”.  Kalium 4 automatically detects any earlier versions of the theme and will display a migration notice along with a **Run Upgrade** button: This notice means that you need to run a database upgrade to ensure compatibility with Kalium 4. Click the “**Run Upgrade**” button.

{% hint style="warning" %}
After clicking **Run Upgrade** button, the process will begin, and you should not interrupt it under any circumstances!
{% endhint %}

<figure><img src="/files/SRnF0yErOariuPZCkPnW" alt=""><figcaption></figcaption></figure>

After the database upgrade is completed, the button will show this message "**Upgrade completed**”. This confirms that the migration and upgrade processes are fully finished. It’s a good practice to review your site to make sure everything is functioning as expected and make any necessary adjustments.

<div><figure><img src="/files/nieWgP7BtQfC0GdIFOX3" alt="" width="375"><figcaption><p>Upgrade in progress</p></figcaption></figure> <figure><img src="/files/yLLoHrwtJUDj4BIZ1nc2" alt="" width="375"><figcaption><p>Upgrade completed</p></figcaption></figure></div>

After this, ensure that your site appears as expected and make any necessary adjustments to address remaining issues.

You can also confirm if the upgrade was applied successfully by accessing System Status page at **Kalium -> Status -> Database Upgrades**:

<figure><img src="/files/UtVapvwexug4T9WFeiLF" alt=""><figcaption></figcaption></figure>

Once everything is complete and you have confirmed that your staging site is functioning correctly, you can proceed to migrate the updates from staging to your live site. Follow the same steps used for the staging environment to ensure a smooth transition. This will help you apply the latest changes to your live site with minimal disruption and ensure that everything remains consistent and functional.​


# Migrating Manually

For a more hands-on approach, our manual migration guide provides detailed instructions to upgrade from Kalium 3 to Kalium 4. This method involves transferring your license and updating the theme manually, giving you greater control over the process. Perfect for those who prefer or need a more involved migration, this guide will walk you through each step to ensure a successful upgrade.

## 1. Transfer License

As part of our transition from Kalium 3 to Kalium 4, we’ve moved to a new licensing platform, Freemius. To continue receiving updates and access Kalium 4, you need to transfer your existing ThemeForest license to Freemius. This process is straightforward and ensures you maintain access to all the features of the new version.

***

### Step 1: Go to the Transfer License page.

{% embed url="<https://kaliumtheme.com/transfer-license/>" %}

***

### Step 2: Enter your email address

Enter the email address you want to use for your account. If you already have a Freemius account, please use the same email address. If you don’t have an account yet, this process will create one for you.

***

### Step 3: Enter your theme Purchase Code

You will need to use your Kalium 3 purchase code from ThemeForest, this can be obtained from ThemeForest by going to the top right area <mark style="color:blue;">Profile -> Downloads</mark>, in the Downloads page locate Kalium and choose any of the <mark style="color:blue;">License Certificate & Purchase Code</mark>. A file will be downloaded, where you can copy the purchase code.

<div><figure><img src="/files/7zUv95WOD77HVGyUjVS3" alt="" width="375"><figcaption><p>How to get the Purchase Code</p></figcaption></figure> <figure><img src="/files/EozPKJnZhs1jU8v6w8Wk" alt="" width="375"><figcaption><p>Purchase code can be found here</p></figcaption></figure></div>

### Step 4: Click "Transfer License"

Once you click the "**Transfer License**" button, an account will be created for you automatically. You will receive an email with important information, with the login link, where you can download Kalium 4.&#x20;

You’ll also be able to set up your password for this account later on.

## 2. Install Kalium 4

{% embed url="<https://www.youtube.com/watch?v=RbeiFrC1jp0>" %}

After completing the second step, it's time to upload the latest version of Kalium:

1. [Upload the latest Kalium](/getting-started/installation/installing-theme-via-wordpress) version to the staging environment.
2. [Activate the license](/getting-started/installation/license-activation) in the staging environment.

## 3. Database Upgrade

{% embed url="<https://youtu.be/mg90APhMvR8>" %}

Kalium 4 automatically detects any earlier versions of the theme and will display a migration notice along with a **Run Upgrade** button:

<figure><img src="/files/SRnF0yErOariuPZCkPnW" alt=""><figcaption></figcaption></figure>

It is important to note that this notice only appears once the theme license is successfully activated. This prevents accidental upgrades, as you will need to access the Kalium dashboard post-upgrade, which requires theme license activation.

{% hint style="warning" %}
After clicking **Run Upgrade** button, the process will begin, and you should not interrupt it under any circumstances!
{% endhint %}

<div><figure><img src="/files/nieWgP7BtQfC0GdIFOX3" alt="" width="375"><figcaption><p>Upgrade in progress</p></figcaption></figure> <figure><img src="/files/yLLoHrwtJUDj4BIZ1nc2" alt="" width="375"><figcaption><p>Upgrade completed</p></figcaption></figure></div>

After this, ensure that your site appears as expected and make any necessary adjustments to address remaining issues.

You can also confirm if the upgrade was applied successfully by accessing System Status page at **Kalium -> Status -> Database Upgrades**:

<figure><img src="/files/UtVapvwexug4T9WFeiLF" alt=""><figcaption></figcaption></figure>

Once everything is complete and you have confirmed that your staging site is functioning correctly, you can proceed to migrate the updates from staging to your live site. Follow the same steps used for the staging environment to ensure a smooth transition. This will help you apply the latest changes to your live site with minimal disruption and ensure that everything remains consistent and functional.​


# Header

{% embed url="<https://www.youtube.com/watch?v=RczSrKJCzqA&feature=youtu.be>" %}

The header is a versatile and integral part Kalium, offering a range of customization options to suit any design preference. It serves as the primary navigation and branding area, and with its extensive layout possibilities, you can create a header that complements your site’s overall aesthetics.

This flexible structure allows you to create a header that seamlessly integrates with your site’s design and enhances its functionality.

To customize the header go to **Appearance -> Customize -> Header**

You can choose between pre-defined header types (or layouts): **Standard**, **Fullscreen**, **Off-Canvas Side**, **Off-Canvas Top** or build your own layout with **Custom** header type. The upcoming sections will guide you through the process of creating each header type.

<figure><img src="/files/RB9yksv8ZJD6o2k1jaZp" alt="" width="319"><figcaption><p>Available header types</p></figcaption></figure>

### Structure of Header

The header can be organized into three distinct rows, each serving a unique purpose:

* Top Row (Top Bar)
* Main Row
* Bottom Row

Each row can be customized to align with your design preferences.

### Logo Placement

The logo is placed in the ***main row*** of the header, with a default alignment to the left (or right for RTL sites).&#x20;

It will appear as configured in your settings under [**Appearance -> Customize -> Styling -> Brand**](/styling/brand-and-logo).


# Layouts

In this section, you’ll learn how to create a header using the pre-defined layout types.

Selecting a pre-defined header type only impacts the main row by setting the menu type in use.&#x20;

This approach is based on the original version of Kalium, which users are familiar with for setting up headers. For a more advanced structure, you can always create a [**Custom**](/general/header/custom-header) header type, which will be explained in the upcoming article.

***

### Standard

This header type will either show navigation menu with plain links and their sub menus, or the toggle button that shows/hides the links when animation when clicked.

<figure><img src="/files/dDBiLRX6hji4FPqLILvs" alt="" width="323"><figcaption></figcaption></figure>

**Hamburger Menu**\
When checked, the header will include a menu toggle button (alternatively called Hamburger Menu toggle) which will display the navigation links besides the button on the left side.

**Animation**\
This option appears after enabling the Hamburger Menu and controls the animation for showing and hiding the root-level navigation links.

[Standard style options ->](/general/header/styling#menu)

***

### Fullscreen

This header type will display only the Hamburger Menu toggle, which, when clicked, reveals the navigation menu as an overlay with a smooth animation.

<figure><img src="/files/A0LivnwHv9Qmp6nhCQt5" alt="" width="322"><figcaption></figcaption></figure>

**Content Alignment**\
The placement of the navigation menu determines its layout: the *Left* and *Centered* options display menu links as a vertical list, while the *Horizontal* option arranges menu items in a horizontal row.

**Search Field**\
Optionally, you can add a search bar as the last item in the menu, allowing users to search your site easily.

[Fullscreen style options ->](/general/header/styling#fullscreen-menu)

***

### Off-Canvas Side

This header type displays a [*Hamburger Button*](#user-content-fn-1)[^1] that toggles the menu with a drawer animation from either the left or right side. It can also include widgets in addition to the default navigation.

<figure><img src="/files/g0zJIOoEgUJ4AT565Yov" alt="" width="328"><figcaption></figcaption></figure>

**Menu**\
The navigation menu to show or hide completely by selecting *(No menu)* option.

**Widgets**\
Choose whether to display widgets within the menu container. The widgets displayed here are sourced from the **Off-Canvas Side** sidebar.

**Alignment**\
Adjust the alignment of the menu container, by default opens from right side.

**Force Include**\
This option is rarely used, but in case you want the menu to be triggered by a different element on page, you can do so by adding a class `.sidebar-menu-toggle` to the element that will trigger the **Off-Canvas Side** menu.

[Off-Canvas Side style options ->](/general/header/styling#off-canvas-side)

***

### Off-Canvas Top

This header type is similar to previous type which displays a [*Hamburger Button*](#user-content-fn-1)[^1] that toggles the menu from the top of window. It can also include widgets in addition to the default navigation.

<figure><img src="/files/JmooPb8ZsIouBaiz8vqR" alt="" width="328"><figcaption></figcaption></figure>

**Menu**\
The navigation menu to show or hide completely by selecting *(No menu)* option.

**Items per Row**\
Divides the navigation menu items into columns within each row.

**Widgets**\
Choose whether to display widgets within the menu container. The widgets displayed here are sourced from the **Off-Canvas Top** sidebar.

**Columns**\
Determines how many columns the widgets are divided into.

**Container**\
Defines the size of the widget container relative to the Menu Container.

**Force Include**\
This option is rarely used, but in case you want the menu to be triggered by a different element on page, you can do so by adding a class `.top-menu-toggle` to the element that will trigger the **Off-Canvas Top** menu.

[Off-Canvas Top style options ->](/general/header/styling#off-canvas-top)

[^1]: toggle button


# Custom Header

Custom Header type offers a flexible drag-and-drop interface, allowing you to design your header with *12 unique, customizable elements*. Each element comes with its own set of options and can be tailored for visibility across different device viewports. For further customization, you can also apply Custom CSS on element level, giving you full control over its styling.

Once you select the Custom type, the Header Builder section will appear. Clicking on it will take you to the layout builder.

<figure><img src="/files/OIazXohCNFqQnlOSZZyL" alt="" width="325"><figcaption><p>Content sections on header builder</p></figcaption></figure>

* **Left Content**\
  Includes elements positioned to the left of the logo. If left empty, the container will be hidden, resulting in a main row structure with the logo and header elements aligned to the right.
* **Right Content**\
  Includes elements positioned to the right of the logo.
* **Bottom Content**\
  Includes elements positioned below the logo in the bottom row.

Elements can be dragged and repositioned between the above sections. Clicking the :eye: eye icon will toggle its visibility of the element.

To add a new element click :heavy\_plus\_sign: **Add** and the popup with element types will be shown. Disabled elements require certain plugin to be active in order to be enabled.

The following article will detail the purpose and usage of each element.​<br>


# Elements

Elements are a key part of the Custom Header Builder, and you can include as many as you need.

<figure><img src="/files/Ek2LoBnOFSYXWzAxQTda" alt="" width="280"><figcaption><p>The list of elements supported in the custom header</p></figcaption></figure>

***

### Menu

Adds a navigational menu to your header, allowing users to access different sections of your site.

<figure><img src="/files/WZIFMQhgFISry2P8gpsL" alt="" width="288"><figcaption></figcaption></figure>

**Menu**\
The navigation menu to show. To create and/or manage menus, go to Appearance -> Menus

**Submenu Arrow**\
Whether to show the arrow indicator for menu items with submenus.

**Mobile Menu Trigger**\
At the mobile menu breakpoint, the navigation hides and a toggle button appears to open the mobile menu.

**Trigger Position**\
Related to the above option (if enabled), this option sets the placement of the trigger button within the current column, allowing it to be positioned at either the beginning or the end.

**Menu Item Spacing**\
The spacing between top-level menu items.

***

### Menu Trigger

Creates a button or icon that toggles a menu type. The available options will depend on the selected menu type.​

<figure><img src="/files/dpJj42wz72F0RUPU5fDE" alt="" width="286"><figcaption></figcaption></figure>

{% tabs %}
{% tab title="Standard" %}
**Position**\
Will set the placement of navigation within the column.

**Animation**\
The toggle animation of root-level navigation links. It has fade, slide and scale animations available.

**Animation Direction**\
The staggering animation direction of root-level menu items.

**Submenu Arrow**\
Whether to show the arrow indicator for menu items with submenus.

**Menu Item Spacing**\
The spacing between top-level menu items.
{% endtab %}

{% tab title="Fullscreen" %}
**Content Align**\
The placement of the navigation menu determines its layout: the Left and Centered options display menu links as a vertical list, while the Horizontal option arranges menu items in a horizontal row.

**Search Field**\
Optionally, you can add a search bar as the last item in the menu, allowing users to search your site easily.
{% endtab %}

{% tab title="Off-Canvas Side" %}
**Widgets**\
Choose whether to display widgets within the menu container. The widgets displayed here are sourced from the **Off-Canvas Side** sidebar.

**Alignment**\
Adjust the alignment of the menu container, by default opens from right side.
{% endtab %}

{% tab title="Off-Canvas Top" %}
**Items per Row**\
Divides the navigation menu items into columns within each row.

**Widgets** \
Choose whether to display widgets within the menu container. The widgets displayed here are sourced from the **Off-Canvas Top** sidebar.

**Columns** \
Determines how many columns the widgets are divided into.

**Container** \
Defines the size of the widget container relative to the Menu Container.
{% endtab %}
{% endtabs %}

***

### Text

Allows you to insert custom text into your header for announcements, taglines, or other information. It supports shortcodes and HTML as well.

<figure><img src="/files/IikSsVG9ajxjr5Gbl8ej" alt="" width="285"><figcaption></figcaption></figure>

***

### Search Field

Provides a search bar that enables users to search your site directly from the header.

<figure><img src="/files/jzFgmxLEKVDEzP0dHD92" alt="" width="284"><figcaption></figcaption></figure>

**Search Field Alignment**\
The alignment of the input field in relation with the search button (:mag\_right: icon). Useful to avoid search input overflow the container.

**Search Field Visibility**\
By default, the search input is hidden. It will only become visible when users click on the search icon :mag\_right:. If you set the value to **Always**, the search input will remain visible at all times.​

**Icon Animation**\
Applicable when using **On click** search visibility, this setting will apply an animation effect when the search input is focused.

***

### Social Icons

Adds icons linking to your social media profiles, enabling users to connect with you on various platforms.

<figure><img src="/files/InGp9MSEZpvV1yMzLrOC" alt="" width="283"><figcaption></figcaption></figure>

{% tabs %}
{% tab title="Content" %}
**Icon**\
Controls whether the social network icon is displayed.

**Label**\
Determines whether to display the label alongside the social network icon.

**Spacing**\
The spacing between social network icons.

**Size**\
The size of the social media icon.

**Shape**\
Applies around the icon only. If set to different value than **None**, it will make the icon background rounded, square or any radius you specify.

**Shape Fill**\
If the shape option is applied, you can choose to display it with a solid background or as an outline border.​
{% endtab %}

{% tab title="Links" %}
**Open in New Tab**\
As the name suggests, this option will open the links in a new window or tab.

**Nofollow**\
If checked, prevents search engines from following the link.
{% endtab %}

{% tab title="Colors" %}
Brand colors of social icons are defined in **Appearance -> Customize -> General -> Social Icons**

**Color**\
The color of the icon or label. It can be Brand color, or any custom color you like.\
\
**Hover Color**\
The hover color of the icon or label.

**Label Color**\
If label is set to visible, it will inherit color from previous option, or set custom color for label only.

**Label Hover Color**\
The color to apply on hover for the label only. Inherits the color from Color option by default.

**Background**\
If the shape is applied, then the background color of the shape can be set here.

**Background Hover**\
The hover color of shape background.
{% endtab %}
{% endtabs %}

***

### Button

Inserts a customizable button into your header for calls to action or other important links.

<figure><img src="/files/HOin2TDlTzfdBjD0sNmM" alt="" width="284"><figcaption></figcaption></figure>

{% tabs %}
{% tab title="Content" %}
**Label**\
The text displayed on the button.

**Link**\
The URL the button directs to.​

**Open in New Tab**\
Whether the link opens in a new window or tab.​
{% endtab %}

{% tab title="Color & Fill" %}

<figure><img src="/files/Nu16usjsTuppO7gIXeJ4" alt="" width="281"><figcaption></figcaption></figure>

**Background**\
The button background colors for *Normal*, *Hover*, and *Active* states.

**Text**\
The button text colors for *Normal*, *Hover*, and *Active* states.

***

<figure><img src="/files/lqPIzO4WdJiGmbQs3gMK" alt="" width="276"><figcaption></figcaption></figure>

**Fill Type**\
Determines whether the button has an outline or a solid background
{% endtab %}

{% tab title="Layout" %}
**Padding**\
Controls the space inside the button between its content and border.

**Border Radius**\
Sets the roundness of the button’s corners.
{% endtab %}
{% endtabs %}

***

### Date and Time

Displays the current date and time in your header, which can be useful for event-related sites or general information.

<figure><img src="/files/OJqOrCPHricGfwyClwpw" alt="" width="282"><figcaption></figcaption></figure>

**Date or Time Format**\
Customize the format for displaying date or time. For more details, refer to the [WordPress date format documentation](https://wordpress.org/support/article/formatting-date-and-time/).

***

### My Account

Adds a section for user account management, allowing users to log in or access their account details.

{% hint style="info" %}
Note: The **WooCommerce** plugin is required for this element to function.
{% endhint %}

<figure><img src="/files/ckSgVeUA7a92fhxu7Ozb" alt="" width="285"><figcaption></figcaption></figure>

**Login Text**\
Text displayed for guests (users who are not logged in).

**Logged In Text**\
Text displayed for logged-in users.

**Show Icon**\
The account icon displayed to the left of the text.​

***

### Cart Totals

Shows the total amount of items and cost in the shopping cart, ideal for e-commerce sites.

{% hint style="info" %}
Note: The **WooCommerce** plugin is required for this element to function.
{% endhint %}

<figure><img src="/files/PUUPK3tmJWSpbdgqdfT0" alt="" width="284"><figcaption></figcaption></figure>

**Total Price**\
Define how the total price is calculated and displayed: cart totals, subtotals, or totals excluding taxes.

**Prefix Text**\
The text shown before the price numbers.

**Hide Empty Cart**\
Hides the element completely when the cart is empty.

***

### Cart

Displays a cart icon with a summary of items, enabling quick access to the shopping cart.

{% hint style="info" %}
Note: The **WooCommerce** plugin is required for this element to function.
{% endhint %}

<figure><img src="/files/28lB3BGxct6nLdbFNnIo" alt="" width="284"><figcaption></figcaption></figure>

**Icon**\
Choose to show the cart icon or hide it.

**Title**\
Optional text displayed next to the icon.

**Hide when Empty**\
Hides the element completely when the cart is empty.

**Counter Badge**\
Option to display the number of items in the cart.

**Click Action**\
Choose whether clicking the icon shows a mini cart popup or redirects to the cart page.

**Mini Cart - Show On**\
Select the mouse event (**Click** or **Hover**) to display the mini cart popup, applicable when the click action is set to **Show Mini Cart**.

**Mini Cart - Alignment**\
Set the position of the popup relative to the clicked icon.

***

### Language Switcher

Allows users to switch between different languages on your site, useful for multilingual websites.

{% hint style="info" %}
Note: The **WPML** plugin is required for this element to function.
{% endhint %}

<figure><img src="/files/iBfbJqHEZAhBQX0mjKcp" alt="" width="285"><figcaption></figcaption></figure>

**Show Flag**\
Choose to display the flag before or after the language name.

**Flag Position**\
Available when **Show Flag** is enabled, this option sets the flag’s placement relative to the language name.

**Show Label**\
The text that displays the language name in the switcher.

**Label Format**\
Choose how language names are displayed, including their native and translated forms

**Skip Missing Translations**\
Skip displaying languages in the list if no translations are available for the current page.

***

### Breadcrumb

Provides a breadcrumb trail that shows the user’s current location within the site hierarchy, improving navigation and user experience.

{% hint style="info" %}
Note: The **Breadcrumb NavXT** plugin is required for this element to function.
{% endhint %}

<figure><img src="/files/xSz4q1tCvNE5C7A4wZ5V" alt="" width="283"><figcaption></figcaption></figure>

***

### Common Options

**Visible On**\
Manage the visibility of each header element across different viewports, including Desktop, Tablet, and Mobile. This feature ensures that you can tailor the display of elements based on the user’s device, enhancing the overall user experience.

**Custom CSS**\
Apply additional styling to each element with Custom CSS. This option allows you to add your own custom styles, providing greater control over the appearance and design of header elements beyond the default options

**Style Options**\
All style options are applied from the Style tab in the Header section. The following section will guide you through styling each header element in detail.


# Styling

In this section, we explore how to style your header to match your site’s design. Header styling options allow you to customize various aspects of the header, including colors, spacing, and alignment of header elements.

To customize the look and feel of header go to **Appearance -> Customize -> Header -> Style (tab)**

***

### Header Container

The first set of options pertains to the header container style. Here, you can customize the header’s background, border, padding, and bottom spacing.

<figure><img src="/files/QJqceil3Yf7gLkRdpsPE" alt="" width="326"><figcaption><p>Header container style options</p></figcaption></figure>

**Background**\
Set the background color for the header container to define its overall appearance.

**Border**\
Customize the border around the header container, including its width, style, and color.

**Padding**\
Adjust the vertical padding inside the header container to control the space between the header’s edge and its content, affecting its internal layout.

**Margin Bottom**\
Modify the space below the header container to create distance between it and the content that follows, ensuring a clear separation on the page.

***

### Menu

The default style and spacing for root-level menu links.

<figure><img src="/files/ZZ0nCqPXWxUaELrNGAZw" alt="" width="323"><figcaption><p>Root level menu items style options</p></figcaption></figure>

**Links**\
The colors for the normal, hover, and active states of the menu items.

**Hamburger Menu**\
Colors for each state of the toggle, it will inherit colors from Links by default.

**Text**\
Any text that is not a link inside the menu will be colored with this option.

**Menu Item Spacing**\
The spacing between root-level menu items.

***

### Submenu

<figure><img src="/files/s2NxDI3W8G02yG0FsgSG" alt="" width="325"><figcaption><p>Submenu style options</p></figcaption></figure>

**Links**\
The colors for the normal, hover, and active states of the menu items.

**Background**, **Border**, **Padding**, **Radius** and **Shadow**\
The style settings for the submenu container.

***

### Pill Navigation

Provides an alternative styling option for header elements like menu items, buttons, and icons (e.g., Cart & Search) to achieve a pill-like appearance.

<figure><img src="/files/j1NHe4mYUKIb6cee0Pwn" alt="" width="326"><figcaption><p>Pill navigation style options</p></figcaption></figure>

**Pill Navigation**\
Enable this option to style root-level menu items as buttons.

**Background**\
Sets the background color for the pill-style elements.

**Color**\
Determines the text color for the pill-style elements in three states: ***normal***, ***hover***, and ***active***.

**Padding**\
Controls the space inside the pill-style elements, around the text.

**Border Radius**\
Defines the roundness of the corners for the pill-style elements.

***

### Fullscreen Menu

An overlay menu that covers the entire screen, providing a full-page navigation experience.

<div><figure><img src="/files/nX2EdHLuT5QFu2U4CpHF" alt="" width="332"><figcaption><p>Fullscreen menu style options</p></figcaption></figure> <figure><img src="/files/U47A78hYay31va5qvhrY" alt="" width="324"><figcaption><p>Fullscreen menu background style options</p></figcaption></figure></div>

**Custom Background**\
The background color and image options.

**Links**\
Colors for link states: **normal**, ***hover*** and ***active***.

**Text**\
The color set here will be applied to text elements within the fullscreen menu.

***

### Off-Canvas Side

The drawer like container with overlay.

<figure><img src="/files/2wS5fTnQlTw3zjy3E7oK" alt="" width="323"><figcaption><p>Off-Canvas Side style options</p></figcaption></figure>

**Overlay**\
The background that covers the entire screen behind the menu.

**Background**\
The background color of the menu container / drawer.

**Links** \
The color settings for the menu links in their different states: ***normal***, ***hover***, and **active**.

**Text** \
The color settings for other text elements within the menu container.

**Pill Background** \
The background color for pill-styled navigation items, applicable if pill navigation is enabled.

***

### Off-Canvas Top

A menu type that pulls down from the top of the screen.​

<figure><img src="/files/rizlnoMiUxHn1GDcLnvr" alt="" width="324"><figcaption><p>Off-Canvas Top style options</p></figcaption></figure>

**Background**\
The background color of the menu container.

**Links** \
The color settings for the menu links in their different states: ***normal***, ***hover***, and **active**.

**Text** \
The color settings for other text elements within the menu container.


# Top Bar

The Top Bar is an optional feature that can be activated via **Appearance** -> **Customize** -> **Header** by enabling the **Top Bar** option and then clicking on it to view the options.&#x20;

It provides an additional navigation area where you can place extra links, text, buttons or other elements as described here:

{% embed url="<https://docs.kaliumtheme.com/general/header/custom-header/elements>" %}
List of supported header elements
{% endembed %}

The structure of this navigation row is straightforward. It offers two rows, allowing you to distribute your content between the left and right sides or use a single row to center the content.

<figure><img src="/files/I04qXUEF29GLvwq8yO1G" alt="" width="315"><figcaption><p>Top Bar content area</p></figcaption></figure>

To add elements simply click :heavy\_plus\_sign: Add link in one of content containers and the list of elements will show up. Clicking the *three dots* icon on parent container will give you alignment options for the content inside that column.

After adding an element, the edit dialog will automatically appear, allowing you to adjust the options and attributes of that specific header element. Use the above link to refer to the documentation of each element.

You can customize the Top Bar with the following style options:

<figure><img src="/files/2YDsHPzQGowGnizKu3hC" alt="" width="326"><figcaption><p>Top Bar style options</p></figcaption></figure>

**Container**\
The colors for the background, bottom border and top bar items separator between elements.

**Links**\
The colors for the normal, hover, and active states of the menu items.

**Text**\
Any text that is not a link inside the menu will be colored with this option.


# Sticky Header

The Sticky Header feature allows the header to remain fixed at the top of the page while users scroll. This ensures that essential navigation elements and branding are always visible, providing consistent access to menu options and improving the overall browsing experience on longer pages.

To enable the *Sticky Header*, navigate to **Appearance -> Customize -> Header** and activate the **Sticky Header** option. Click on the option to access and adjust its settings.​

***

### General

Control how your sticky header behaves when scrolling, customize logo appearance, and set responsive options for different devices.

<div data-with-frame="true"><figure><img src="/files/KTvEZCXwKWX7bowLK5jv" alt="Sticky Beavior options" width="351"><figcaption><p>Sticky Behavior Options</p></figcaption></figure></div>

#### Sections

Choose which parts of the header become sticky when scrolling down the page.

**All Rows**\
Makes all header rows sticky when scrolling.

**Main Row**\
Only the main header row becomes sticky (default setting).

**Top Row**\
Only the top header row becomes sticky when scrolling.

***

#### Mode

Select the sticky header behavior mode.

**Standard**\
The header remains visible at all times when scrolling down the page.

**Auto Hide**\
The header only appears when users scroll up on the page.

***

#### Effect

Choose an animation effect for when the sticky header appears.

**Available Effects**\
Select from None, Slide, Fade, Slide and Fade, or Slide and Fade Up animations.

> **Note:** Selecting an effect will disable the Progress with Scroll behavior, since the header will automatically appear in its active state.

***

#### Progress with Scroll

This option links the sticky header animation to your scrolling progress.

When enabled, the sticky header will smoothly follow your scrolling. When disabled, it will use a standard animation that plays instantly. This option is only available when Effect is set to "None".

***

#### Animation Duration

Set the length of the animation in seconds when the sticky header appears or hides.&#x20;

**Duration Range**\
You can set values between 0 and 10 seconds. Default is 0.3 seconds.

{% hint style="info" %}
This option appears when Progress with Scroll is disabled or when an Effect other than "None" is selected.
{% endhint %}

***

#### Offset

Controls the distance from the top where sticky behavior begins.

**Input Options**\
You can enter a number in pixels (e.g., 50), or a CSS selector (e.g., .top-header-bar) to set the offset after another element.

***

<figure><img src="/files/79Yny6VelTMi0wH1BFaS" alt="" width="350"><figcaption><p>Logo Option on Sticky State</p></figcaption></figure>

#### Sticky Logo

Our sticky header implementation allows resizing the current logo when entering the sticky state, or completely switching the logo to another image.

**Shrink Logo**\
Adjust how much the logo shrinks when the header becomes sticky (0-100%). The shrinking percentage is relative to the assigned site logo width.

**Custom Logo**\
To display a different image for the sticky header, enable this option.

**Logo Image**\
When Custom Logo is enabled, select or upload your preferred sticky logo image.

***

<figure><img src="/files/uM89rC6aAnNlCLjJBinf" alt="" width="325"><figcaption></figcaption></figure>

#### Responsive

The sticky header also includes responsive options, allowing you to enable or disable it for specific devices.

**Enable On**\
Select which device types will display the sticky header: Desktop, Tablet, and Mobile. All three are enabled by default.

***

***

### Styling

You can apply custom styling for sticky header when it enters the sticky state. Here are the options and their usage:

<div><figure><img src="/files/9Bw1EQRMrjcgqaSRhcIM" alt="" width="325"><figcaption></figcaption></figure> <figure><img src="/files/uDxvFFxbN1tHBvzvACdT" alt="" width="320"><figcaption></figcaption></figure></div>

#### Container

The container supports standard style options like background, border, and shadow. Padding is applied only to the vertical axis.

#### Other Elements

Additional elements in the sticky header support styling on sticky state and they are:

**Links**\
The colors for the normal, hover, and active states of the menu items.

**Text**\
The color settings for other text elements within sticky header.

**Pill Background and Color**\
If pill navigation is enabled, you can apply custom pill background and text colors for each state of the navigation.


# Transparent Header

This option enables the header to blend seamlessly with the background of the page, making it appear as though it is floating over the content. This effect is achieved by setting the header's background to transparent, allowing the underlying page content or background image to be visible through the header.

To enable the *Transparent Header*, navigate to **Appearance → Customize → Header** and activate the **Transparent Header** option. Click on the option to access and adjust its settings.

***

#### Spacing

Control the top spacing of the page content to prevent it from being hidden behind the transparent header.

<figure><img src="/files/vYC8klxl9ozRHttdK6IY" alt="" width="349"><figcaption><p>Content Spacing Placeholder</p></figcaption></figure>

This responsive option allows you to set different spacing values for desktop, tablet, and mobile devices. The spacing creates padding at the top of the page wrapper to accommodate the header height.

***

#### Custom Logo

Use a different logo specifically for the transparent header state.

<figure><img src="/files/QnLQ0sAj2BbnQ4bqoQ1q" alt="" width="349"><figcaption><p>Custom Logo</p></figcaption></figure>

**Custom Logo**\
Enable this option to display a different logo image when the transparent header is active. This is useful when you need a logo with better contrast against varying background colors or images.

**Logo Image**\
When Custom Logo is enabled, select or upload your preferred transparent header logo image.

**Logo Width**\
Set a custom width for the transparent header logo. This responsive option allows you to define different widths for desktop, tablet, and mobile devices.

***

#### Display Conditions

Control where and when the transparent header appears on your website.

<figure><img src="/files/cXsGPNnEAW7oixllvLwO" alt="" width="349"><figcaption><p>Display Conditions</p></figcaption></figure>

Set up rules to determine on which pages the transparent header will be displayed. You can create multiple conditions using various criteria such as page types, specific pages, post categories, and more.

{% hint style="info" %}
**Important:** You must set at least one display condition to enable the transparent header. Without any conditions defined, the transparent header will not be activated.
{% endhint %}

***

#### Styling

You can apply custom styling for the transparent header to ensure optimal visibility and aesthetics against your page backgrounds. Here are the options and their usage:

<figure><img src="/files/Vmqg0kLvxJ3SI4fmfYew" alt="" width="350"><figcaption><p>Style Options</p></figcaption></figure>

**Menu**

**Links**\
Set the colors for the normal, hover, and active states of the main menu items.

**Hamburger Menu**\
Configure the colors for the normal, hover, and active states of the hamburger menu icon (mobile menu trigger).

**Text**\
Set the color for other text elements within the transparent header.

**Pill Navigation**

If pill navigation is enabled in your header settings, you can customize the appearance of pills for the transparent header state.

**Background**\
Apply custom pill background colors for normal, hover, and active states.

**Color**\
Set custom pill text colors for normal, hover, and active states.

**Submenu**

**Background**\
Set the background color for dropdown submenus when the transparent header is active.

**Pill Background**\
If pill navigation is enabled, configure the pill background colors for submenu items in normal, hover, and active states.

**Links**\
Set the colors for submenu links in normal, hover, and active states.

**Border**\
Configure the border style, width, and color for dropdown submenus.


# Mobile Menu

The Mobile Menu provides a streamlined navigation experience for smaller screens. It features a collapsible, touch-friendly interface with a hamburger icon that toggles the menu at the defined mobile menu breakpoint.

You can edit the Mobile Menu by going to **Appearance -> Customize -> Header -> Mobile Menu**.​

The menu content is divided into two sections: *Main Content* and *Footer Content*. This structure allows you to add items to the end of the mobile menu container, making them easily accessible while on mobile devices.

Like other header sections, the mobile menu uses a drag-and-drop interface to organize and structure the menu elements.

The mobile menu offers a slightly smaller selection of elements, as not all elements available in other header sections are supported in the mobile menu.​

<figure><img src="/files/GnAv1iQ9Fv2QIJnU9Rgh" alt="" width="268"><figcaption><p>Mobile menu elements</p></figcaption></figure>

To add elements simply click :heavy\_plus\_sign: **Add** link in one of content containers and the list of elements will show up.

### Menu Options

You can adjust the behavior and style of the mobile menu by accessing the options in the Mobile Menu section. Scroll down to the **Menu Options** section to make your changes.:

<figure><img src="/files/3ZuWp2TOuHt4gbIDDi5s" alt="" width="325"><figcaption><p>Menu Options</p></figcaption></figure>

**Type**\
The **Slide Menu** provides a standard mobile menu animation, while the **Full Screen** option offers an alternative way to display the menu across the entire screen.

**Slide Direction**\
This option applies only to the **Slide Menu** type and allows you to set the direction from which the menu will slide into view on the screen.

**Close Button**\
Alternatively, you can add a close button (:x: shaped) to the screen to hide the mobile menu.​

**Breakpoint**\
The breakpoint at which all menu types become hidden and the mobile toggle button appears, ensuring that only the mobile menu is visible at that viewport and smaller sizes.

### Style Options

Like other header parts, the mobile menu also supports custom styling, offering extensive options for configuring its appearance and design.

<div><figure><img src="/files/gn9HuVltTA38dtGD8g6U" alt="" width="324"><figcaption><p>Overlay and content container style</p></figcaption></figure> <figure><img src="/files/ZDQRWCjwMm1EskP31hqj" alt="" width="324"><figcaption><p>Slide Menu type style options</p></figcaption></figure></div>

**Overlay**\
The overlay color that covers the screen when the mobile menu is active.

**Content Background**\
Applicable only to the Slide Menu type, this option sets the background color of the menu content container.

**Links**\
The colors for the *normal*, *hover*, and *active* states of the menu items.

**Text** \
Any text that is not a link inside the menu will be colored with this option.

#### Slide Menu Type Options

**Content Max Width**\
The maximum width of the menu container on the screen, ideally set between 50% and 80% of the window width.​

**Item Spacing**\
The spacing between header elements and root-level menu items.​

**Padding**\
Padding applied within the menu container.​


# Other Options

In addition to the previous configuration options for the header, the following extra settings offer additional customization and functionality that complement the main features:

### Full Width Header

This option allows the header to stretch across the entire width of the viewport, providing a seamless and uninterrupted appearance from edge to edge of the screen.

### Submenu Arrow

This option controls the visibility of the arrow indicator next to menu items that have submenus. The arrow helps users identify expandable menu items and indicates that additional options are available when clicked or hovered over.​

### Hamburger Icon Label

This option allows you to set a label or text that appears next to the hamburger menu icon. It provides additional context or instructions for users, making it clear that the icon will open the mobile navigation menu.

<figure><img src="/files/OUnIZhwJo0PsgKRGiA5j" alt="" width="322"><figcaption></figcaption></figure>

**Display Text**\
Text displayed next to the hamburger menu icon, indicating that clicking it will open the menu.​

**Close Text**\
Text displayed next to the hamburger menu icon when the menu is open, indicating that clicking it will close the menu.

**Icon**\
Toggle to show or hide the hamburger menu icon.

**Icon Alignment**\
Sets the position of the hamburger menu icon within the header, allowing alignment options such as left or right.<br>


# In Page Options

The **In Page Options** for headers allow you to customize the appearance and functionality of headers on individual pages, posts, or custom post types like Products and Portfolios.&#x20;

This means you can tailor the header settings for each specific page or post, rather than applying a global header style across your entire site. This feature provides flexibility to adjust the header layout, visibility, and other settings to match the unique needs of each content type.

The options you set for specific page[^1], will always take precedence over those configured in the Customizer.

By using these options, you can create a more personalized and cohesive look for different sections of your site, enhancing the overall user experience.&#x20;

To edit header options, in the post editor page, go to **Parameters and Options** -> **Page Options** then the header settings are split in two tabs: **Header Options** and **Logo & Menu** as shown below:

<figure><img src="/files/xeo7SApPIXPOyg99TDqa" alt=""><figcaption><p>In Page header options</p></figcaption></figure>

### Header Options

In this tab, you can customize the header container and apply your preferred styling options.​

#### Header Position

Set the header position in relation with the page content, for example if you have a slider and want to show the header container over the slider/image then choose **Over the Content** (Absolute) otherwise the default option **Content Below (Static)** is applied.&#x20;

This behavior can be adjusted in global site level by going to **Appearance -> Customize -> Header** and toggling **Transparent Header** option:

<figure><img src="/files/b3IdQXbvd0S9LwmMTERe" alt="" width="327"><figcaption></figcaption></figure>

When you select the **Over the Content** option, the **Header Spacing** setting will become available. This option allows you to adjust the spacing for the content that now extends from the very top of the page. This ensures that the content does not overlap with the header and maintains a clean and organized layout.

#### Full Width Header

As the name suggests, this option sets the header to span the full width of the page.

#### Header Styling

Enabling this option allows you to override the header style. Once you select **Yes**, all available [header style options](/general/header/styling) as defined in the Customizer will become available.

<div><figure><img src="/files/mQramvHaBKHuIULGe8Td" alt="" width="375"><figcaption></figcaption></figure> <figure><img src="/files/qnTBhj8zPzbZPKdMXzKC" alt="" width="375"><figcaption></figcaption></figure> <figure><img src="/files/TyrvIFNrxtoL8gyD1l58" alt="" width="375"><figcaption></figcaption></figure></div>

### Logo & Menu

This tab allows you to change the logo and adjust menu options, including the ability to enable or disable the sticky header.

<figure><img src="/files/3XIf9A9ijK1dybPGyFvJ" alt=""><figcaption><p>Logo and Sticky Header settings</p></figcaption></figure>

#### Custom Logo

This option lets you set a unique logo for this specific page, overriding the default logo used throughout the site. It’s ideal for giving this page a distinct look while keeping the rest of your site consistent.

#### Custom Logo Width

An optional setting to adjust the width of the custom logo on this page. Leaving it empty will retain the logo’s original dimensions.

#### Sticky Header

Enable or disable the sticky header for this specific page. If Enabled, it will display [style options](/general/header/sticky-header#styling) for sticky header as defined in Customizer.

#### Custom Sticky Logo

Set a different logo to display when the header is in the sticky state.

#### Sticky Header Style

Visible when **Sticky Header** is set to **Enable**. These style options will override the sticky header settings configured in the Customizer.

<div><figure><img src="/files/cUC7FmdVSmqG9fwXZxHn" alt="" width="375"><figcaption></figcaption></figure> <figure><img src="/files/Aejwdtejc8ynx6nmqsL9" alt="" width="375"><figcaption></figcaption></figure></div>

#### Logo Switch

This option allows you to change the logo as the header becomes sticky while scrolling down the page. When enabled, you can add multiple logo switch sections by clicking **Add Logo Switch Section** to specify different logos for various scroll positions:

<figure><img src="/files/AtPHz8g7lJiznBtatyYT" alt=""><figcaption><p>Logo Switch on Section settings</p></figcaption></figure>

**Switch Type**\
Choose between using a specific section (container) or a Revolution Slider item to trigger the change of the sticky header logo. If you select the Revolution Slider option, a list of sliders will be available. The sticky header logo will update when the slider reaches the top of the viewport.

**Section ID**\
When the switch type is set to **Section**, you need to assign an ID to the parent container of the section that triggers the logo change. This allows the sticky header script to recognize the section and update the logo when it fully enters the viewport.

**Logo**\
Set the logo to be used specifically for this section.

**Logo Width**\
Specifies the width for the logo. By default, the logo will use its original dimensions unless you set a custom width.​

**Transparent**\
Enabling this option will remove the background of the header, making it transparent.

[^1]: or any singular item such as: post, product, portfolio, etc.


# Footer

The Kalium footer is highly flexible and user-friendly, utilizing widget areas for easy customization. With the Block Editor, you can effortlessly add and arrange text, images, menus, and other elements, making it simple to create a footer that fits your design and functional needs.

To edit footer options and its structure go to **Appearance -> Customize -> Footer**

<figure><img src="/files/8YZvofelun6pI0H3lcW2" alt=""><figcaption></figcaption></figure>

In the **Footer** customizer section, you will find the following settings to design your footer:

<div align="center"><figure><img src="/files/JPUWWwzWMJXt0J5JQYQi" alt="" width="317"><figcaption><p>Footer Options</p></figcaption></figure> <figure><img src="/files/cRJmf5sVAE2uLyq3GahJ" alt="" width="314"><figcaption><p>Footer Builder with drag and drop interface</p></figcaption></figure></div>

### Footer Options

Footer options offer straightforward functionalities, such as the ability to completely disable the footer if you use a separate plugin to build it.​

#### Type

The footer type determines its positioning on the page. Setting it to **Normal** will keep it within the document flow, aligning it below the main content. Selecting **Fixed** will position the footer behind the main content wrapper, adding extra scrolling space and allowing for a smooth revealing animation such as *Fade* or *Slide*.

#### In Page Footer Options

To edit footer settings for individual pages or other post types, go to the edit screen of the specific post or page, then scroll to **Parameters and Options -> Page Options -> Footer Options**

<figure><img src="/files/xAUZVuDxWAkQaSFajGZj" alt=""><figcaption><p>In Page Footer options</p></figcaption></figure>

#### Footer Visibility

Overrides the global setting to enable or disable the footer on the current page.​

#### Fixed Footer

Apply a different footer type specifically for the current page.

### Footer Layout

Creating your desired footer layout is straightforward. Click **Add Footer Row** to choose from a range of pre-defined footer row structures as shown below:

<figure><img src="/files/KmLFzn9nD7KLfQ7YSGBe" alt="" width="281"><figcaption><p>Available footer row structures</p></figcaption></figure>

You can add as many rows as needed to customize your footer layout.

### Footer Elements

Similar to the header, the footer also utilizes a drag-and-drop builder for arranging elements. Below is the list of elements that footer supports:

#### Row

A row is a flexible container that can include multiple columns. It offers various Flexbox[^1] options to control the arrangement of both the container and its columns.​ You can also set the row width to full width.

It supports custom backgrounds, link and text colors, and common CSS properties like padding, margin, borders, as well as custom CSS classes.

The row element also offers responsive visibility options, allowing you to control when and how it appears based on different device screen sizes.

#### Column

The column element allows you to divide a row into multiple sections, each with customizable width and alignment. It also supports Flexbox and other CSS properties. Additionally, you can assign custom CSS classes for further styling.

The column element also includes responsive visibility options, similar to the row element.​

#### Widget Area

After inserting the row and columns, they will automatically include Widget Area elements, which pulls content from the defined sidebar widgets. Currently, there are **6 available widget areas**, which are sufficient for creating a versatile footer structure:

<figure><img src="/files/Ov8pJYvGBPLxXpUvqqs9" alt="" width="278"><figcaption></figcaption></figure>

Each widget area stacks content vertically by default. To arrange the content in columns, adjust the **Widgets per Row** option by clicking the three dots in the **Widget Area** element options:

<figure><img src="/files/AJXgzYfMQFMhipmR0UJx" alt="" width="267"><figcaption><p>Set the number of columns (optional)</p></figcaption></figure>

You can hide elements temporarily by toggling the :eye: eye icon next to each one.

In the following section, you’ll learn how to create the content for footer widgets.

[^1]: Flexbox is a CSS layout model that simplifies arranging items within a container with flexible and responsive alignment.


# Adding/Editing Content

The footer content can be edited in two places:

1. **Appearance -> Widgets**
2. **Appearance -> Customize -> Widgets**

If you need guidance on adding widgets, [this article](/general/sidebars/troubleshooting-sidebar#adding-widgets-to-your-sidebar) provides a detailed explanation.

Once you’ve defined the footer structure and assigned widget areas, you can easily make edits directly in **Widgets** page without needing to go to the **Customizer** to save changes.

### Footer Widget Areas

Widgets locations that you can use in the footer are **Footer Widget Area 1** to **Footer Widget Area 6**:

<figure><img src="/files/kn9Srvl0KVYnBfy9EOYn" alt=""><figcaption><p>Footer Widget Areas that can be used in the footer</p></figcaption></figure>

The content formatting and everything Block Editor offers can be constructed here.&#x20;

With this approach, you can add any type of element to the footer, including images, maps, contact forms, and other content supported by the *Block Editor* and the plugins that extend it.

{% hint style="info" %}
When editing multiple widget locations, make sure to click the **Update** button after each widget location edit. WordPress only saves changes for the current widget area, so if you edit multiple areas without saving, your work may be lost.
{% endhint %}

### Multi-Column Widget Area

The widget content flows vertically by default, but you can still organize it into columns for a more structured layout.

You can add as many groups as needed in the widget area, and in the Customizer’s **Footer** section, you can configure these widgets to split into columns.&#x20;

This setup supports varying column numbers on different responsive viewports.​

<figure><img src="/files/Kw19aoEOsiAIo9g5Nn2R" alt=""><figcaption><p>Footer Widget Area 3 example</p></figcaption></figure>

Then in the **Appearance -> Customize -> Footer** section, set the number of **Widgets per Row** for **Footer Widget Area 3**:

<figure><img src="/files/MAUN3K2Krd3Wv0HHSHP2" alt=""><figcaption><p>Splited widget columns</p></figcaption></figure>

Do not confuse the ***Column*** element with *widget columns*, as it is mainly used for structuring the footer layout.


# Styling

### Full Width Row

Adjusting the width of a footer row is straightforward.&#x20;

Simply click the three dots on the row you want to modify, go to the **Container** section, and toggle the **Full Width** option:

<figure><img src="/files/joH2ddfG70nLr91zhlI6" alt=""><figcaption></figcaption></figure>

### Changing Row Style

You can apply styles like background, and custom link and text colors directly to the **Row** element.&#x20;

To apply your style for the row, click the *vertical three dots* on the **Row** element, then go to the **Style** tab. Here, you can set colors for *text*, *headings* and *links*, and choose a *background* for the row, including the option to add an image.:

<div><figure><img src="/files/R9lxxtuLWoueC3ZqjoiE" alt="" width="271"><figcaption><p>Row Background</p></figcaption></figure> <figure><img src="/files/gOqtoj0UUAdM4zQIAPPh" alt="" width="272"><figcaption><p>Row Elements Colors</p></figcaption></figure></div>

This will result in the row appearing as shown in the example below:

<figure><img src="/files/jxzlpR2guQMW6Uz4Efq8" alt=""><figcaption></figcaption></figure>

### Columns

When you want to balance columns or set custom widths, you can adjust these settings for each column individually.​

<figure><img src="/files/jUleEZgMa1Ob4GOC4Ozv" alt=""><figcaption><p>Two columns of the same width</p></figcaption></figure>

Now, we will set the width for **Column 1** to span 3 columns out of the 12-column grid by clicking the vertical three dots button, then in **Content** section setting the **Width** value:

<figure><img src="/files/IEObhpqLUckV2iXe7Vdq" alt="" width="281"><figcaption></figcaption></figure>

For the other column, set the width to **Auto**, which will fill the remaining space. Additionally, for responsive viewports, you can adjust these rows to display one column per row or according to your preference. The result will be:

<figure><img src="/files/3L6OUjbvgISNUVbCrMfu" alt=""><figcaption><p>Balanced columns</p></figcaption></figure>

### Spacings

You can adjust the spacing of elements for each row, as the **Row** provides settings for both *vertical* and *horizontal* spacing.

Click the vertical three dots on **Row** element and go to **Content** section, scroll to *Horizontal* and *Vertical* Gap:

<figure><img src="/files/PrSXQT1QPFB2y9a07lvm" alt=""><figcaption><p>Adjusting the elements spacing in a row</p></figcaption></figure>


# Sidebars

{% embed url="<https://www.youtube.com/watch?v=rXa6J4VpmA0>" %}

Kalium offers extensive options to customize the sidebars on your website, allowing you to create the perfect layout for your content. The sidebar settings can be accessed by navigating to **Appearance -> Customizer -> Sidebars** in your WordPress dashboard. Below is a detailed guide to the different customization options available for sidebars in Kalium.

### Sidebar Types

Kalium provides two distinct types of sidebars, each offering different design capabilities:

<figure><img src="/files/kkUPpN6xYy5HoiWU6tTT" alt="" width="321"><figcaption></figcaption></figure>

* **Type 1:** This is a traditional sidebar without any background or border. It's ideal for a clean, minimalist look.
* **Type 2:** This type allows you to add more design elements, such as a background, border, border radius, and shadow, giving you greater control over the appearance of your sidebar.

### Sidebar Options

<figure><img src="/files/MmHSQ8iLUDqMfTiJqAzG" alt="" width="334"><figcaption></figcaption></figure>

#### Sidebar Width

You can set the width of the sidebar as a percentage of the overall page width. This allows you to control how much space the sidebar occupies relative to the main content area.

#### Sidebar Gap

This setting controls the gap between the sidebar and the main content. Adjusting this can help to create a more balanced layout.

#### Inner Spacing *(Type 2)*

Allows you to define the inner spacing (padding) within the sidebar or widget if they are separated. It’s useful for ensuring that your sidebar content has enough breathing room.

#### Widget Vertical Spacing

This option sets the gap between individual widgets within the sidebar. It helps maintain consistent spacing and a clean look.

#### Separate Widgets *(Type 2)*

Allows you to separate each widget within the sidebar, giving them a distinct appearance.

#### Mobile Position

This setting lets you choose whether the sidebar should appear at the top or bottom of the page when viewed on mobile devices.

### Sticky Sidebar

Kalium offers a sticky sidebar feature that keeps the sidebar visible as the user scrolls down the page. You can toggle this feature on or off and customize it with the following options:

<figure><img src="/files/hrNhYzKjKim5iXow7I55" alt="" width="329"><figcaption></figcaption></figure>

* **Sticky Behaviour:**&#x20;
  * Entire Sidebar: The entire sidebar remains sticky.
  * Widget&#x73;**:** Set the number of the bottom widgets that you want to remain sticky.
* **Offset from Top:** This setting controls the distance from the top of the page when the sidebar becomes sticky.

### Responsive Visibility

You can control whether the sidebar is visible on different devices by toggling the respective options:

* Desktop
* Tablet
* Mobile

<figure><img src="/files/WcCfOk4AvEL1mBc2YtI5" alt="" width="330"><figcaption></figcaption></figure>

***

### Style

The Style tab provides a range of customization options that allow you to style the sidebar's text and container to match your website's design.

#### Text

* **Title and Text Color:** Customize the color of the sidebar titles and text.
* **Links Color and Hover Color:** Set the color for links and the color that appears when hovering over them.

<figure><img src="/files/yXYwOB8qhEkQB27WxDOO" alt="" width="331"><figcaption></figcaption></figure>

#### Container *(Type 2)*

* **Background Color:** Choose a background color for your sidebar container.
* **Border Width, Type, and Color:** Define the border's width, style, and color for the sidebar or widgets if separated option is on.
* **Shadow:** Add a shadow effect to the sidebar for a more dynamic look.
* **Border Radius:** Customize the corner rounding (radius) of the sidebar’s border.

<figure><img src="/files/RSkmNqVLBDLkuObMYFSP" alt="" width="323"><figcaption></figcaption></figure>


# Troubleshooting Sidebar

### Why Isn’t My Sidebar Showing?

If your sidebar isn’t appearing, keep in mind that the Sidebars section in **Appearance -> Customize -> Sidebars** only controls the global styling of sidebars. To display a sidebar on a specific page, you need to enable it in the settings for that page.

For example if you want to show it in the blog archive page, you will have it to enable for the blog only.

1. Navigate to **Appearance -> Customize**&#x20;
2. For example, to display a sidebar on your blog page, go to **Appearance -> Customize -> Blog -> Blog Page**.
3. Under **Page Elements,** make sure that the sidebar toggle is set to "**On**" for the relevant page.

Once the sidebar is enabled for the page where you want to show using the instructions above, you can adjust its alignment directly from the page settings, set it to the left or right based on your preference.

<figure><img src="/files/ZEE2XbOexonsfgIH6UtG" alt="" width="343"><figcaption></figcaption></figure>

***

### Adding Widgets to Your Sidebar

You can add widgets to your sidebars using two methods: via the Customizer or the Widgets screen. The result is the same, but the method you choose depends on your preference and workflow. The Customizer offers a live preview of changes as you make them, while the Widgets screen provides a traditional interface for drag-and-drop widget management. Both methods allow you to effectively add and configure widgets for your sidebars.

#### Method 1: Using the Customizer

1. Go to **Appearance -> Customize** in your WordPress dashboard.
2. In the Customizer menu, find and click on the **Widgets** section.
3. Choose the sidebar area where you want to add widgets.
4. Click the **+** button. You will see a list of available widgets. Click on the widget you want to add, configure its settings if needed, and click **Publish** to save your changes.

<figure><img src="/files/MJipD80o4brPG9hSn0aB" alt=""><figcaption></figcaption></figure>

#### Method 2: Using the Widgets Screen

1. Navigate to **Appearance -> Widgets** in your WordPress admin area.
2. On the Widgets page, you will see a list of available sidebars or widget areas. Expand on the sidebar area where you want to add widgets.
3. Click the big **+** button to add widgets from the list. Configure the widget settings as required and click **Save** to apply the changes.

<figure><img src="/files/dQna0gbpYeQHHv7Dt0Kw" alt=""><figcaption></figcaption></figure>


# Blog

Creating a blog is a fantastic way to connect with your audience, share your thoughts, and build a community around your passions. Whether you're starting a personal diary, a professional blog, or a niche site dedicated to a specific topic, WordPress provides the tools to set up and customize your blog page to fit your needs.

### Creating a Blog Page and Blog Post

{% content-ref url="/pages/V0d9snzasM4nh5ooclvD" %}
[Creating a Blog Page](/post-types/blog/creating-a-blog-page)
{% endcontent-ref %}

{% content-ref url="/pages/COLOa7A0EsLFFnmU7uGs" %}
[Creating a Blog Post](/post-types/blog/creating-a-blog-post)
{% endcontent-ref %}

### Customizing the Blog Page and Blog Post

{% content-ref url="/pages/3PRWgT2oUDjNPKY3rsov" %}
[Blog Page](/post-types/blog/blog-page)
{% endcontent-ref %}

{% content-ref url="/pages/Qh7pyr5FYz1POaFwEJ5k" %}
[Post Page](/post-types/blog/post-page)
{% endcontent-ref %}


# Blog Page

The Blog Page settings in the Customizer allow you to change the appearance and layout of your blog posts. To access these settings, navigate to **Appearance -> Customize -> Blog -> Blog Page**.&#x20;

<figure><img src="/files/aCaRoNoKgq9fQxgrgjnd" alt=""><figcaption></figcaption></figure>

## Layout

You can choose how your blog posts are arranged on the page:

<figure><img src="/files/Ib4izKgV7Asa3UT8LhIg" alt="" width="335"><figcaption></figcaption></figure>

#### List Options

The **List Layout** presents posts in a single column, making it ideal for a clean and straightforward blog appearance. In this layout, you can adjust the following settings:

<figure><img src="/files/8OiBpc5xx8eAbFKmU8ny" alt="" width="326"><figcaption></figcaption></figure>

* **Gap**: Controls the vertical space between each post. The gap can be set from 0px (no space) to 100px (a larger space).

#### Grid Options

The **Grid Layout** displays posts in multiple columns, providing a more dynamic and visually engaging presentation. This layout includes several customization options:

<figure><img src="/files/Kx3gNKxA9wwxahdsmzps" alt="" width="340"><figcaption></figcaption></figure>

* **Columns**: Determines the number of columns in which your posts will be arranged. Options range from 1 to 4 columns.
* **Gap**: Sets the spacing between the posts in the grid. This gap can range from 0px to 100px.
* **Masonry Mode**: Enables a staggered, masonry-style grid layout where posts of varying heights are arranged to fill gaps.

***

## Card Options

Customize the appearance of each post card using the following settings:

* [**Featured Image**](#featured-image): Toggle to show or hide the featured image on the post card. When turned on, additional settings for hover effects, image placeholders, and image size become available.
* **Title**: Toggle to show or hide the post title on the post card.&#x20;
* [**Excerpt**](#excerpt): Toggle to show or hide the post excerpt (description) on the post card. When enabled, you can configure the excerpt length.
* [**Post Meta**](#post-meta): Toggle to show or hide post metadata (date, categories) on the post card. When turned on, further customization options will show.

### Featured Image

The Featured Image settings allow you to control how the featured image on each post card appears. This option includes several additional settings:

<figure><img src="/files/xQcxvJNuOYuJ0n9Ijqg2" alt="" width="336"><figcaption></figcaption></figure>

* **Hover Effect**: Manage the visual effects that appear when hovering over the featured image.
* **Image Placeholder**: Define the appearance of a placeholder shown while the featured image is loading.

When any of them is enabled, additional settings for these options will be available under the **Style** tab.

#### Hover Effect

These settings control what happens when a user hovers over the featured image. These options include:

<figure><img src="/files/KA0I13KamVcpueXcg9LY" alt="" width="338"><figcaption></figcaption></figure>

* **Background**: Choose a color for the hover effect background that appears when a user hovers over the image.
* **Offset**: Adjust how far the hover effect extends from the edges of the image, affecting the visual impact on hover.
* **Icon**: Select an icon to display on hover:
  * **None**: No icon will be shown.
  * **Eye Icon**: Choose between a static or animated eye icon.
  * **Custom Icon**: Upload and use a custom icon of your choice.

#### Image Placeholder

Manage the visual element that appears while the featured image is loading. This helps ensure that there is always a visual component in place:

<figure><img src="/files/1vBn6Cfa6ugkdF1OPNxk" alt="" width="337"><figcaption></figcaption></figure>

* **Color**: Set a color for the placeholder that appears while the image is loading.
* **Image**: Choose an image to use as a placeholder during the loading process.&#x20;

#### Image Size

Control the dimensions of the featured image:

<figure><img src="/files/f00D7a8v9Ut9kfNHeEFg" alt="" width="337"><figcaption></figcaption></figure>

* **Image Size**: Select from predefined sizes or define a custom size for the featured image.
* **Aspect Ratio**: Choose from predefined aspect ratios or set a custom ratio, with options for responsive adjustments.

#### Style

The Style tab includes settings that affect the overall appearance of the featured image in card:

<figure><img src="/files/Ko996nLu0VObh33R986T" alt="" width="341"><figcaption></figcaption></figure>

* **Width**: Set the width of the featured image. This option is available for the **List** layout only.
* **Gap**: Adjust the space between the featured image and the content below.
* **Border Radius**: Set how rounded the corners of the featured image should be.
* **Boundless Image**: Toggle to extend the image to the edges of the card, ignoring padding, border, or background settings.
* **Vertical Alignment**: Set the vertical alignment of the featured image within the card to Top or Bottom. This option is available for the **List** layout only.

### Excerpt

The Excerpt setting determines whether post excerpts are displayed on the post cards. When turned on, you can configure the following option:

<figure><img src="/files/nxTEhiSQGfBlUJfbJbrE" alt="" width="338"><figcaption></figcaption></figure>

* **Max Words**: Specify the maximum number of words to display in the excerpt. This controls the length of the excerpt shown on each post card.

### Post Meta

The **Post Meta** option lets you control the visibility of additional post information on the post card. When this setting is turned on, you can customize the following options:

<figure><img src="/files/C50rejuux2IoO6WeUWBE" alt="" width="340"><figcaption></figcaption></figure>

* **Date**: Toggle to show or hide the post date.
* **Category**: Toggle to show or hide the post category.
* **Display Icon**: Toggle to show or hide an icon next to the metadata.&#x20;

***

## Page Elements

The **Page Elements** section allows you to customize additional components of your Blog Page. Here are the available options:

<figure><img src="/files/quQrY0MCqpzuRqQSMUsC" alt="" width="339"><figcaption></figcaption></figure>

* [**Title & Description**](#title-and-description): Toggle this option to show or hide the title and description.
* [**Sidebar**](#sidebar): Use this toggle to include or exclude the sidebar from your Blog Page.&#x20;
* [**Pagination**](#pagination): Configure how posts are divided across multiple pages. This section includes several pagination options and settings that will be explained further below.

***

### Title & Description

This setting allows you to control the visibility and content of the title and description displayed on your Blog Page.

<figure><img src="/files/2Rv2LVswL1XEuczdEKKs" alt="" width="339"><figcaption></figcaption></figure>

* **Blog Title**: Enter a title for your Blog Page in the input field. This title will appear at the top of the page and helps to identify and label the blog section of your site.
* **Blog Description**: Use the textarea to provide a description for your Blog Page. This description can offer a brief overview or introduction to the content of your blog and will be displayed below the blog title.

Before you can use these options, you need to toggle the setting to "on" to enable the display of the title and description.

***

### Sidebar

Customize the appearance and placement of the sidebar on your Blog Page with these settings:

<figure><img src="/files/gHXEKTg9OCDcTn3IqzD4" alt="" width="340"><figcaption></figcaption></figure>

#### Sidebar Align

Choose the alignment of the sidebar:

* **Left**: Position the sidebar on the left side of the Blog Page.
* **Right**: Position the sidebar on the right side of the Blog Page.

#### Sidebar Widgets

Click the provided link to access the widget management area. Here, you can add and configure widgets to populate the sidebar with content such as recent posts, categories, or custom text.

{% hint style="info" %}
For additional styling and customization of the sidebar, you can adjust the global sidebar settings located under **Appearance -> Customize -> Sidebars**. This area allows you to manage the overall look and feel of sidebars across your site, check the [sidebar styling article](/general/sidebars).
{% endhint %}

***

### Pagination

Configure how posts are divided across multiple pages to manage navigation. You can choose between two types of pagination:

* [**Numbers**](#numbers)
* [**Load More**](#load-more)

#### Numbers

Display numbered pagination for navigation.

<figure><img src="/files/4DwLtH0QvYnvMvKVIFFG" alt="" width="333"><figcaption></figcaption></figure>

#### Display Type

* **Numbers**: Show only page numbers.
* **Numbers + Previous/Next**: Display page numbers along with Previous and Next buttons for easier navigation.
* **Previous/Next**: Show only Previous and Next buttons.

***

#### Load More

Use a button to load more posts as users scroll down the page.

<figure><img src="/files/t9L2k1Ixsklmhnmp9cYR" alt="" width="335"><figcaption></figcaption></figure>

* **Infinite Scroll**: Toggle this to enable or disable infinite scrolling, where more posts load automatically as users scroll down the page.
* **Loading Effect**: Choose a loading effect to display while new posts are being fetched:
  * **Spinner**: A spinning icon indicating loading.
  * **Pulsate**: A pulsating effect indicating loading.

***

#### Alignment

Set the alignment of pagination controls for both types:

<figure><img src="/files/2VMeWnvaK3TQkLRkKdSr" alt="" width="332"><figcaption></figcaption></figure>

* **Left**: Align pagination controls to the left.
* **Center**: Center-align pagination controls.
* **Right**: Align pagination controls to the right.
* **Space Between**:  Distribute space between items (Available only for Numbers type)

## Style Tab

The **Style** tab provides options to customize the appearance of post card on the blog page. These settings allow you to adjust the overall look and feel of the cards.

<figure><img src="/files/uRrYYBpkLN2xDrjrMQiO" alt="" width="345"><figcaption></figcaption></figure>

#### Card Style

* **Background**: Choose a background color for the post card. When a background color is set, padding will automatically be applied to the card to ensure proper spacing and alignment.
* **Title**: Select a color for the post title on the card.&#x20;
* **Text**: Choose a color for the excerpt text on the card.
* **Padding**: Adjust the padding inside the card to control the space between the content and the card edges. This option includes responsive settings, allowing you to define different padding values for different screen sizes.
* **Border**: Customize the card's border by setting the width, size, and type (e.g., solid, dashed). This option also includes responsive settings, enabling you to define different border styles for different screen sizes.
* **Border Radius**: Set how rounded the corners of the card should be. The border radius option includes responsive settings, allowing for different levels of rounding on various devices.
* **Box Shadow**: Apply a shadow effect to the card, giving it a three-dimensional appearance. This option allows you to adjust the intensity and direction of the shadow.


# Post Page

The Post Page section, accessible via **Appearance -> Customize -> Blog -> Post Page**, lets you define the layout and styling of your individual blog posts. This area is designed to give you control over how your content is presented, with options for adjusting the featured image, configuring post metadata, and enabling additional elements like social sharing or author information.&#x20;

<figure><img src="/files/XQRRdPCCrZO1dd5qwj35" alt=""><figcaption></figcaption></figure>

## Layout

Choose how your post page layout will be structured. The available options are:

<figure><img src="/files/GR5uA1pdGqVFFSzIYG5J" alt="" width="330"><figcaption></figcaption></figure>

* **Narrow**: Displays posts in a narrower format, ideal for a focused reading experience.
* **Normal**: Provides a standard width for post content, balanced for readability.
* **Sidebar Left**: Places the sidebar on the left side of the post, offering additional navigation or widgets.
* **Sidebar Right**: Positions the sidebar on the right side of the post, useful for supplementary content or links.

***

<figure><img src="/files/w9gWtZSaEtQK4BZqk9Yb" alt="" width="333"><figcaption></figcaption></figure>

* **Narrow Width**: Controls the width of the content area when the “**Narrow**” layout is selected. You can adjust the width using a range from 600 pixels (minimum) to 900 pixels (maximum). This allows for a more compact or expanded narrow layout depending on your design needs.
* **Wide Alignment Offset**: This setting applies to elements with “Wide Alignment” in the Gutenberg editor. It adjusts the offset from the edges of the content area. The range for this offset is from 20 pixels to 200 pixels. This option is available for both the “**Narrow**” and “**Normal**” layouts, allowing for precise control over how wide-aligned content elements are positioned relative to the rest of the page.

***

* **Sidebar Widgets**: This option will appear when either the "**Sidebar Left**" or "**Sidebar Right**" layout is selected, allowing you to manage and populate sidebar widgets. For additional styling and customization of the sidebar please read the [sidebar styling article](/general/sidebars).

***

## Post Options

Here are the available options you can configure for your post pages. Each of these is a toggle, allowing you to turn the feature on or off. Some options have additional settings, while others do not:

<figure><img src="/files/xEzSePYkatAAX5ON6dYp" alt="" width="331"><figcaption></figcaption></figure>

* [**Featured Image**](#featured-image): Toggle to show or hide the featured image on the post page.&#x20;
* **Title**: Enable or disable the post title within the post.&#x20;
* [**Post Meta**](#post-meta): Show or hide metadata such as date, categories, and tags.&#x20;
* [**Social Sharing**:](#social-sharing) Toggle to enable or disable social sharing buttons.&#x20;
* [**Author Info**](#author-info): Enable or disable the author information at the bottom of the post.&#x20;
* [**Navigation**](#navigation): Toggle to enable or disable navigation links for previous and next posts.&#x20;
* **Comments**: Show or hide the comments section at the bottom of the post.&#x20;

### Featured Image

Control the display and style of the featured image on your posts. You can choose between a boxed, wide or full-width layout for the image and adjust its appearance, including gallery auto-play settings if applicable. These are the options for managing the featured image:

#### Layout

<figure><img src="/files/iXR8pY4SxZZLFgI7ShoW" alt="" width="341"><figcaption></figcaption></figure>

* **Boxed**: Contains the image within a boxed frame.
  * **Sidebar below**: A toggle that, when enabled, places the sidebar below the featured image instead of beside it.
* **Wide**: Contains the image within a boxed frame but wider than the content, available only in **Normal** and **Narrow** types.
* **Full Width**: Displays the image across the full width of the post page.

#### Image Size

Control the dimensions of the featured image:

<figure><img src="/files/CP3n3PYWwvOmu5dBJvU2" alt="" width="342"><figcaption></figcaption></figure>

* **Image Size**: Select from predefined sizes or define a custom size for the featured image.
* **Aspect Ratio**: Choose from predefined aspect ratios or set a custom ratio, with options for responsive adjustments.
* **Gallery Auto Play**: Set an auto-switch interval for images in a gallery.

#### Style Tab

<figure><img src="/files/7oibxZdIlQ1uXMVVycvR" alt="" width="340"><figcaption></figcaption></figure>

* **Border Radius**: Adjust the roundness of the image corners.

### Post Meta

Display or hide metadata associated with the post, such as the publication date, categories, and tags.

<figure><img src="/files/jbUOOcomNpVZot0acogq" alt="" width="338"><figcaption></figcaption></figure>

* **Date**: Toggle to show or hide the post date.
* **Category**: Toggle to show or hide the post category.
* **Tags**: Toggle to show or hide post tags.
* **Display Icon**: Toggle to show or hide an icon next to the metadata.

### Social Sharing

Allow visitors to share your post on various social networks directly from the post page. These are the options for social sharing:

<figure><img src="/files/sLXWRH722yKKPrwSUxiE" alt="" width="329"><figcaption></figcaption></figure>

#### Style

* **Labels**: Displays text labels for sharing buttons.
* **Icons**: Displays only icons for sharing buttons.

#### Share Networks

Add or remove sharing networks from the following options:

* Facebook
* X (Twitter)
* Pinterest
* Email
* LinkedIn
* Tumblr
* VKontakte
* WhatsApp
* Telegram
* Print

### Author Info

Show or hide the author box at the end of your posts. This section can include the author’s avatar and a brief description or biography. These are the options for the author box:

<figure><img src="/files/uScNH21TgwFUtxzhsY3b" alt="" width="334"><figcaption></figcaption></figure>

* **Author Avatar**: Toggle to show or hide the author's avatar.
* **Author Description**: Toggle to show or hide the author's bio or description.

#### Style Tab

<figure><img src="/files/mMQsmi2FEgca86Q6dvU5" alt="" width="331"><figcaption></figcaption></figure>

* **Background**: Set a background color for the author info section.
* **Headings**: Customize the color of the headings.
* **Text**: Set the color for the text content.
* **Links**: Customize the color of links, with separate options for normal and hover states.
* **Padding**: Adjust the padding around the author info section.
* **Border**: Set the border width, style, and color.
* **Border Radius**: Adjust the roundness of the borders.
* **Box Shadow**: Add a shadow effect to the author info section.

### Navigation

Manage the navigation links that appear at the bottom of your posts.

* **Reverse Order**: Enable this option to swap the 'Previous' and 'Next' links, allowing you to customize the order of blog navigation.

### Related Posts

<figure><img src="/files/Pd9bEGxycYvztkMVkg7H" alt="" width="333"><figcaption></figcaption></figure>

Display related posts at the end of the current post. You can configure which posts to relate based on tags, categories, or other criteria, and adjust the number of posts shown and their layout. These are the options for related posts:

#### Posts

<figure><img src="/files/kEF2eNnlGBFXr7H10Fl3" alt="" width="331"><figcaption></figcaption></figure>

* **Relate Group**: Choose the criteria for related posts—Any, Tag, or Category.
* **Posts to Show**: Select the number of related posts to display, from 1 to 12.
* **Columns**: Set the number of columns for related posts, ranging from 1 to 4, with responsive options.
* **Post Meta**: Toggle to show or hide metadata on related posts.

#### Container

<figure><img src="/files/EgTNkd3OGuDonnG6LWIA" alt="" width="335"><figcaption></figcaption></figure>

* **Inherit Container Size**: Toggle to make the related posts container match the size of the main content container.
* **Title**: Input a custom title for the related posts section.
* **Visibility**: Choose to show or hide the related posts section on specific devices.

#### Style Tab

<figure><img src="/files/lRDz4OFRvVGSn7EWGOPL" alt="" width="331"><figcaption></figcaption></figure>

* **Background**: Set a background color for the related posts section.
* **Vertical Padding**: Adjust the vertical padding for spacing around the related posts.


# Creating a Blog Page

By default, WordPress allows you to designate a page as your blog, which then serves as a dynamic feed for your posts. This means that whenever you publish a new post, it automatically appears on this page, keeping your content organized and easily accessible for your readers.

In this guide, we’ll walk you through the steps to create and set up your blog page in WordPress. We’ll cover everything from creating the page to configuring it as your posts page. With a few simple steps, you'll have your blog up and running, ready to showcase your latest content and engage with your audience.

If you don’t want to use the default homepage as your blog page and prefer to create a separate page for your blog, follow these steps:

1. In the WordPress sidebar, go to **Pages** **->** **Add New**.
2. Enter a title for your blog page. Common titles include **"Blog"**, **"Thoughts"**, or **"News"**.
   * Optionally, add a description to introduce your blog or provide context for your readers.
3. Click **Publish** to make your blog page live on your site.

![Creating the Blog Page](/files/THyurimGlvnJLkzQ8rTF)

## Setting Your Blog Page as the Posts Page

After creating your blog page, you need to designate it as the page that will display your blog posts:

1. Navigate to **Settings** **->** **Reading** in the WordPress sidebar.
2. In the **Front page displays** section, select **A static page (select below)**.
3. In the **Posts page** dropdown menu, choose the blog page you created earlier.
4. Click **Save Changes** to apply the settings.

![Setting Your Blog Page](/files/j919rPW33iSM7rBzyBm3)

Now, your blog page is set to display all your posts. You can view it by going to **yoursite.com/blog**.

## Creating a Blog Page with Elementor

If you want to move beyond the basic WordPress blog archive, Elementor’s powerful page builder can help you design a blog page that matches your vision. With its easy-to-use interface and extensive customization options, Elementor allows you to create a visually appealing and functional blog page.

### Create a New Page

Go to your WordPress dashboard and under **Pages** from the left-hand menu, and click **Add New** **Page** to create a new page.

### Set Up the Page

1. Enter a title for your blog page (e.g., "Blog" or "Latest News").
2. Click the **Edit with Elementor** button to start customizing your page with Elementor.

<figure><img src="/files/BWko34GxKpNxHYNrTXWY" alt=""><figcaption></figcaption></figure>

### Add the Blog Posts Widget

From the left widget area of Elementor, under the **Kalium** section, drag or click the **Blog Posts** widget onto your page (right area).

<figure><img src="/files/WOfTMvud0rjBVbFmapCI" alt=""><figcaption></figcaption></figure>

### Configure the Blog Posts Widget

Under the **Content** tab, adjust the layout options to fit your needs. These settings will override the default [Blog Page options](/post-types/blog/blog-page).

<figure><img src="/files/iXclRJlcBePjtzgNx88e" alt=""><figcaption></figcaption></figure>

Switch to the **Style** tab in the widget settings. You can choose to [inherit styles from the Customizer](/post-types/blog/blog-page#style-tab) or set new styles directly in Elementor.

<figure><img src="/files/y1IC1qC1NYE8vxoZaHCK" alt=""><figcaption></figcaption></figure>

### Publish Your Page

Once you're satisfied with the setup, click the **Publish** button in the top right corner to make your blog page live.

## Creating a Blog Page with WPBakery

WPBakery Page Builder enables you to create a blog page with a personalized touch. Instead of using the default WordPress blog archive, WPBakery lets you build a blog page from scratch, offering extensive customization to achieve your desired look and layout.

### Create a New Page

Go to your WordPress dashboard, select **Pages** from the left-hand menu, and click **Add New Page** to create a new page.

### Set Up the Page

1. Enter a title for your blog page (e.g., "Blog" or "Latest News").&#x20;
2. Click the **WPBakery** button to start customizing your page with the WPBakery Page Builder.

<figure><img src="/files/DFOEvTch5I7qtz1fkcAX" alt=""><figcaption></figcaption></figure>

### Choose Editor

Choose between "**Backend**" or "**Frontend**" editor. For this example, we'll use the Backend editor.

<figure><img src="/files/MeEkvwilJjyb66ge2cDd" alt=""><figcaption></figcaption></figure>

### Select Layout

Choose the **Default Layout** for your blog page.

<figure><img src="/files/nGniHcIVmUtOolSrwW2E" alt=""><figcaption></figcaption></figure>

### Add Blog Posts Element

Click the **+ Add Element** button.

<figure><img src="/files/vp1ueJ4O8AZuWFCE60yz" alt=""><figcaption></figcaption></figure>

In the popup that appears:

* Switch to the **Laborator** tab and select **Blog Posts**.
* Alternatively, use the search bar to find the element directly.

<figure><img src="/files/qhMKCP0c43TcFiq2Gjdz" alt=""><figcaption></figcaption></figure>

### Customize the Blog Posts Widget

Set the options in the Blog Posts widget to overwrite the [layout and style of the Blog Page](/post-types/blog/blog-page) under the Customizer. Click **Save Changes** to apply your settings.

<figure><img src="/files/IhKl19XkcpGXFpDWD236" alt=""><figcaption></figcaption></figure>

### Publish Your Page

When you're done customizing the blog page, click the **Publish** button on the right side to make your blog page live.


# Creating a Blog Post

Now that your [Blog page](/post-types/blog/creating-a-blog-page) is set up, it's time to dive into creating engaging content. Whether you're sharing personal stories, news updates, or insights on your favorite topics, WordPress makes it easy to publish and manage your blog posts.

Follow these steps to create your first blog post and make the most out of the available post formats:

## Creating Your First Blog Post

Before getting started, let's start creating the first blog post, you can do so by navigating to the WordPress sidebar, go to **Posts** **->** **Add New**.

<figure><img src="/files/PrtnIzepbCSDt7uj9jz1" alt=""><figcaption></figcaption></figure>

1. Enter a  title for your blog post that captures the essence of your content.
2. Write the main content of your post in the **Content** area. Here, you can add text, images, and other media.
3. Set a featured image to visually represent your post. This image will appear prominently on your blog and in previews.
4. Choose the appropriate format for your post from the **Format** section on the right.&#x20;
5. Assign at least one category to organize your post. Categories help readers find related content.
6. Add any tag if you wish to the post.
7. Click **Publish** to make your post live or **Update** to save changes to an existing post.

## Blog Post Formats

WordPress supports various post formats, each designed to display different types of content. Kalium enhances this by providing custom post layouts for each format, ensuring that your posts look beautiful and engaging no matter the format you choose.

These are the supported blog post formats:

* [Audio](#audio-format)
* [Gallery](#gallery-format)
* [Image](#image-format)
* [Link](#link-format)
* [Quote](#quote-format)
* [Standard](#standard-format)
* [Video](#video-format)

Additionally, Kalium automatically detects the relevant content within your post and displays it in the featured area. For example, if you include an audio file in an audio post format, Kalium will automatically pick the first audio file in the post and use it as the featured content, displaying it in the featured image area.

To choose a specific post format when creating or editing a post, on the right sidebar under **Format** click the **Standard** link, then from the format popup choose the type:

<figure><img src="/files/ZmdEbNlHqOCnmjdokNZE" alt=""><figcaption><p>Instructions on how to choose a post format</p></figcaption></figure>

Below, we’ll explain each format and how Kalium optimizes the layout for them.

### Standard Format

The Standard format is the default and most commonly used format. It displays your post content with a featured image. It’s perfect for general posts.

### Video Format

Use the Video format to feature videos directly in your post. You can embed videos from YouTube, Vimeo, or upload a self-hosted video.

<figure><img src="/files/6Avw0ZEDXzqsyAdNyY7c" alt=""><figcaption><p>Video post format preview</p></figcaption></figure>

To use the Video format in Kalium, follow these steps:

1. Ensure you have chosen **Video** in the Format section on the right side of the editor.
2. Add a **Video** block using the Gutenberg editor. You can use a self-hosted video or any video from YouTube or Vimeo. Kalium will automatically use the first video in your post as the featured video.

In the Parameters and Options area under "**Video Post Settings**", you can set options such as **Video Resolution** and **Auto Play Video:**

<figure><img src="/files/zLxvl3jTahnsZLPApmcv" alt=""><figcaption></figcaption></figure>

### Quote Format

The Quote format is designed to highlight quotes. Use it to feature a quote prominently at the top of your post.

<figure><img src="/files/QMwF7Oghqqlp9ZWhZOSB" alt=""><figcaption><p>This is how Quote post looks like</p></figcaption></figure>

### Image Format

The Image format is basically the same as the Standard Format but if you forget to add a featured image to your post, it will automatically take the first image that you have in the post (if you have any).

### Link Format

The Link post format is specifically designed for sharing external links. This format allows you to direct readers to another website or resource without needing extensive content within the post itself. Steps to use the link format are as follows:

1. When creating or editing your post, choose **Link** in the **Format** section on the right.
2. In the post editor, enter the URL of the external site you want to link to.

### Gallery Format

The Gallery format is used when you want to add an image slider.

<figure><img src="/files/cKDHb4KsUIQRK4ZQGPCI" alt=""><figcaption><p>A preview of a Gallery post, notice the gallery arrows</p></figcaption></figure>

To create a Gallery post, make sure that you have selected **Gallery** on the **Format** section on the right.

Then in the **Parameters and Options** -> **Post Slider Images**, you can add images to populate the slider.

<figure><img src="/files/yZyM5ImZZGKZ0pQ8vbah" alt=""><figcaption></figcaption></figure>

On the frontend, the **Featured Image** will show first, followed by the images you have added in **Post Slider Images** based on your order.

### Audio Format

<figure><img src="/files/NZowg8yQSyv27YbUQtmu" alt=""><figcaption><p>Audio post format preview with a featured image</p></figcaption></figure>

To use the Audio format in Kalium, follow these steps:

1. Make sure you have chosen **Audio** in the Format section on the right side of the editor.
2. To include an audio in your post, use the Gutenberg editor to add an **Audio** block to your content. Kalium will automatically detect the first audio block within the post and use it as the featured content, showing it prominently in the featured image area.

In the **Parameters and Options** area under **Audio Post Settings**, you can select the option **Auto Play Audio** to play the audio automatically, as explained below:

<figure><img src="/files/7LFsVvLVxcSzooh3HPsc" alt=""><figcaption></figcaption></figure>

## Post Settings

When creating or editing a blog post in Kalium, you can use Post Settings to customize options specific to that post. These settings allow you to override the global options set in the [Post Page](/post-types/blog/post-page) section of the Customizer, giving you more control over how each post appears. Access the post settings by scrolling down to **Parameters and Options** **→** **Post Settings**.

<figure><img src="/files/u6rp7xxHFjNCaZsKtSMD" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
For other options under **Parameters and Options**, please check the [In Page Options](/general/header/in-page-options) article for more details.
{% endhint %}

#### Post Settings

* **Featured Image Placing:** Choose how the featured image is displayed in your post.&#x20;
  * Inherit ([Use from theme options](/post-types/blog/post-page#featured-image))&#x20;
  * Boxed
  * Wide
  * Full-Width
  * Hide
* **Image Size:** Adjust the size of the featured image
  * Inherit ([Use from theme options](/post-types/blog/post-page#image-size))&#x20;
  * Default
  * Original
* **Related Posts:** Configure whether related posts are displayed or not, or inherit the options.
  * Inherit ([Use from theme options](/post-types/blog/post-page#related-posts))&#x20;
  * Show
  * Hide


# Portfolio

The Portfolio has been an integral part of the Kalium theme since its inception, starting from version 1. It’s not just a feature—it’s a source of pride for the theme.&#x20;

Designed with flexibility and creativity in mind, the Portfolio section allows you to showcase your work in a visually stunning and highly customizable manner, making it a favorite among users.

<figure><img src="/files/p47F5hY2duruiDJkUHVH" alt=""><figcaption></figcaption></figure>

## How To Enable Portfolio

To enable the Portfolio feature in Kalium, follow these steps:

1. Navigate to **Kalium -> Settings** from your WordPress dashboard.
2. Click on the **Portfolio** tab to access the Portfolio settings.
3. Turn the **Portfolio Extension** toggle to **On**.

This will activate the Portfolio feature on your site, allowing you to create and manage your portfolio projects within Kalium.

<figure><img src="/files/EjCj0f72gby2aFcpn9ze" alt=""><figcaption></figcaption></figure>


# Portfolio Page

The **Portfolio Page** (or, in WordPress terms, the *Portfolio Archive*) allows you to customize the general layout of all the projects that are listed. To customize the Portfolio page, navigate to **Appearance -> Customize -> Portfolio -> Portfolio Page**.

<figure><img src="/files/Orz9jUcVYNMSMoROr66b" alt=""><figcaption></figcaption></figure>

***

## Layout

On the Portfolio page, you can select between two layout options:

<figure><img src="/files/df9t5X82c2u1IW91BAlG" alt="" width="325"><figcaption></figcaption></figure>

### Type 1

This layout aligns the image and content in a vertical flow, with the image positioned above the title and category.

<figure><img src="/files/cES9di8jSc64bYBUP37D" alt="" width="375"><figcaption></figcaption></figure>

### Type 2

This layout displays the portfolio title and details as an overlay on top of the featured image, which becomes visible when the user hovers over the image.

<figure><img src="/files/v0qbtzKv2zXmtTnwSpbZ" alt="" width="375"><figcaption></figcaption></figure>

***

## Grid Options

Grid options allow you to customize the layout of portfolio items, including the number of columns, spacing between items, and more.

<figure><img src="/files/eCebW9S2d9Ccq9CFYYX9" alt="" width="329"><figcaption></figcaption></figure>

* **Items Per Page:** Defines the total number of items to fetch from the database and display per page.
* **Columns:** Defines the number of columns per row for displaying portfolio items across different viewports.
* **Columns Gap:** Sets the spacing between portfolio items in the grid layout.
* **Layout Mode:** A special alignment feature that uses masonry for item placement, allowing for a dynamic, staggered grid layout.

### Masonry Layout

A grid layout where items are arranged in a staggered, column-based manner, optimizing space usage and visual appeal. It uses the **Isotope** library to make this alignment possible, as current CSS specification does not support native masonry layout.

<figure><img src="/files/Z3dL3FhvwSMNNOQR8NRI" alt=""><figcaption></figcaption></figure>

### Fit Rows Layout

A layout option where items are arranged in rows with uniform height, filling the available space. Unlike Masonry, which adjusts item placement based on height, Fit Rows ensures consistent row heights.

<figure><img src="/files/HWvEtDtPSU2ozalRug9g" alt=""><figcaption></figcaption></figure>

***

## Card Options

You can customize the appearance of each entry using the following options:​

<figure><img src="/files/kXlTyebbVEzk8eoJSTGP" alt="" width="336"><figcaption></figcaption></figure>

***

### Featured Image

The Featured Image settings let you control the display of the featured image on each post card. This section offers several additional configuration options:

<figure><img src="/files/fPhn8JDDTQOh3GYFpvq9" alt="" width="329"><figcaption></figcaption></figure>

* **Hover Overlay:** You can toggle the hover overlay on or off, which appears over the image when enabled.
* **Offset:** The offset of the hover overlay layer, which sets the distance from the edges of the image.
* **Icon:** The icon displayed in the center of the hover overlay can be a pre-defined icon, such as the **Animated Eye** Icon or **Static Eye** Icon, or you can upload your own image to be shown within the overlay.

<figure><img src="/files/hW6SxFpRB6rs3pxdAgg6" alt="" width="331"><figcaption></figcaption></figure>

You can select an image as the Custom Icon and adjust its width accordingly.

#### Image Size

Control the dimensions of the featured image:

<figure><img src="/files/XwcY56dU6OzymorZGSZQ" alt="" width="329"><figcaption></figcaption></figure>

* **Image Size**: Select from predefined sizes or define a custom size for the featured image.
* **Aspect Ratio**: Choose from predefined aspect ratios or set a custom ratio, with options for responsive adjustments.

#### Style

The Style tab contains settings to customize the overall appearance of the featured image on the card.

<figure><img src="/files/dqEL1oJWIJNwFNTy52Nj" alt="" width="325"><figcaption></figcaption></figure>

* **Border Radius**: Set how rounded the corners of the featured image should be.
* **Hover Overlay**
  * **Background:** The background type can be a *solid color* or the *dominant color* extracted from the image.
  * **Background Color:** Visible when the background is set to Color, this option applies a solid color to the background, with adjustable opacity.
  * **Color Opacity:** Visible when the background is set to Dominant Color, this option adjusts the opacity of the dominant color.

***

### Like Feature

When enabled, the like feature will be active across all items in the portfolio module.

Displays the number of likes on portfolio items. Users can click the like icon to add a like, which updates the total count for each item.

Optionally, you can change the icon for the like button:

<figure><img src="/files/tYSyPmreBoWnifYTrKDM" alt="" width="327"><figcaption></figcaption></figure>

***

### Subtitle

Optionally, you can display a subtitle under the item title on portfolio items, with options to show categories, parent categories, tags, or a custom subtitle.

<figure><img src="/files/dyBeqKLATnQBGtrJtqGi" alt="" width="324"><figcaption></figcaption></figure>

* **Subtitle Content:** The content type to show under the title.
  * Categories&#x20;
  * Parent Categories&#x20;
  * Tags&#x20;
  * Subtitle
* **Separator:** The separator for categories and tags.

***

### Reveal Effect

The Reveal Effect applies animations to portfolio items as they come into view within the viewport. There are three main animations:

* Fade
* Slide
* Fade Zoom In

With alternatives to stagger mode, which animates items sequentially, one after another.

***

### Content Alignment

Available only for layout **Type 2**, this option lets you set the alignment of the *title* and *subtitle* within the featured image.

***

## Page Elements

The Page Elements section lets you customize additional components of your Portfolio Page. Here are the available options:

<figure><img src="/files/V9WxyduhB6gPujXYtdur" alt="" width="329"><figcaption></figcaption></figure>

***

### Title & Description

You can set the heading for the portfolio items, including the title and description, and adjust their alignment in relation to the filters if enabled.

<figure><img src="/files/p52q4TDbjmuWYD37iT1D" alt=""><figcaption></figcaption></figure>

You can adjust the layout of the heading after going inside the section:

<figure><img src="/files/sgEPZYwWjN9DqRXxJZnP" alt="" width="329"><figcaption></figcaption></figure>

* **Heading and Filter Layout:** Adjusts the alignment of the title and description in relation to the filters, if enabled.
* **Portfolio Title:** Sets the heading title for the portfolio items.
* **Portfolio Description:** Provides the description displayed with the portfolio items.

#### Heading Layouts

Depending on the layout you choose, the title and description will appear as follows:​

<figure><img src="/files/2DkKr9UA7DALz9JPlAbw" alt=""><figcaption><p>Left</p></figcaption></figure>

<figure><img src="/files/pTXGfDFgU3c6arglHgXV" alt=""><figcaption><p>Center</p></figcaption></figure>

<figure><img src="/files/RSqXNW2IDLBzYcsBMMQT" alt=""><figcaption><p>Space between</p></figcaption></figure>

***

### Filters

Filters are a crucial part of the portfolio experience. They enable users to interactively sort and view items based on their selected criteria. Additionally, filters support browser history, allowing selections to be retained even without refreshing the page.

Previously, Kalium supported only one filter type. Now, you can add two filter types to enhance the user experience, allowing for a more detailed lookup of your portfolio catalog.

<figure><img src="/files/DQSjdbjoBaCLPQSrHFEA" alt="" width="321"><figcaption></figcaption></figure>

You can choose to use either one or both filter types.

#### Show All / Reset

This option adds a **Show All** link as the first filter, which resets the current filters. If two filter types are active, it will reset the selection for the current term only.

<figure><img src="/files/jAfu34dgmeBAll1OnfG8" alt="" width="326"><figcaption></figcaption></figure>

You can use custom text for reset, default is *All*.

#### Count

Displays the number of items containing each filter term, shown beside the filter link. This count helps users understand how many items match each specific filter.​

Two styles are available for the count display, with support for both prefix and suffix.

<figure><img src="/files/1t82TYuZZctdL85bOt58" alt="" width="330"><figcaption></figcaption></figure>

* **Show Count:** Enables or disables the counter.
* **Style:** The style of the counter.
  * **Style 1:** Inline text&#x20;
  * **Style 2:** Sup text
* **Before:** Text to display before the count number.
* **After:** Text to display after the count number.

#### Subcategories

By default, this feature is enabled. For category hierarchies, when a term with sub-terms is selected, it will filter to show only the sub-terms, hiding the current row of filters and displaying the relevant sub-term row.

This helps narrow down the results more effectively.

#### Dynamic Heading

This feature helps users see active filters and additional information. When enabled, it updates the heading title with the current category or tag name, the heading description with the category or tag description, or both.

Available options:

* Disable (*default*)
* Change title&#x20;
* Change description
* Change title and description

#### Link Format

Link format determines how filter links appear in the browser’s address bar. You can choose between three options:

* **None:** Disables link history completely.
* **Hash:** Appends a hash to the URL, showing current filter information.
* **Absolute Link:** Updates the URL to include the term archive link.

#### Default Category & Tag

You can set a default selected category or tag by choosing the desired term from the list:

<div><figure><img src="/files/Ss2wp1hR5tFOIAwCrs1n" alt="" width="326"><figcaption><p>Category options</p></figcaption></figure> <figure><img src="/files/FmKKqLZuJ27JSTAQbgeP" alt="" width="324"><figcaption><p>Tag options</p></figcaption></figure></div>

#### Filter Label

The filter label adds a text prefix before the filters to explain their purpose. You can leave this field empty if you prefer not to display any label.

***

### Full Width Container

This option allows you to expand the container’s width to span the entire viewport, overriding the default content width. This setting is useful for creating wide layouts or for elements that need to stretch across the entire screen, such as banners or full-width sections.

<figure><img src="/files/JPhhkAIB0h2wurdKlb7o" alt=""><figcaption><p>Full width portfolio container</p></figcaption></figure>

After activating the **Full Width Container** option, additional settings will appear, allowing you to fine-tune the layout for better control over the design:

<figure><img src="/files/msipww4XsO2pqRtl09Co" alt="" width="324"><figcaption></figcaption></figure>

* **Portfolio Heading:** Decide if the heading should extend across the full width of the container or remain within its standard width.
* **Stretch Items to the Edge:** This option extends the portfolio items to align with the container’s edges, creating a more immersive layout. By default, container spacing is applied if this option deactivated.

{% hint style="info" %}
If your settings aren’t taking effect, you might be using a ***Page Template*** or ***Page Builder Element*** to display the portfolio, which has its own standalone options and should be configured inside their respective options interface.
{% endhint %}

***

### Pagination

Configure how portfolio items are divided across multiple pages to manage navigation. You can choose between two types of pagination:

* [**Numbers**](#numbers)
* [**Load More**](#load-more)

#### Numbers

Display numbered pagination for navigation.

<figure><img src="/files/4DwLtH0QvYnvMvKVIFFG" alt="" width="333"><figcaption></figcaption></figure>

#### Display Type

* **Numbers**: Show only page numbers.
* **Numbers + Previous/Next**: Display page numbers along with Previous and Next buttons for easier navigation.
* **Previous/Next**: Show only Previous and Next buttons.

***

#### Load More

Use a button to load more posts as users scroll down the page.

<figure><img src="/files/t9L2k1Ixsklmhnmp9cYR" alt="" width="335"><figcaption></figcaption></figure>

* **Infinite Scroll**: Toggle this to enable or disable infinite scrolling, where more posts load automatically as users scroll down the page.
* **Loading Effect**: Choose a loading effect to display while new posts are being fetched:
  * **Spinner**: A spinning icon indicating loading.
  * **Pulsate**: A pulsating effect indicating loading.

***

#### Alignment

Set the alignment of pagination controls for both types:

<figure><img src="/files/2VMeWnvaK3TQkLRkKdSr" alt="" width="332"><figcaption></figcaption></figure>

* **Left**: Align pagination controls to the left.
* **Center**: Center-align pagination controls.
* **Right**: Align pagination controls to the right.
* **Space Between**:  Distribute space between items (Available only for Numbers type)

***

### Lightbox Type

In this section, you can customize the options specific to **Lightbox** for portfolio item types.

<figure><img src="/files/5BPXvRS9TozhOylRk9l5" alt="" width="323"><figcaption></figcaption></figure>

* **Browse Mode:** If set to **Linked** mode, the lightbox’s previous and next arrows will navigate through all the projects displayed in the list.
* **Link Format:** Determines how the links appear in the browser’s address bar.
  * **None:** Disables link history completely.
  * **Hash:** Appends a hash to the URL, showing current lightbox information.
  * **Absolute Link:** Updates the URL to include the item single page link.&#x20;


# Project Page

Although each project has its own set of options, this section will guide you through the common settings that apply to all projects.

To customize the project page settings, navigate to **Appearance -> Customize -> Portfolio -> Project Page**.​

<figure><img src="/files/BulIdCq7Qb73yethQL4k" alt="" width="332"><figcaption><p>Project page options</p></figcaption></figure>

## Navigation

This feature allows users to navigate between individual project pages seamlessly by providing next and previous buttons. This functionality ensures a smooth and intuitive browsing experience through your project portfolio.

To begin, select one of the two available layouts:

<figure><img src="/files/Qkdu9uuf8mo852wiTa2O" alt="" width="323"><figcaption></figcaption></figure>

Both layouts share the same functionality options, but they define different visual appearances.

### Standard

<figure><img src="/files/e5AVffRcNvdY0lrsqrdi" alt=""><figcaption></figcaption></figure>

This layout appends the navigation controls at the end of the portfolio content and includes a “Back to Projects” link centered in the middle.

### Fixed

<figure><img src="/files/ZChT4H0fxnOchPH7es8U" alt=""><figcaption></figcaption></figure>

This layout keeps the navigation arrows fixed at the bottom edge of the browser window. You can position the arrows at the **Left**, **Center**, or **Right** of the window:

<figure><img src="/files/DBclVEwCWe0NoZjFG2zm" alt="" width="321"><figcaption></figcaption></figure>

{% hint style="info" %}
Fullscreen portfolio item types use this navigation as the only option due to their design structure, ensuring a consistent and seamless browsing experience.
{% endhint %}

***

Other available options for navigation include:

<figure><img src="/files/Jb6ToW7rzDQBzOvqEq2U" alt="" width="319"><figcaption></figcaption></figure>

* **Project Title Navigation:** If enabled, this will replace the default “Previous” and “Next” labels with the project titles.
* **Same Category Navigation:** Navigate only within the same category as the current project.
* **Reverse Order:** Enabling this option swaps the functionality of the **Previous** and **Next** links in your portfolio, allowing you to customize the sequential order of navigation.
* **Category as Archive Link:** The category of the current project will be used as the **Back to Archive** link.
* **Archive Link:** The link used to redirect to the portfolio archive page.

### In-Page Navigation Options

Some of these functionalities can be adjusted on a per-project basis. On the project edit page, scroll to **Parameters and Options -> General Details -> Prev-Next Navigation**.

<figure><img src="/files/34GopB3A0DpRx7Q1J3dz" alt=""><figcaption></figcaption></figure>

## Social Sharing

Allow visitors to share the projects on various social networks directly from the post page. Here are the options for social sharing:

<figure><img src="/files/sLXWRH722yKKPrwSUxiE" alt="" width="329"><figcaption></figcaption></figure>

#### Style

* **Labels**: Displays text labels for sharing buttons.
* **Icons**: Displays only icons for sharing buttons.

#### Share Networks

Add or remove sharing networks from the following options:

* Facebook
* X (Twitter)
* Pinterest
* Email
* LinkedIn
* Tumblr
* VKontakte
* WhatsApp
* Telegram
* Print

## Lightbox

This option enables the *Lightbox* feature for gallery images. When activated, clicking on images within project galleries will open them in a larger, overlay view, providing a clearer and more detailed view.

{% hint style="info" %}
This feature does not apply to **Lightbox item types** but affects only images inside galleries.​
{% endhint %}

## Image Captions

In project galleries, this setting controls images with caption text.

* **Image Captions:** Toggle captions on or off for all gallery images.
* **Caption Position:** Placement of the caption element.
  * **Hover:** Show captions only when the user hovers over the image.
  * **Below:** Display the caption consistently below the image.


# Creating a Portfolio Page

The Portfolio Page, also known as the *portfolio archive*, displays all your portfolio items in one place. By default, the portfolio page is located at this URL `yoursite.com/portfolio` unless you [modify it](#permalinks-structure).

There are several methods to create and set up a **Portfolio Page**:

1. [**Default Post Type Archive Page**](#default-post-type-archive-page): Automatically generated by WordPress for the "Portfolio" post type. It displays all portfolio items using the default archive layout.
2. [**Page Template "Portfolio Page"**](#page-template-portfolio-page): Choose this template when creating a new page to set up a custom-designed Portfolio Archive page with layout options specific to the Kalium theme.
3. [**Elementor Widget**](#elementor-widget): Use the Elementor Page Builder to add a Portfolio widget to any page, providing advanced design and layout options.
4. [**WPBakery Widget**](#wpbakery-widget): For users of WPBakery Page Builder, add the Portfolio widget to your page for a customizable and visually appealing portfolio display.

In this guide, we will cover each method of creating the Portfolio Page and demonstrate how to use them effectively to showcase your portfolio items.

## Default Post Type Archive Page

The default post type archive page is automatically generated by WordPress for the **Portfolio** post type.&#x20;

It provides a standard archive layout to display all portfolio items. For additional customization options, refer to the [**Portfolio Page**](/post-types/portfolio/portfolio-page) article where you can learn how to define and adjust the appearance of your portfolio page according to your preferences.

This method is straightforward and requires no extra configuration, making it an easy option for a basic portfolio display.

### Permalinks Structure

The permalinks structure for the **Portfolio** post type is located in **Settings -> Permalinks**:

<figure><img src="/files/xiSroFUv78vgPIyUvTkO" alt=""><figcaption></figcaption></figure>

Every single portfolio item (project) includes the **Portfolio base** prefix in its permalink, e.g., `yoursite.com/portfolio/project-url`. To remove this prefix, simply leave the field empty.

{% hint style="info" %}
There is a caveat to removing the portfolio prefix: without it, the default portfolio archive will no longer be available. Instead, you will need to create the archive using the methods described on this page.
{% endhint %}

## Page Template "Portfolio Page"

Using the Page Template **Portfolio Page** allows you to create a custom *portfolio archive* page with specific layout options provided by the Kalium theme.&#x20;

When you select the **Portfolio Page** template for a new page, it inherits all the initial design settings and options defined in the Portfolio Page section of the Customizer.&#x20;

You can then set various additional settings to customize the output of your portfolio page, allowing for greater flexibility and control over the presentation of your portfolio page.

### Create a New Page

Go to your WordPress dashboard and under **Pages** from the left-hand menu, and click **Add New** **Page** to create a new page.

<figure><img src="/files/HTJaoiNm0mDDJCXVQmPB" alt=""><figcaption></figcaption></figure>

After selecting Portfolio Page template, click on **Parameters and Options -> Portfolio Settings** to override the options that you need:

<figure><img src="/files/dq2Oyft21bg0QJUR6tUB" alt=""><figcaption></figcaption></figure>

* **Show Title & Description:** This option allows you to hide or show the portfolio title and description that is [defined here](/post-types/portfolio/portfolio-page#title-and-description). You can choose to disable this feature if you have custom content that you want to display above the portfolio.
* **Custom Query:** This option provides a query builder that allows you to select specific items to appear on that page only. It enables you to customize the content displayed on the portfolio page according to your preferences.
* **Masonry Style Portfolio:** Create a custom pattern for displaying portfolio images. It allows you to design a creative layout with various image formats that will align neatly based on the Masonry layout style. This section is covered **here**.
* **Default Filter Category:** Set a default filter category that will be applied automatically when users visit the portfolio page.

### Grid Settings

Various grid settings are available for the Portfolio Page template in **Grid Settings** tab, allowing you to customize how portfolio items are displayed. These settings include:

<figure><img src="/files/F8NxcCPwYStzvimVcYYO" alt=""><figcaption></figcaption></figure>

* **Columns Count**: Set the number of items per row.&#x20;
* **Reveal Effect**: Control the animation effect applied to portfolio items as they enter the viewport. [Learn more about reveal effect ->](/post-types/portfolio/portfolio-page#reveal-effect)
* **Full Width Container**: Enabling this option makes the portfolio container span the full width of the viewport. [Learn more about full width container ->](/post-types/portfolio/portfolio-page#full-width-container)
* **Title and Filter Container**: Visible when the Full Width Container is set to **Yes**. This option extends the portfolio items to align with the container’s edges, creating a more immersive layout.

### Layout Type

Alternatively, you can use either of the two available [Portfolio Page](/post-types/portfolio/portfolio-page) card layouts in the **Layout Type** tab. Select the layout type you want to apply for portfolio items in this page only. By default, it inherits the layout type set in the Customizer.

<div><figure><img src="/files/NIuTAc4pJiCNXvhHUGpg" alt=""><figcaption><p>Layout Type 1</p></figcaption></figure> <figure><img src="/files/pGFqLqY7O9Gxett3IHAZ" alt=""><figcaption><p>Layout Type 2</p></figcaption></figure></div>

### Custom Query

This option alters the output of portfolio items displayed on the page. It allows you to define a specific set of items to show, independent of the default filters. The filters on the page will then adjust based on the items included in the custom query.

<figure><img src="/files/Kw8AP7M9n0Qio3L7DqiN" alt=""><figcaption></figcaption></figure>

* **Portfolio Items**: List individual portfolio items to display.
* **Select From Category**: Choose portfolio categories to include items from.
* **Select From Tags**: Choose portfolio tags to filter items by.
* **Order By**: Define the criteria for sorting portfolio items (e.g., date, title).
* **Order**: Specify the sorting direction (ascending or descending).
* **Items per Page**: Set the number of portfolio items to display per page.

## Elementor Widget

If you want to enhance your portfolio presentation beyond the default layout, Elementor’s powerful page builder offers a versatile solution. Elementor’s intuitive interface and extensive customization options enable you to create a visually appealing and highly functional portfolio page that aligns with your vision.

### Create a New Page

Go to your WordPress dashboard and under **Pages** from the left-hand menu, and click **Add New** **Page** to create a new page.

### Set Up the Page

1. Enter a title for your portfolio page (e.g., "Portfolio" or "Our Projects").
2. Click the **Edit with Elementor** button to start customizing your page with Elementor.

<figure><img src="/files/gTNLOhQGN5YZANRbJKKp" alt=""><figcaption></figcaption></figure>

### Add the Portfolio Items Widget

From the left widget area of Elementor, under the **Kalium** section, drag or click the **Portfolio Items** widget onto your page (right area).

<figure><img src="/files/CozDGosAPx5OG9QVcb8k" alt=""><figcaption></figcaption></figure>

### Configure the Portfolio Items Widget

Under the **Content** tab, adjust the basic options to fit your needs. These settings will override the default [Portfolio Page](/post-types/portfolio/portfolio-page) options.

<figure><img src="/files/6n6cBr81dQKYeif3MQrM" alt=""><figcaption></figcaption></figure>

Switch to the Layout tab in the widget settings. You can choose to inherit layout settings from the Customizer or configure new layout options directly in Elementor.

<figure><img src="/files/Y62JMfrQqqsH2KoqBcFI" alt=""><figcaption></figcaption></figure>

### Publish Your Page <a href="#publish-your-page" id="publish-your-page"></a>

Once you're satisfied with the setup, click the **Publish** button in the top right corner to make your blog page live.

## WPBakery Widget

WPBakery Page Builder enables you to create a portfolio page with a personalized touch. Instead of using the default WordPress portfolio archive, WPBakery lets you build a portfolio page from scratch, offering extensive customization to achieve your desired look and layout.

### Create a New Page

Go to your WordPress dashboard, select **Pages** from the left-hand menu, and click **Add New Page** to create a new page.

### Set Up the Page

Enter a title for your portfolio page (e.g., "Portfolio" or "Our Work").

Click the **WPBakery** button to start customizing your page with the WPBakery Page Builder.

<figure><img src="/files/C9ujRTnljQPso67UsRV2" alt=""><figcaption></figcaption></figure>

### Choose Editor

Choose between **Backend** or **Frontend** editor. For this example, we'll use the Backend editor.

<figure><img src="/files/EWyKakQYx1ymGzn2eEAq" alt=""><figcaption></figcaption></figure>

### Select Layout

Choose the **Default Layout** for your portfolio page.

<figure><img src="/files/sUhAylFqOoqYQ59nu0kC" alt=""><figcaption></figcaption></figure>

### Add Portfolio Widget

Click the **+ Add Element** button.

In the popup that appears:

1. Switch to the **Laborator** tab and select **Portfolio**.
2. Alternatively, use the search bar to find the element directly.

<figure><img src="/files/Ndh5lATXnyXn84Zdlbed" alt=""><figcaption></figcaption></figure>

### Customize the Portfolio Widget

Set the options in the **Portfolio** widget to overwrite the layout and style of the **Portfolio Page** under the Customizer. Click **Save Changes** to apply your settings.

<figure><img src="/files/yRaWu9eBMg9WgWV8DAvp" alt=""><figcaption></figcaption></figure>

<div><figure><img src="/files/5Krb07NHbR5gOfImfdSL" alt="" width="375"><figcaption></figcaption></figure> <figure><img src="/files/m160SsVB4uubroBRg0Mb" alt="" width="375"><figcaption></figcaption></figure></div>

### Publish Your Page

When you're done customizing the portfolio page, click the **Publish** button on the right side to make your portfolio page live.


# Creating a Portfolio Item

Now that your [Portfolio page](/post-types/portfolio/creating-a-portfolio-page) is set up, it's time to dive into creating captivating projects. Whether you're showcasing your latest work, highlighting case studies, or presenting your creative portfolio, Kalium makes it easy to publish and manage your portfolio items.

## Adding new Item

To get started, let's create the portfolio item. Navigate to the WordPress sidebar, go to **Portfolio** -> **Add New Item**.

<figure><img src="/files/WMdO4DdjumZjzLJTJgIH" alt=""><figcaption></figcaption></figure>

1. **Enter the Title**: This is the name that will be displayed for your portfolio item.
2. **Insert Main Content**: Add the primary content for your project. This can include text, images, videos, and other media to showcase your work.
3. **Select Item Type**: Choose the specific type of portfolio item you are creating (e.g., Side Portfolio, Columned, Carousel). This defines how the content will be displayed.
4. **Set a Featured Image**: Upload a featured image that will represent your portfolio item across your site. This image is crucial as it will appear in portfolio listings and other sections of your site.
5. **Select Categories** (optional): Assign your portfolio item to one or more categories to help organize and filter your projects. This is optional but useful for filtering the items.
6. **Select Tags** (optional): Add relevant tags to your portfolio item to enhance searchability and filter options. Tags are also optional but can be helpful for filtering the items.
7. **Click Publish**: Once you’ve completed all the necessary fields, click **Publish** to make your portfolio item live on your website.

The **Project Settings** tabs contain all the settings for configuring your portfolio item. These settings may vary depending on the portfolio type you choose, as each type has its own set of unique options. However, there are also common options that are shared across all portfolio types.

{% hint style="info" %}
Creating a portfolio item involves the use of custom fields, which are managed through the **Advanced Custom Fields Pro** plugin. This plugin is essential for customizing and displaying the content of your portfolio items.
{% endhint %}

## Common Settings

In this section, we will explain the common settings that are relevant to every portfolio item, no matter which **Project Layout** you choose.

### Item Details

Here, you can provide general information about the portfolio item.

<figure><img src="/files/AOrdJNNmUryGtbC31DX1" alt=""><figcaption></figcaption></figure>

* **Subtitle:** A brief, one-line title to describe the item (optional).

### Prev-Next Navigation

Here, you can replace the default links for navigating to the previous or next item in the list, allowing for custom navigation order.

<figure><img src="/files/zY62vUHI7oM0imfea4TQ" alt=""><figcaption></figcaption></figure>

* **Custom Prev-Next Links**: Allows you to override the default previous and next navigation links for this item.
* **Previous Item:** Set the previous item by typing its title from your existing portfolio items.
* **Next Item:** Set the next item by typing its title from your existing portfolio items.
* **Custom Archive URL:** Replaces the default link between the prev and next links, which typically directs users to the portfolio archive page defined in the [Project Page](/post-types/portfolio/project-page#navigation) settings.

### Project Link

Allows you to set a **showcase** link that appears alongside the portfolio content or specify a custom redirect URL, directing users to a different page when they access this item’s single page.

<figure><img src="/files/OxM2xyB069Ubdhw8lsfZ" alt=""><figcaption></figcaption></figure>

* **Launch Link Title:** The text displayed for the link, informing users about the destination or action they are about to take.
* Link URL: The URL users are directed to when clicking the Launch Link. If left empty, the link will not be visible. To disable clicking for this item, enter **#** in this field and select the **Redirect to Link URL (Project URL)** option in **Item Linking**.
* **Link Target:** Choose whether the link should open in a new tab or window when clicked.
* **Item Linking:** Instead of directing users to the default portfolio item single page, you can provide an external URL where users will be redirected (optional).

### Checklists

This feature allows you to list works or services associated with the showcase item. It displays entries in specific structure to the **item type** you choose. You can add one or more items, or leave it empty as it is optional. To add a new checklist, click **New Checklist**. A table with three input fields will be displayed:

<figure><img src="/files/mcv9S3f4Z4nKJxvA1DVT" alt=""><figcaption></figcaption></figure>

* **Checklist Title:** The title that is displayed for the checklist.
* **Checklist:** The works or services listed as names/titles in lines. These are automatically converted into a list format.
* Column Width: This setting determines the width of the columns for displaying checklists within the container. If multiple checklists are present, this setting applies to all of them.

To delete a checklist, hover over the checklist you want to remove and click the “**minus**” sign on the right.

### Featured Video

You can replace the featured image with a video. If the video is set to autoplay, it will play automatically with overlay information visible. If not, users can start the video manually, which may hide the overlay information. The featured video will be shown only on the **Portfolio Page**, not on the single item page.

<figure><img src="/files/e189dxDaOXVFcdOivQAm" alt=""><figcaption></figcaption></figure>

* **Featured Video:** Upload the video material by clicking Add Video and then Add File for the video source.
* **Autoplay:** Automatically starts the video when the portfolio item loads (default). If on, the video will be muted automatically, for [this particular reason](https://developer.chrome.com/blog/autoplay).
* **Controls:** Display video controls (play, pause, etc.) for user interaction.
* **Loop:** Automatically restart the video when it finishes.

### Other Settings

Allows you to further customize your portfolio items with options to set a custom hover background color, select the style of the hover overlay, and define the default state of the overlay—whether it should appear on hover, be hidden on hover, or always be visible.&#x20;

These settings apply specifically to the Project Page (portfolio catalog).

<figure><img src="/files/i6W0vJu8vKL7Y7jNv38a" alt=""><figcaption></figcaption></figure>

* **Custom Hover Background Color**: The color to apply to the hover layer.
* **Hover Effect Style**: Show or hide the entire overlay information, or set a custom style for it.
* **Hover Layer State**: Set the default state for the overlay layer, which can appear on hover, be hidden on hover, or always be visible.

## Setting Up Item Types

With the common settings for portfolio items outlined, we will now explore the detailed settings for each portfolio item type specified in the **Project Layout** tab.

Here are the available item types for the portfolio:

* [**Side Portfolio**](/post-types/portfolio/creating-a-portfolio-item/side-portfolio)
* [**Columned**](/post-types/portfolio/creating-a-portfolio-item/columned)
* [**Carousel**](/post-types/portfolio/creating-a-portfolio-item/carousel)
* [**Zig Zag**](/post-types/portfolio/creating-a-portfolio-item/zig-zag)
* [**Fullscreen**](/post-types/portfolio/creating-a-portfolio-item/fullscreen)
* [**Lightbox**](/post-types/portfolio/creating-a-portfolio-item/lightbox)
* [**Design Your Own**](/post-types/portfolio/creating-a-portfolio-item/design-your-own)


# Side Portfolio

This layout features a horizontal separation between the gallery and the content, creating a side-by-side arrangement. The gallery is displayed alongside the project content, offering a clear distinction between visual and textual information.

<figure><img src="/files/F5VUYYTaTKzARl3APcOv" alt=""><figcaption><p>Side Portfolio item type preview</p></figcaption></figure>

## Side Portfolio Options

After selecting the **Side Portfolio** item type, a new section will appear in **Parameters and Options** called **Side Portfolio**, along with custom **Project Gallery** options:

<figure><img src="/files/7nh7BH9KOcyA9iTinTlM" alt=""><figcaption></figcaption></figure>

These options are specific to this portfolio type and allow further customization of the layout.

### Content Alignment

By default, the content is aligned to the left. To change this, set the **Item Description Alignment** to **Right**. Additionally, you can adjust the width of the content container using the **Item Description Width** setting which be one of the followings: *50% (1/2)*, *33% (1/3)* or *25% (1/4)* of the wrapper container width.

<figure><img src="/files/eKhVDdGaZ73HA5oKT9W0" alt=""><figcaption></figcaption></figure>

### Sticky Description

The description for the item can be set to stick to the top of the viewport, just below the header if it is sticky. Enable the **Sticky Description** option to keep the content aligned with the gallery while scrolling, enhancing the viewing experience.

<figure><img src="/files/YKt5HDTEoDxf6cxxReZB" alt=""><figcaption></figcaption></figure>

### Stretched Gallery Container

For a fullscreen gallery experience, you can stretch the gallery items to the edge of the viewport. Select the **Full Background** option in the **Gallery Type** to enable this feature and make the gallery extend to the full width and height of the viewport:

<figure><img src="/files/oPYnFzy098b9EXFTFDSg" alt="" width="299"><figcaption></figcaption></figure>

The result after enabling stretched gallery:

<figure><img src="/files/k5j93uPipeKG0uSjvVBq" alt=""><figcaption></figcaption></figure>

Please note that this effect is only visible on larger screens; on mobile devices, the gallery will retain its normal behavior.

### Gallery Columns Layout

The gallery columns layout can be adjusted to use Masonry style of positioning items by enabling **Masonry Mode Gallery**. This will align the items and removes any unused gap:

<figure><img src="/files/NgjUuSjBodHEgyOTVEvb" alt=""><figcaption></figcaption></figure>

## Project Gallery

You can customize your Project Gallery with several options, including:

* **Reveal Effect**: Choose the animation or transition effect when gallery items are revealed.
* **Spacing**: Adjust the spacing between items to fit your layout needs.
* **Captions**: Enable or disable captions for gallery images.
* **Items Gap**: Set the gap between items to control the overall look of your gallery.

<figure><img src="/files/AKeAabQvD6vim0ccYFlL" alt=""><figcaption></figcaption></figure>

The Project Gallery section lets you add various media types, including:

* **Single Image**: Display a single image in your gallery. This is ideal for showcasing individual visuals or key elements of your project.
* **Slider Images**: Add a slider containing multiple images. This allows viewers to scroll through a series of images, which is useful for showing different angles or stages of your project.
* **Image Comparison**: Use an interactive slider to compare two images side by side. This is particularly effective for before-and-after shots or contrasting different design options.
* **Video**: Embed videos from platforms like YouTube or Vimeo, or use self-hosted video files. Videos can include project demonstrations, tutorials, or any other relevant content.
* **Text Quote**: Insert a text quote or message. This can be used to highlight key feedback, project descriptions, or significant statements related to your work.
* **HTML Code**: Add custom HTML to include additional elements such as interactive widgets, forms, or any other bespoke features that enhance your gallery.

These options allow you to create a versatile and engaging gallery for each portfolio item, showcasing your work in a dynamic and interactive manner.

To add a gallery item, click **Add New** and select from the available media types:

<figure><img src="/files/6FoR33uJxQtG9A0C6X8K" alt="" width="212"><figcaption></figcaption></figure>

Each gallery item type has its own set of options with inline explanations for their functionality and usage.

{% hint style="info" %}
The **Columned** item type shares the same gallery item options as the **Side Portfolio** type.
{% endhint %}


# Columned

The Columned item type organizes gallery items into columns, forming a grid to showcase gallery content effectively. Similar to the [Side Portfolio](/post-types/portfolio/creating-a-portfolio-item/side-portfolio) type, it shares many common options, but the gallery can be displayed either above or below the content.&#x20;

This layout also supports a centered style where the title and description are text-centered. Additionally, it offers a full-width option for the gallery container and supports a masonry layout for a more dynamic arrangement of gallery items.

<figure><img src="/files/LXPTKWd6Z4ZpSGyCUz2K" alt=""><figcaption><p>Columned item type preview</p></figcaption></figure>

## Columned Options

After selecting the **Columned** item type, a new section will appear in **Parameters and Options** called **Columned**, offering custom **Project Gallery** options for organizing your gallery items into columns.

<figure><img src="/files/cRwSsvAWRvOqAMUv8gJP" alt=""><figcaption></figcaption></figure>

These options are specific to this portfolio type and allow further customization of the layout.

### Content Alignment

You can choose between two layout types: **Default Layout** and **Centered Content Layout**. These can be set in the **Layout Type** option, allowing you to align the content either to the left or center it within the page.

<div><figure><img src="/files/NnsOqJVnLejwXqdpbE96" alt="" width="375"><figcaption><p>Left alignment (Right in RTL)</p></figcaption></figure> <figure><img src="/files/WWo651ZkDDsBxIr7vrCW" alt="" width="375"><figcaption><p>Centered content alignment</p></figcaption></figure></div>

Setting the **Centered Content Layout** also changes the placement of the *checklists* and *project link*.

You can adjust the placement of the content to be either above or below the gallery, and position social network links either before or after the gallery. This can be done by setting Gallery Position to any of these values: *Below description* or *After description*, the same applies for social networks.

### Featured Image

This portfolio item type supports inserting the featured image above the content, with an option for full-width display.

<div><figure><img src="/files/hBJGRbpuE9gWYqgbCDGD" alt="" width="375"><figcaption><p>Featured Image enabled</p></figcaption></figure> <figure><img src="/files/qLbgx4dJToMPa8WpRHsE" alt="" width="375"><figcaption><p>Full width featured image</p></figcaption></figure></div>

### Gallery Columns Layout

The gallery columns layout can be adjusted to use Masonry style by enabling the **Masonry Mode Gallery**. This will align the items and remove any unused gaps:

<figure><img src="/files/22o7l0R5naOdH0tnzVit" alt=""><figcaption></figcaption></figure>

## Project Gallery

You can customize your Project Gallery with several options, including:

* **Reveal Effect**: Choose the animation or transition effect when gallery items are revealed.
* **Spacing**: Adjust the spacing between items to fit your layout needs.
* **Captions**: Enable or disable captions for gallery images.
* **Items Gap**: Set the gap between items to control the overall look of your gallery.

<figure><img src="/files/qOWjGsWRfujWbCVmUlJu" alt=""><figcaption></figcaption></figure>

The Project Gallery section lets you add various media types, including:

* **Single Image**: Display a single image in your gallery. This is ideal for showcasing individual visuals or key elements of your project.
* **Slider Images**: Add a slider containing multiple images. This allows viewers to scroll through a series of images, which is useful for showing different angles or stages of your project.
* **Image Comparison**: Use an interactive slider to compare two images side by side. This is particularly effective for before-and-after shots or contrasting different design options.
* **Video**: Embed videos from platforms like YouTube or Vimeo, or use self-hosted video files. Videos can include project demonstrations, tutorials, or any other relevant content.
* **Text Quote**: Insert a text quote or message. This can be used to highlight key feedback, project descriptions, or significant statements related to your work.
* **HTML Code**: Add custom HTML to include additional elements such as interactive widgets, forms, or any other bespoke features that enhance your gallery.

These options allow you to create a versatile and engaging gallery for each portfolio item, showcasing your work in a dynamic and interactive manner.

To add a gallery item, click **Add New** and select from the available media types:

<figure><img src="/files/6FoR33uJxQtG9A0C6X8K" alt="" width="212"><figcaption></figcaption></figure>

Each gallery item type has its own set of options with inline explanations for their functionality and usage.


# Carousel

The Carousel item type offers a dynamic full-width gallery experience by showcasing images in a carousel format. This layout allows you to feature images in a slideshow that spans the entire width of the page.&#x20;

You can customize various carousel settings to control the display and behavior of the carousel. This layout type supports images only as gallery items.

<figure><img src="/files/FS3uVEIc2azEUDMEDCJJ" alt=""><figcaption></figcaption></figure>

## Carousel Options

Here, you can configure the layout options for the carousel, which can be set to either **Default Layout** or **Centered Content Layout**, apart from other project gallery options.

<figure><img src="/files/3QQxyy5cM4vPJmF86RYY" alt=""><figcaption></figcaption></figure>

### Content Alignment

You can choose between two layout types: **Default Layout** and **Centered Content Layout**. These options allow you to align the content either to the left or center it within the page.

<div><figure><img src="/files/FyA7BHzDUFmMP9XvFzia" alt="" width="375"><figcaption><p>Left alignment (Right in RTL)</p></figcaption></figure> <figure><img src="/files/i3eR69hznOYTTgcdHbjL" alt="" width="375"><figcaption><p>Centered content alignment</p></figcaption></figure></div>

### Carousel Items Alignment

The gallery items can have a starting position that can be either **Left** (default) or **Center**:

<figure><img src="/files/PsXk50gmVvcK4I9KbnKY" alt=""><figcaption></figcaption></figure>

The starting position of gallery items determines the placement of the first image relative to the center of the viewport:

<div><figure><img src="/files/xvBnA7T4vLhL9mnOhgu9" alt="" width="375"><figcaption><p>Left start position</p></figcaption></figure> <figure><img src="/files/C0i17EyKzjKI66l7vGbt" alt="" width="375"><figcaption><p>Center start position</p></figcaption></figure></div>

{% hint style="info" %}
Note that setting **Carousel Start Position** to **Center** and having **Infinite Loop Slides** enabled will not work.
{% endhint %}

## Project Gallery

The **Project Gallery** for the Carousel item type supports images only. The gallery container has the following options:

* **Reveal Effect**: Select the animation or transition effect for revealing gallery items.
* **Spacing**: Adjust the space between images to fit your layout.
* **Captions**: Toggle captions on or off for the gallery images.
* **Maximum Carousel Height**: Set the maximum height for the carousel.
* **Carousel Content Start Position**: Choose to start from the center or left.
* **Loop**: Enable infinite looping of slides.
* **Autoplay**: Set the carousel to autoplay with a specified time interval.
* **Items Gap**: Define the gap between items for the desired visual effect.

<figure><img src="/files/WzDT6TeTnXXGiJ8CawR4" alt=""><figcaption></figcaption></figure>

To insert a new carousel item, click **Add New** and select the **Image** type.&#x20;

Each field contains the information regarding its functionality, making it easy to add and configure your images for the carousel.


# Zig Zag

The Zig Zag item type presents a distinctive layout where content and gallery items alternate in a zigzag pattern, creating a dynamic visual flow. This layout is ideal for showcasing items in a staggered fashion, enhancing visual interest and engagement.

This item type offers similar options to the [Side Portfolio](/post-types/portfolio/creating-a-portfolio-item/side-portfolio) layout, with additional gallery item settings such as description content, width, and alignment.

<figure><img src="/files/VaRQIpMMk1jPDQteT9i7" alt=""><figcaption></figcaption></figure>

## Zig Zag Options

After selecting the **Zig Zag** item type, a new section will appear in **Parameters and Options** called **Zig Zag**, offering custom **Project Gallery** options and layout configurations for this particular item type.

<figure><img src="/files/nFoEVC0NzcIavEsJTcye" alt=""><figcaption></figcaption></figure>

### Content Alignment

You can choose between two layout types: **Default Layout** and **Centered Content Layout**. These options allow you to align the content either to the left or center it within the page.

<div><figure><img src="/files/hIcSkUKcMKTV14Hdl2Vd" alt="" width="375"><figcaption><p>Left alignment (Right in RTL)</p></figcaption></figure> <figure><img src="/files/1cqVFhdz5Ux2hStpfaIK" alt="" width="375"><figcaption><p>Centered content alignment</p></figcaption></figure></div>

## Project Gallery

You can customize your Project Gallery with several options, including:

* **Reveal Effect:** Choose the animation or transition effect when gallery items are revealed.
* **Spacing:** Adjust the spacing between items to fit your layout needs.
* **Captions:** Enable or disable captions for gallery images.
* **Items Gap:** Set the gap between items to control the overall look of your gallery.

<figure><img src="/files/l2OdOXsUPJALpc9qdP0T" alt=""><figcaption></figcaption></figure>

The Project Gallery section supports various media types:

* **Single Image:** Display a single image to showcase individual visuals or key elements of your project.
* **Slider Images:** Add a slider with multiple images for viewers to scroll through different angles or stages of your project.
* **Image Comparison:** Use an interactive slider to compare two images side by side, ideal for before-and-after shots or contrasting design options.
* **Video:** Embed videos from platforms like YouTube or Vimeo, or use self-hosted video files for project demonstrations or other relevant content.
* **Text Quote:** Insert a text quote or message to highlight key feedback, project descriptions, or significant statements related to your work.
* **HTML Code:** Add custom HTML to include additional elements such as interactive widgets, forms, or bespoke features that enhance your gallery.

Zig Zag provides additional details for every gallery item type, including:

* **Description:** Rich text editor for adding detailed descriptions.
* **Width:** Adjust the width of the description.
* **Alignment:** Set the alignment of the description in relation to the gallery media.

To add a gallery item, click **Add New** and select from the available media types.&#x20;

<figure><img src="/files/6FoR33uJxQtG9A0C6X8K" alt="" width="212"><figcaption></figcaption></figure>

Each gallery item type has its own set of options with inline explanations for their functionality and usage.


# Fullscreen

Fullscreen item type offers an immersive viewing experience by allowing the gallery to occupy the entire viewport, creating a strong focus on the visual content. This layout is particularly effective for showcasing high-impact images or videos where every detail matters.

In this layout, the description can be set to be collapsed or expanded by default, or hidden entirely, depending on your preference. It’s fully responsive, ensuring that the same impactful experience is maintained across all devices, including mobile.

## Fullscreen Options

Here, you can adjust the visibility and display of the description and project information. Available options include:

<figure><img src="/files/pKYPYlRwK594bMuKGDg5" alt=""><figcaption></figcaption></figure>

### Content Box State

The content box has three states: *Collapsed*, *Expanded*, or *Hidden*. By default, the content box is Collapsed, but you can set it to *Expanded* using the Item **Description Visibility** option. To hide the content box entirely, enable the **Hide Project Description** option.

<div><figure><img src="/files/yu68a0HfIev2ephlS6LG" alt="" width="375"><figcaption><p>Collapsed content</p></figcaption></figure> <figure><img src="/files/AaKvpyF2xpzlbD3ogR4D" alt="" width="375"><figcaption><p>Expanded content</p></figcaption></figure> <figure><img src="/files/GKzTHbgxyU6lQHRaDGKg" alt="" width="375"><figcaption><p>Hidden content</p></figcaption></figure></div>

You can also customize the text for the expand handle in the **Show Project Info** text field.

## Project Gallery

You can customize your Project Gallery with several options, including:

* **Auto Play:** Set the number of seconds for automatic slide transitions. Leave empty to disable.

<figure><img src="/files/VlaxVpetSoELDOF8zqjI" alt=""><figcaption></figcaption></figure>

The Project Gallery supports images and videos only.

To add a gallery item, click **Add New** and select from the available media types (image or video).

Each gallery item type has its own set of options with inline explanations for their functionality and usage.


# Lightbox

The Lightbox item type displays your media directly in a lightbox view, offering an engaging way to showcase images or videos with overlay effects. Users can view content in a larger, focused format.

This item type is designed to open directly from the [Portfolio Page](/post-types/portfolio/portfolio-page) (portfolio archive) and can also be accessed on a single portfolio item page through portfolio item link.

<figure><img src="/files/NPdJhjahysf9nS5xfcLp" alt=""><figcaption></figcaption></figure>

## Lightbox Options

This type supports both images and videos in lightbox. You can customize the lightbox behavior by displaying the *featured image*, *a custom assigned image*, *a set of images and/or videos*, or *a single video* from sources like *YouTube*, *Vimeo*, or *self-hosted*.

### Featured Image

By default, this item type uses the featured image assigned for the lightbox, requiring no additional configuration.

<figure><img src="/files/jZMP0ZRDkmpf4HGGiuY1" alt=""><figcaption></figcaption></figure>

### Custom Image

This option lets you set a single custom image for the portfolio item. In the [Portfolio Page](/post-types/portfolio/portfolio-page) (portfolio archive), the featured image is displayed, but when the lightbox opens, the image assigned in this field will be shown.

<figure><img src="/files/M3DG2OrXCYstzsGEiq4o" alt=""><figcaption></figcaption></figure>

### Video Content

Shows a video from any supported source (*YouTube*, *Vimeo* or *self-hosted*) in lightbox.

<figure><img src="/files/eZw527QlcCbWCx8TtBtA" alt=""><figcaption></figcaption></figure>

### Mix of Images and Videos

Selecting **Multiple Images and/or Video Gallery** allows you to display multiple media items in the lightbox.

<figure><img src="/files/uq03HkWkApwMI19pntW8" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
The **Browse Mode** option in **Portfolio Page** settings set items chaining behavior for the lightbox. For more [read here ->](/post-types/portfolio/portfolio-page#lightbox-type)
{% endhint %}


# Design Your Own

This layout allows for extensive customization using any page builder of your choice, such as Block Editor, Elementor, or WPBakery. By leveraging these tools, you can design and configure your content directly within the page builder interface, offering a high degree of flexibility and control.&#x20;

This method enables you to craft a unique and tailored presentation for each portfolio item, utilizing the full range of features and widgets provided by your selected page builder.

Unlike other item types, this layout does not come with predefined configuration options in Parameters and Options. Instead, you manage all aspects of the item’s design and functionality through the page builder itself.&#x20;

This approach provides a seamless integration with your chosen builder, allowing you to customize the layout, add content, and apply styles without being constrained by additional settings outside the builder environment.


# WooCommerce

Kalium’s shopping system is built on WooCommerce, the most popular eCommerce plugin for WordPress. With Kalium, you can easily customize your WooCommerce store to match your brand’s style.

Kalium works smoothly with WooCommerce, so you can build the online store you want without hassle. It lets you style your shop, cart, and checkout pages to create a unique shopping experience.&#x20;

In this section, we'll walk you through the basics of setting up WooCommerce, including installation, creating and assigning your shop page, and adding products to your store.

## Installing WooCommerce

Getting WooCommerce up and running with Kalium is easy:

<figure><img src="/files/PfUFJbIjKPb6zBkOdm7j" alt=""><figcaption></figcaption></figure>

1. Go to **Kalium -> Plugins**: In your WordPress dashboard.
2. Locate WooCommerce: Find the WooCommerce plugin in the list.
3. Click the **Install** button, and once the installation is complete it will automatically activate.

## Creating the Shop Page

After you’ve installed WooCommerce, you’ll be prompted to go through the WooCommerce setup guide. This guide will help you configure essential settings and automatically creates the essential pages and other setup like currency, payment methods, and shipping options. It’s a good idea to follow this guide to ensure everything is set up correctly.

However, if you skipped the setup guide or didn’t follow all the steps, you’ll need to manually create and assign your Shop page. Here’s how to do it:

### How to Create the Shop Page

1. Go to **Pages -> Add New Page** in your WordPress dashboard.
2. Name the page "Shop" (or choose another name if you prefer).
3. Click **Publish** to make the page live.

<figure><img src="/files/PPZSdeqlvbfccnL413UO" alt=""><figcaption></figcaption></figure>

### Assigning the Shop Page

1. Go to **WooCommerce -> Settings**.
2. Click on the **Products** tab.
3. In the **Shop page** section, select the page you just created from the dropdown menu.
4. Click **Save changes** to confirm.

<figure><img src="/files/3wRcnynsSoNpre9gBTKP" alt=""><figcaption></figcaption></figure>

This process ensures that WooCommerce knows which page to use as your main shop page where all your products will be displayed. The same process applies to other essential pages like Cart, Checkout, My Account, and others. You can assign these pages in the WooCommerce settings under their respective sections, ensuring that each page functions correctly within your store.

## Adding Products

With WooCommerce installed and your Shop page set up, it’s time to start adding products:

1. Go to **Products -> Add New**
2. **Enter Product Details**:
   * **Product Name**: Give your product a clear, descriptive name.
   * **Product Description**: Add a detailed description in the main content area.
   * **Product Data**: Below the content area, you’ll find the "Product Data" box. Here, you can set the product type (e.g., Simple, Grouped, External, Variable), price, inventory details, shipping information, and more.
   * **Product Short Description**: Add a brief description that will appear next to the product image on the product page.
   * **Product Categories and Tags**: Assign your product to categories and add relevant tags to make it easier for customers to find.
   * **Product Image**: Set a main product image and, if needed, add additional gallery images.
3. Click **Publish**: Once you've filled in all the details, click the "Publish" button. Your product is now live and visible on your Shop page.

For more information on how to add and manage different types of products please refer to the WooCommerce documentation links below:

* [Adding a simple product](https://woocommerce.com/document/managing-products/add-product/#adding-a-simple-product)
* [Adding a Grouped product](https://woocommerce.com/document/managing-products/add-product/#adding-a-grouped-product)
* [Adding an external/affiliate product](https://woocommerce.com/document/managing-products/add-product/#adding-an-external-affiliate-product)
* [Adding a variable product](https://woocommerce.com/document/variable-product/)

## Customizing WooCommerce

To adjust the appearance and style of your WooCommerce store, navigate to **Appearance -> Customize -> WooCommerce**. While the general WooCommerce settings manage functionality and configurations, this section is dedicated to customizing the look and feel of your store. Here, you can fine-tune various design aspects to align with your branding.

<figure><img src="/files/GY5HbxH5WEgtL0nkcfAn" alt=""><figcaption></figcaption></figure>

## Helpful Resources

If you’re new to WooCommerce or want to learn more, check out these resources:

* [**WooCommerce – Official Site**](https://woocommerce.com/): Get the latest updates and information about WooCommerce.
* [**WooCommerce Documentation**](https://docs.woocommerce.com/): Find guides and videos to help you get started.
* [**WooCommerce Guided Tour Videos**](https://woocommerce.com/guided-tour-videos/): Watch how-to videos made by WooThemes to learn about WooCommerce features.
* [**WooCommerce Community Forums**](https://wordpress.org/support/plugin/woocommerce/): Join the community to ask questions and get support.
* [**WooCommerce Built-In Shortcodes**](https://docs.woocommerce.com/document/woocommerce-shortcodes/): See all the shortcodes you can use to customize your store.

With Kalium and WooCommerce, building a great online store is simple and easy.


# General Settings

Customize various aspects of your WooCommerce store's functionality with the options available under **Appearance -> Customize -> WooCommerce -> General Settings**. This section provides you with control over several key features that impact the shopping experience on your site.

<figure><img src="/files/Q5NhsmVk7OEqeRHXaDDR" alt=""><figcaption></figcaption></figure>

* [**Add to Cart Behaviour**](#add-to-cart-behaviour): Set the action that occurs after a product is added to the cart.
* [**Mini Cart**](/post-types/woocommerce/general-settings/mini-cart): Manage the display of the mini cart.
* [**Free Shipping Bar**](/post-types/woocommerce/general-settings/free-shipping-bar): Show a bar on shop pages to inform customers about free shipping.
* [**Product Badge**](/post-types/woocommerce/general-settings/product-badges): Manage the style of product badges.

### Add to Cart Behaviour

Set the action that occurs after a product is added to the cart. This setting determines how your store responds when customers add items to their shopping carts, enhancing their overall shopping experience.

* **None**: No additional action is taken after a product is added to the cart. Customers will remain on the same page, allowing them to continue shopping without interruption.
* **Show Mini Cart**: Displays the mini cart, which provides a quick preview of the items added to the cart. This option can enhance the shopping experience by giving customers immediate feedback about their cart contents and allowing them to view and access their cart without leaving the current page.


# Mini Cart

A mini cart is a great feature that lets users quickly view their cart contents without going away from their current page. Located under **Appearance -> Customize -> WooCommerce -> General Settings**, the **Mini Cart** settings enable you to control how this cart preview appears and behaves, providing a seamless shopping experience.

There are two types of mini cart, and they are:

<figure><img src="/files/ZXk4YpGd4eTumVozqH6e" alt="" width="335"><figcaption></figcaption></figure>

* **Drawer**: Appears as a sliding panel from the side of the page.
* **Popup**: Displays as a pop-up window over the current page.

<div><figure><img src="/files/7m8TJVkkwSCna6ErWXhZ" alt="" width="375"><figcaption><p>Drawer Type</p></figcaption></figure> <figure><img src="/files/RWeGovFHehPpQkelIGbq" alt="" width="375"><figcaption></figcaption></figure></div>

### Options (for Drawer)

* **Animation**: Select the animation style for the drawer’s appearance.
  * **Slide**: The drawer slides into view from the side.
  * **Fade**: The drawer fades in gently.
* **Cart Button**: Toggle the visibility of the "Go to Cart" button within the drawer.
* **Max Width**: Set the maximum width of the drawer, with a range from 300 to 700 pixels.

### Style (for Drawer)

<figure><img src="/files/Gz6rkTYvihLNQM5tEIF4" alt="" width="332"><figcaption></figcaption></figure>

* **Separators**: Choose the color of the separators within the drawer.
* **Background**: Select the background color for the drawer.
* **Headings**: Pick the color for headings in the drawer.
* **Text**: Choose the color for text within the drawer.
* **Padding**: Adjust the inner padding of the drawer, with responsive options to ensure it looks good on all devices.
* **Border**: Define the border style around the drawer, including responsive options.
* **Border Radius**: Set the border radius to create rounded corners, with responsive options available.
* **Box Shadow**: Add a shadow effect to the drawer for a more pronounced appearance.
* **Offset**: Adjust the drawer’s position relative to the edges of the browser window. This includes vertical and horizontal offsets, allowing you to fine-tune where the drawer appears on the screen.


# Free Shipping Bar

The Free Shipping Bar is an effective tool to motivate customers to increase their order size by showcasing how much more they need to spend to qualify for free shipping. This feature, found under **Appearance -> Customize -> WooCommerce -> General Settings**, can be turned on or off and can be strategically placed on different pages to maximize its impact and encourage larger purchases.

<figure><img src="/files/xl5H2OH5Th9y8otLuPfr" alt=""><figcaption></figcaption></figure>

### Setup Instructions

Before the Free Shipping Bar can be displayed, you need to set up a shipping zone in WooCommerce. Follow these steps:

#### Step 1

Navigate to **WooCommerce -> Settings** in your WordPress dashboard.

1. Navigate to **WooCommerce -> Settings** in your WordPress dashboard.
2. Click on the **Shipping** tab.
3. Click **Add shipping zone** and configure the zone details.

<figure><img src="/files/lMwwzeyRz3gIYPrWbpBl" alt=""><figcaption></figcaption></figure>

#### &#x20;Step 2

1. Set up a **Zone Name**, for example "**Worldwide**"
2. Choose a geographical region under **Zone regions**
3. Add a **Shopping method** by clicking the **"Add shipping method**" button

<figure><img src="/files/qDI7kohCJ1lrmFgUlIh0" alt=""><figcaption></figcaption></figure>

#### Step 3

1. Choose a shipping method, in this case choose **Free shipping**
2. Click the "**Continue**" button, to continue to the next step

<figure><img src="/files/Y8xk7YUoGhUrOAOpVxip" alt=""><figcaption></figcaption></figure>

#### Step 4

1. Name the shipping method, we've chosen "Free Shipping"
2. Choose when to apply the free shipping, we've chosen "**A minimum order amount**" to spend to get a free shipping.
3. Set a **Minimum order amount**, e.g. $150
4. Click "**Create and save**" to finalize.

<figure><img src="/files/lXWOqicMLeRns1yCifvp" alt=""><figcaption></figcaption></figure>

Now that you’ve created the shipping zone in WooCommerce, you can proceed with customizing the Free Shipping Bar. The options for configuring its appearance and messages are detailed below.

### Free Shipping Bar Options

Now that you’ve added free shipping zones in WooCommerce, you can configure the Free Shipping Bar to enhance its visibility and impact. The options are located under **Appearance -> Customize -> WooCommerce -> General Settings**, you can turn it on or off from there directly . The options for customization are explained below.&#x20;

<figure><img src="/files/fiXTO1n3tPwbfilx1H7F" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/oJntpdcrcDYDASP3TRry" alt="" width="336"><figcaption><p>Free Shipping Bar options in Customizer</p></figcaption></figure>

#### Locations to Show

Select where you want the Free Shipping Bar to appear on your site. You can choose multiple locations to maximize its visibility:

* **Mini Cart Drawer**: Displays the bar in the mini cart drawer.
* **Cart Page**: Shows the bar on the cart page.
* **Checkout Page**: Appears on the checkout page.
* **Product Page**: Visible on individual product pages.

#### Initial Message

Enter a custom message to prompt customers to spend more to qualify for free shipping. For example, "Spend $50 more to enjoy free shipping."

#### Qualified for Free Shipping Message

Enter a message to congratulate customers who meet the free shipping threshold. For example, "Congratulations! You qualify for free shipping."

#### Available Shortcodes

Use shortcodes to personalize the messages:

* `[amount_left]` Displays the amount remaining to reach the free shipping threshold.
* `[min_amount]` Shows the minimum amount required to qualify for free shipping.


# Product Badges

Customize these badges to fit your store's design and effectively draw attention to important product details. You can find these settings under **Appearance -> Customize -> WooCommerce -> General Settings -> Product Badge**, the options are explained below.

<figure><img src="/files/dUsoISvUbCmS3EtJYcSY" alt=""><figcaption></figcaption></figure>

## Badge Style

Customize the appearance of your product badges by selecting from the following styles:

<figure><img src="/files/3HLJOl2TXNLbPx2tKDrc" alt="" width="340"><figcaption></figcaption></figure>

#### Normal

A standard badge shape.

* **Upper Case**: Toggle this option to automatically convert badge text to uppercase.
* **Outline**: Toggle to switch between an outlined version or a filled badge.

<div><figure><img src="/files/kneg6NNGxo8onkGxsoxZ" alt="" width="334"><figcaption><p>Default Badge</p></figcaption></figure> <figure><img src="/files/eNoohcYNo7IFC9OLI4gJ" alt="" width="336"><figcaption><p>Outlined Badge</p></figcaption></figure></div>

#### Circle

A circular badge style.

* **Upper Case**: Toggle this option to automatically convert badge text to uppercase.
* **Size**: Adjust the size range of the badge.
* **Radius**: Set the border radius for a more rounded badge.
* **Fixed Size**: Toggle to maintain a fixed size, preventing the badge from resizing with text. This is particularly useful for badges with longer texts, such as "Out of stock."

#### Triangle&#x20;

A triangular badge that can be used on the edges of the image.

* **Upper Case**: Toggle this option to automatically convert badge text to uppercase.
* **Size**: Adjust the size range for the badge.

### Sale Badge

Options related only to the sale badge

<figure><img src="/files/q759G9ck4IXgAxv7UA7e" alt="" width="338"><figcaption></figcaption></figure>

**Show as Percentage**: Toggle this option to display the sale discount as a percentage instead of the default "SALE!" text. This provides a clear view of the discount offered.

Here is an example of how they look:

<div><figure><img src="/files/LbHOrWiO5XJngIi6FHNY" alt="" width="72"><figcaption><p>Sale Badge With<br>Percentage  </p></figcaption></figure> <figure><img src="/files/Gy1PE1tLpVTJbyunGmqY" alt="" width="74"><figcaption><p>Default WooCommerce <br>Sale Badge</p></figcaption></figure></div>

## Enabled Badges

Select which badges you want to display on your products:

<figure><img src="/files/F7JA3iXhAfqeYNPOumri" alt="" width="334"><figcaption></figcaption></figure>

* **Sale**
* **Featured**
* **Out of Stock**
* **Backorder**

## Style

Customize the colors for each badge type:

<figure><img src="/files/8H9P4FXdPpT0GcCtMBwn" alt="" width="349"><figcaption></figcaption></figure>

* **Sale**: Choose the text color and background color for sale badges.
* **Featured**: Select the text color and background color for featured product badges.
* **Out of Stock**: Adjust the text color and background color for out-of-stock badges.


# Product Catalog

Customizing the appearance and style of your shop page is essential for creating a visually appealing and user-friendly online store. The Product Catalog settings in WooCommerce allow you to control many aspects of how products are shown on your shop page. You can find these settings under **Appearance -> Customize -> WooCommerce -> Product Catalog**.

## Layout

<figure><img src="/files/TEqn3huTs8yAYfvu1bHr" alt="" width="338"><figcaption></figcaption></figure>

Choose between two main layout styles for displaying your products:

* Grid
* List

#### Products per Page

Set the number of products to display per page for the **Grid** layout

#### Product Columns

Adjust the number of columns for the grid layout. This option is responsive, allowing you to configure different column numbers for various device sizes.

#### Masonry Mode

Enable this mode to position product blocks based on available vertical space rather than static rows, creating a more dynamic and visually engaging layout.

## Card

A product card is the visual representation of a product in your catalog. It showcases essential details like the product image, title, price, and other optional information you may wish to include. There are two types of product cards available:

* [**Grid Product Card**](/post-types/woocommerce/product-catalog/product-card#grid-product-card)
* [**List Product Card**](/post-types/woocommerce/product-catalog/product-card#list-product-card)

For a comprehensive guide on each type of product card and detailed customization options, refer to the dedicated article available through the links below.

{% content-ref url="/pages/vNPeX99MPLLlTDHaQJOp" %}
[Product Card](/post-types/woocommerce/product-catalog/product-card)
{% endcontent-ref %}

## Page Heading

Manage what appears in the page heading:

### Breadcrumb

Toggle to show or hide the breadcrumb navigation.

<figure><img src="/files/kvg8cduSJFsQ2nnmtPyQ" alt=""><figcaption></figcaption></figure>

### Page Title

Toggle to show or hide the page title.

<figure><img src="/files/9vhe4yak5xoVOTTr5OQz" alt=""><figcaption></figcaption></figure>

### Results Count

Toggle to show or hide the number of products found.

<figure><img src="/files/PX0gLDwY4rS8JaXR8X8f" alt=""><figcaption></figcaption></figure>

### Columns Switcher

Toggle to enable a switcher that allows users to switch between different views. You can specify which options are available in the switcher:

* List
* Grid columns 2
* Grid columns 3
* Grid columns 4
* Grid columns 5
* Grid columns 6

<div><figure><img src="/files/jhUnLA20y9KuARxAeb3V" alt="" width="375"><figcaption><p>Step 1</p></figcaption></figure> <figure><img src="/files/ACvpBSfAIxwDbrcXAYSq" alt="" width="375"><figcaption><p>Step 2</p></figcaption></figure></div>

### Sorting Dropdown

Toggle to show or hide the sorting dropdown menu for filtering products.

## Options

The "Options" section provides additional customization settings to refine the appearance and functionality of your shop page. This section includes settings for the sidebar, catalog mode, and pagination.

### Sidebar

Configure the visibility and placement of the sidebar on your shop page. You can choose to display or hide the sidebar, or adjust its position to fit your design needs. To turn on the sidebar simply switch the toggle to on and then it will become a section which you can click:

<figure><img src="/files/eT0ZYRpBNbEqgjK81ql9" alt=""><figcaption></figcaption></figure>

#### Sidebar Alignment

Choose the alignment of the sidebar:

<figure><img src="/files/Dcejb8glUhqQscROZsaV" alt="" width="344"><figcaption></figcaption></figure>

* **Left**: Position the sidebar on the left side of the Shop Page.
* **Right**: Position the sidebar on the right side of the Shop Page.

<figure><img src="/files/VGUymVLuVRIPk7vh5PEJ" alt=""><figcaption></figcaption></figure>

#### Sidebar Toggle

This feature provides a convenient way to manage the visibility of the sidebar based on user preferences, it will show a toggle button to show and hide the shop sidebar. Ideal for large shops, it allows users to filter products without navigating away from their current page.

<figure><img src="/files/ISb1o2zkTDGSsEd5OiIy" alt=""><figcaption></figcaption></figure>

#### Toggle Action

You can choose how the sidebar should behave when the toggle is activated:

* Sidebar
* Off-Canvas

<div><figure><img src="/files/aObb1Hc7ZL46OmFD8VCe" alt=""><figcaption><p>Sidebar</p></figcaption></figure> <figure><img src="/files/COvCJAeOhlD7hgG4NIuV" alt=""><figcaption><p>Off-Canvas</p></figcaption></figure></div>

#### Sidebar Type

This option keeps the sidebar in its default position on the page, with the following settings:

* **Default State**: Determine the sidebar's initial state:
  * **Hide Sidebar**: The sidebar will be hidden by default.
  * **Show Sidebar**: The sidebar will be visible by default.
* **Animate Sidebar**: Enable this toggle to animate the sidebar's visibility when the filter is turned on or off, creating a smooth transition effect.

#### Off Canvas Type

This option moves the sidebar off the main page area, allowing it to slide in and out as needed:

* **Off-Canvas Title**: Set a custom title, such as "Filter Products," for the off-canvas sidebar, providing context to users about what the sidebar contains.

<figure><img src="/files/iz3kGUtRxwhVISw2E7gT" alt=""><figcaption></figcaption></figure>

#### Toggle Button Text

Customize the text for the buttons that control the sidebar toggle:

* **Show**: Input the text that will appear on the button when the sidebar is hidden and the user can click to show it.
* **Hide**: Input the text that will appear on the button when the sidebar is visible and the user can click to hide it.

<figure><img src="/files/RaXzEioJErQn5m7jjk7U" alt=""><figcaption></figcaption></figure>

#### Sidebar Widgets

The easiest and fastest way to manage your sidebar widgets is by clicking the **"Sidebar Widgets"** link within the customization options. This link will redirect you directly to the widget management area, where you can add, remove, or rearrange widgets with ease.

If you’re looking for more detailed instructions on adding widgets to your sidebar, or if you encounter any issues, please check the [adding widgets to the sidebar guide](/general/sidebars/troubleshooting-sidebar#adding-widgets-to-your-sidebar). This guide provides step-by-step instructions and troubleshooting tips to ensure your sidebar is set up exactly as you need.

{% hint style="info" %}
For additional styling and customization of the sidebar, you can adjust the global sidebar settings located under **Appearance -> Customize -> Sidebars**. This area allows you to manage the overall look and feel of sidebars across your site, check the [sidebar styling article](/general/sidebars).
{% endhint %}

### Catalog Mode

Enable catalog mode to transform your shop into a product catalog. When activated, catalog mode hides the cart and checkout functionalities, including the "Add to Cart" buttons. This mode is ideal for sites that wish to display products without facilitating online purchases, offering a streamlined browsing experience focused solely on product showcasing. It has the following options

* **Catalog Mode** - Toggle to turn on or off the catalog mode.
* **Hide Prices** - When switched on, the prices will hide from the products all over the site.&#x20;

<div><figure><img src="/files/OuETsIfn2hCOymPp62qi" alt=""><figcaption></figcaption></figure> <figure><img src="/files/iz3kGUtRxwhVISw2E7gT" alt=""><figcaption></figcaption></figure></div>

### Pagination

Customize how pagination appears on your shop page. You can choose from different pagination styles and control how many products are shown per page. This setting helps manage the navigation and display of products, making it easier for customers to browse through your catalog.

* [**Numbers**](#numbers)
* [**Load More**](#load-more)

#### Numbers

Display numbered pagination for navigation.

<figure><img src="/files/4DwLtH0QvYnvMvKVIFFG" alt="" width="333"><figcaption></figcaption></figure>

#### Display Type

* **Numbers**: Show only page numbers.
* **Numbers + Previous/Next**: Display page numbers along with Previous and Next buttons for easier navigation.
* **Previous/Next**: Show only Previous and Next buttons.

***

#### Load More

Use a button to load more posts as users scroll down the page.

<figure><img src="/files/t9L2k1Ixsklmhnmp9cYR" alt="" width="335"><figcaption></figcaption></figure>

* **Infinite Scroll**: Toggle this to enable or disable infinite scrolling, where more posts load automatically as users scroll down the page.
* **Loading Effect**: Choose a loading effect to display while new posts are being fetched:
  * **Spinner**: A spinning icon indicating loading.
  * **Pulsate**: A pulsating effect indicating loading.

***

#### Alignment

Set the alignment of pagination controls for both types:

<figure><img src="/files/2VMeWnvaK3TQkLRkKdSr" alt="" width="332"><figcaption></figcaption></figure>

* **Left**: Align pagination controls to the left.
* **Center**: Center-align pagination controls.
* **Right**: Align pagination controls to the right.
* **Space Between**:  Distribute space between items (Available only for Numbers type)

## Category Box

The Category Box settings allow you to manage the appearance of product categories on your shop page. Before configuring these options, ensure you have set up product categories and enabled them on the Shop page under **Shop page display**. The columns of categories is inherited from the Product Columns, for example if you have set 2 product columns per row it will show 2 categories per row also, as seen in the image below.

<figure><img src="/files/1EyPMwvdrpcWOilZy087" alt=""><figcaption></figcaption></figure>

### Category Box Types

Choose from six different styles for displaying categories:

* **Type 1**: Title and text inside the image box, bottom left.
* **Type 2**: Title and text inside the image box, center.
* **Type 3**: Title and text inside the image box, top left.
* **Type 4**: Title and text outside the image box, bottom left.
* **Type 5**: Title and text outside the image box, center.
* **Type 6**: Title and text inside the image box with a background, center.

This is how they look live in your site:

<div><figure><img src="/files/gIAEcdWCxv7uyhnIs82J" alt="" width="188"><figcaption><p>Type 1</p></figcaption></figure> <figure><img src="/files/NfpFu1kyvMbt1oLEZyBJ" alt="" width="188"><figcaption><p>Type 2</p></figcaption></figure> <figure><img src="/files/tI3oAAx6Ebcse0rwk35W" alt="" width="188"><figcaption><p>Type 3</p></figcaption></figure></div>

<div><figure><img src="/files/rWnPOW99p1JPDJwQPVxw" alt="" width="188"><figcaption><p>Type 4</p></figcaption></figure> <figure><img src="/files/x27MgNiYDEC3NJtgQGZ0" alt="" width="188"><figcaption><p>Type 5</p></figcaption></figure> <figure><img src="/files/jNh1viItpxHOzNJcedbs" alt="" width="188"><figcaption><p>Type 6</p></figcaption></figure></div>

### Additional Options

* **Show Count**: Toggle this option to display the number of products within each category.
* **Separate Categories**: Shows only when "**Show products & categories**" is selected under  [**Shop Page Display**](#shop-page-display), toggle this option to separate categories from products into different sections, see examples below:

<div><figure><img src="/files/3bD8gwVTxXissi1x5QUL" alt="" width="375"><figcaption><p>Separate Categories Turned Off<br>By default categories show next to products</p></figcaption></figure> <figure><img src="/files/KOVMnJckb7ds34hsou7i" alt="" width="375"><figcaption><p>Separate Categories Turned On<br>Categories showing in a separate row from products</p></figcaption></figure></div>

#### Shop Page Display

Customize what appears on your main shop page with the following options:

* **Show Products**: Display only products on the shop page.
* **Show Categories**: Display only product categories.
* **Show Categories & Products**: Display both product categories and products.

<div><figure><img src="/files/nNMwmGHbfeUOcYLoGIj4" alt="" width="375"><figcaption><p>Show Products</p></figcaption></figure> <figure><img src="/files/8ySocjjpbcBUI0cGS5kZ" alt="" width="375"><figcaption><p>Show Categories</p></figcaption></figure> <figure><img src="/files/re4CNen4Fdfw3jzjvRkM" alt="" width="375"><figcaption><p>Show Categories &#x26; Products</p></figcaption></figure></div>

#### Category Display

Manage how product category pages are displayed:

* **Show Products**: Display products within each category.
* **Show Subcategories**: Display subcategories within each category.
* **Show Subcategories & Products**: Display both subcategories and products within each category

#### Default Product Sorting

Set the default sorting order for products in the catalog:

* **Default Sorting (Custom Ordering + Name)**: Sort products based on custom ordering and name.
* **Popularity**: Sort products by popularity.
* **Average Rating**: Sort products by average rating.
* **Newest**: Sort products by newest first.
* **Price (Low to High)**: Sort products by price from lowest to highest.
* **Price (High to Low)**: Sort products by price from highest to lowest.


# Product Card

A product card serves as the visual representation of a single product in your catalog. It acts as an individual element designed to be duplicated and displayed in a repeating loop throughout your product listings. Each card typically showcases key information, including the product image, title, price, and any other details you choose to include. There are two distinct types of product cards:

<div><figure><img src="/files/IVo3JeoLNgaP8BCOIrvb" alt="" width="375"><figcaption><p>Grid Product Card</p></figcaption></figure> <figure><img src="/files/cilwi1vSJdWR9uiWp9k5" alt="" width="375"><figcaption><p>List Product Card</p></figcaption></figure></div>

### Grid Product Card

This layout is used when you select the Grid type in your catalog settings. It organizes products in a neat, grid-like arrangement, making it perfect for showcasing multiple items in an attractive and orderly fashion.&#x20;

<figure><img src="/files/79yFsfuhCve7iX3rWBRT" alt=""><figcaption></figcaption></figure>

The Grid Product Card offers two distinct tabs for customization:

* **Templates Library**: Choose from a variety of pre-designed grid templates included with the theme, or modify any of them.
* **User Templates**: Create custom grid layouts or modify existing ones, the modified pre-made templates will show under this list here.

<figure><img src="/files/tmjySTV2dV6QD4LIIclN" alt=""><figcaption><p>Templates tab</p></figcaption></figure>

### List Product Card

Style and design the appearance of product cards in the list view.

<figure><img src="/files/0PHgZgdSuMluwOzMMnPt" alt=""><figcaption></figcaption></figure>

List Product Card offers two tabs for customization:

* **Templates Library**: Choose from a variety of pre-designed list templates included with the theme, or modify any of them.
* **User Templates**: Create custom list layouts or modify existing ones, the modified pre-made templates will show under this list here.

<figure><img src="/files/PfSZnFncN6eH7KKhqi4t" alt=""><figcaption></figcaption></figure>

### Creating a Custom Template

If you want to create your own custom template instead of using any of the pre-made templates, or if you’re editing an existing template, follow these steps. Below, each element available for customization is explained in detail.

#### 1. Access the User Templates Tab

Start by accessing the **User Templates** tab under the Grid Product Card or List Product Card section.

<figure><img src="/files/U89oMZlC2cWPXjxU5kjk" alt=""><figcaption></figcaption></figure>

#### 2. Click + Add Button

Click the **+ Add** button to begin creating your custom template. Each time you want to add a new element, you'll need to click the **+ Add** button again.

<figure><img src="/files/Ur9SeIOREgr62gqug7QZ" alt=""><figcaption></figcaption></figure>

#### 3. Add Elements to Your Template

Select and add elements such as **Row**, **Title**, **Image**, and **Price** to build your template. Remember, once an element is added, it will be automatically hidden from the elements list, as it cannot be added twice (except for rows). You can drag and drop elements to nest them, reorder them, or adjust their layout.

<figure><img src="/files/MSf8gwL7hZkDqJUVYMtC" alt="" width="329"><figcaption></figcaption></figure>

#### 4. Name and Save Template

In this example, we used three simple and crucial elements: **Image**, **Title**, and **Price** to create an effective product card layout. Once you’ve arranged all the elements, provide a name for your template. This will help you easily identify it later. After naming your template, save it to ensure your work is not lost.&#x20;

<figure><img src="/files/h8fHIQk97aGBcbFQ4rEH" alt=""><figcaption></figcaption></figure>

#### 5. Publish Changes

Finally, publish the changes in the customizer to view your new template live on your site.

<figure><img src="/files/6ONriInwJOTttfo92ZAg" alt=""><figcaption></figcaption></figure>

Each template has the following options shown as icons

* Duplicate
* Customize
* Delete

## Product Card Elements

When customizing your product card, you have a variety of elements to choose from. These elements allow you to tailor the card to suit your design needs. Some elements can be expanded to include additional items, giving you greater flexibility in how you display your products.

#### Elements

* **Row** (Nestable)
* **Title**
* **Image** (Nestable)
* **Price**
* **Add to Cart**
* **Sale Badge**
* **Description**
* **Category**
* **Attribute**
* **Wishlist**
* **Swap on Hover** (Nestable)
* **Hover Block** (Nestable)

#### Element Options

When working with product card elements, each one offers various options to customize and manage your layout. Regardless of the element type, you will encounter three core options:

* **Expand/Collapse** (applicable only to Nestable elements): This option allows you to expand or collapse the element to view or hide its nested content.&#x20;
* **Options**: This provides additional settings specific to the element you are working with.
* **Remove**: Use this to remove any unwanted elements from the template.

<figure><img src="/files/OFURSOS6hP91BHzJNSYV" alt=""><figcaption><p>Element Options: <strong>Expand/Collapse</strong>, <strong>Options</strong> and <strong>Remove</strong></p></figcaption></figure>

You can also drag and drop elements to reorder them or add new elements within nested components.&#x20;

***

### Element Tabs

Each product card element comes with three specific tabs when clicking the options icon <img src="/files/xEFhuMtqdEdjw5VtRijF" alt="" data-size="line"> in the top right area, with the availability of tabs varying by element type:

* Content
* Style
* Advanced

Below is an example of all three tabs of one of the elements:

<div><figure><img src="/files/CwkaUXHYbJscFCjBEuKs" alt="" width="284"><figcaption><p>Content tab</p></figcaption></figure> <figure><img src="/files/RjK86yt9X4r4hqYARYXm" alt="" width="284"><figcaption><p>Style tab</p></figcaption></figure> <figure><img src="/files/ahZHTni0QB2q1VmYhJCq" alt="" width="284"><figcaption><p>Advanced tab</p></figcaption></figure></div>

Here’s a brief overview of what you can expect from each:

#### Content Tab

Allows you to manage the core content of the element. This includes adding or editing text, images, and other media. Explore the options in this tab to customize what appears in each element.

#### Style Tab

Provides options to adjust the visual appearance of the element. You can change fonts, colors, backgrounds, and other stylistic details to match your design preferences. Check out the available styling options for each element below.

#### Advanced Tab

Offers comprehensive customization for fine-tuning the element’s layout and behavior. Here’s a breakdown of the options available:

**Layout**

* **Margin**: Adjust the space around the element.
* **Padding**: Set the space inside the element’s border.
* **Position**: Choose between Default, Absolute, or Relative positioning.
  * **Position Offset**: Available when Absolute is selected; adjust the element’s offset from its position.
* **Overflow**: Control content overflow with options like Default, Auto, Visible, Scroll, Hidden, Hidden X, or Hidden Y.
* **CSS Classes**: Add custom CSS classes to the element.

**Visibility**

* **Visibility**: Set to Always, Hover, or Hidden.
  * **Hover Options**:
    * **Hover Animation**: Choose from None, Fade, Fade Up, Fade Down, Fade Left, Fade Right, Scale Up, Scale Down, Slide Up, Slide Down, Slide Left, or Slide Right.
    * **Animation Duration**: Select Normal, Slow, or Fast.
    * **Animation Delay**: Input delay time in milliseconds (MS).

**Border**

* **Border**: Customize the border color and width.
* **Border Radius**: Adjust the corner rounding of the border.

**Text**

* **Font Size**: Set the size of the text.
* **Text Align**: Choose Global, Left, Center, or Right alignment.
* **Text Transform**: Select from Global, Uppercase, Lowercase, or Capitalized text transformation.

**Dimensions**

* **Width**: Specify the width of the element.
* **Height**: Specify the height of the element.
* **Min Width**: Set the minimum width.
* **Min Height**: Set the minimum height.

**Custom CSS**

* **Custom CSS**: Write your own CSS rules for the element. Use `#self` to target the wrapper element.

Each tab and its options allow you to fully customize and control the appearance and behavior of your product card elements.

***

### Row

Define the structure and spacing of rows in your template. You can add other elements inside the row to organize your layout. Each row contains a single element: **Column**. The column can hold all other elements.

<div><figure><img src="/files/CwkaUXHYbJscFCjBEuKs" alt=""><figcaption><p>Content Tab</p></figcaption></figure> <figure><img src="/files/RjK86yt9X4r4hqYARYXm" alt=""><figcaption><p>Style Tab</p></figcaption></figure> <figure><img src="/files/8SYkibIypyAMmqPljhzD" alt=""><figcaption><p>Row when expanded</p></figcaption></figure></div>

### Title

Display the product title within the card.

<figure><img src="/files/LwDGTcEEGYsdgd7jzO9h" alt="" width="284"><figcaption></figcaption></figure>

### Image

Add the product image to your layout. You can also include additional elements inside the image, similar to how you can customize the row.

<div><figure><img src="/files/hcta7Ct7A9tYunr5pXtl" alt="" width="293"><figcaption></figcaption></figure> <figure><img src="/files/JlzBP49GYXdHiVNzEmsy" alt="" width="284"><figcaption></figcaption></figure></div>

### Price

Show the product price in the card.

### Add to Cart

Include an "Add to Cart" button for quick purchasing.

<div><figure><img src="/files/r1sntCQ1dgeYlPxmh6qB" alt="" width="284"><figcaption><p>Content tab</p></figcaption></figure> <figure><img src="/files/xejqhSJfuDO8k91XB7nO" alt="" width="284"><figcaption><p>Style tab</p></figcaption></figure></div>

### Sale Badge

Feature a badge to indicate discounted items.

<figure><img src="/files/Mkq6SiffDwpnBRa08Mkq" alt="" width="284"><figcaption></figcaption></figure>

### Description

Provide a brief product description.

<div><figure><img src="/files/tecTqapU6WkgKOc1Tojk" alt="" width="284"><figcaption><p>Content tab</p></figcaption></figure> <figure><img src="/files/l6vUWb7DUGTDSrKn3szP" alt="" width="284"><figcaption><p>Style tab</p></figcaption></figure></div>

### Category

Display the product category within the card.

<figure><img src="/files/b2QLHWglvKmio5q6AaUD" alt="" width="284"><figcaption></figcaption></figure>

### Attribute

Show specific product attributes.

<figure><img src="/files/HzjMEjKDHGhw8OLBd6kT" alt="" width="284"><figcaption></figcaption></figure>

### Wishlist

Add an option for users to save products to their wishlist.&#x20;

<div><figure><img src="/files/6EVPm4BWoew7QUAPVGda" alt="" width="284"><figcaption><p>Content tab</p></figcaption></figure> <figure><img src="/files/6YWYL8C2SN1eAYFPWmow" alt="" width="284"><figcaption><p>Style</p></figcaption></figure></div>

{% hint style="info" %}
This element requires the **YITH Wishlist** plugin to be installed and activated in order to be used in the custom card template.
{% endhint %}

### Swap on Hover

Enable a feature to swap content when hovering over the card.&#x20;

The suppported elements that can be swapped on hover are:

* Title
* Price
* Add to Cart
* Category
* Attribute

<div><figure><img src="/files/5SKBNAGEV6Cp3IxtKDpp" alt="" width="293"><figcaption><p>Swap on Hover when Expanded</p></figcaption></figure> <figure><img src="/files/MOhGQYi381IC8l963M6Y" alt="" width="294"><figcaption><p>Available Elements</p></figcaption></figure> <figure><img src="/files/FHNuDucGX70zinKQ8vhn" alt="" width="284"><figcaption><p>Content tab</p></figcaption></figure></div>

### Hover Block

Customize the block that appears on hover. It functions similarly to the row, allowing you to add any elements inside it, but includes special effects triggered by hovering.

<div><figure><img src="/files/pUxYYWe93vsz2YedAgkp" alt="" width="293"><figcaption><p>Hover Block when Expanded</p></figcaption></figure> <figure><img src="/files/oh4eJxSZifmWdqKA7UAe" alt="" width="284"><figcaption><p>Style tab</p></figcaption></figure></div>


# Product Page

Located under **Appearance -> Customize -> WooCommerce -> Product Page**, this section allows you to design various aspects of your product page to meet your specific needs. From image dimensions to gallery layouts and additional features, you have control over how your products are presented.

## Product Image Width

Determine how wide the product image should be displayed on the product page:

<div align="center"><figure><img src="/files/vVSDnS9wQ9SsyNHIbkNL" alt="" width="327"><figcaption></figcaption></figure></div>

* **Small**: A compact image size that conserves space.
* **Medium**: A balanced option that provides moderate visibility.
* **Large**: Enlarges the image to highlight products more prominently.
* **Container Width**: Expands the image to fill the width of its container.
* **Full Width**: Stretches the image across the entire width of the page for a full-screen effect.

<div><figure><img src="/files/56BLHIAYtZhVP8Jgx3M6" alt="" width="375"><figcaption><p>Small</p></figcaption></figure> <figure><img src="/files/LZxFNXAkYmwaYwVW8eE4" alt="" width="375"><figcaption><p>Medium</p></figcaption></figure> <figure><img src="/files/abZPQ4ki4PS7g6ZUzEKp" alt="" width="375"><figcaption><p>Large</p></figcaption></figure></div>

<div><figure><img src="/files/Qwsvjp4cCuDNJd06AtDf" alt="" width="375"><figcaption><p>Container Width</p></figcaption></figure> <figure><img src="/files/6Jp1mB4BnRLd4d6OVWH9" alt="" width="375"><figcaption><p>Full Width</p></figcaption></figure></div>

#### Flip Horizontally

Inverts the layout by moving the image to the right and content to the left.

<figure><img src="/files/XHYAhRHmarfE1U47myge" alt=""><figcaption></figcaption></figure>

#### Sticky Description

Keeps the description area visible and sticky while scrolling through the gallery.

<figure><img src="/files/uu6L83KSxJ3bBcFxB5xi" alt=""><figcaption></figcaption></figure>

#### Gallery / Summary Gap

Sets the gap between the gallery and summary containers, with responsive controls for different device sizes. Note: This option does not apply to **Container Width** and **Full Width** types.

<figure><img src="/files/iIvkrKDh9JtXlG11mlgo" alt=""><figcaption></figcaption></figure>

## Gallery

Customize the layout and behavior of your product image gallery:

<div align="center"><figure><img src="/files/bsQIsXmJLEYZRYA2bIkN" alt="" width="325"><figcaption></figcaption></figure></div>

* **Thumbnails Bottom**: Displays thumbnail images below the main product image.
* **Thumbnails Right**: Places thumbnails vertically on the right side of the main image.
* **Thumbnails Left**: Aligns thumbnails vertically on the left side.
* **Grid 1**: Organizes gallery images in a single-column grid.
* **Grid 2**: Arranges images in a two-column grid, below the featured image.
* **Grid 3**: Shows images in a mixed column grid (1/2/1).
* **Grid 4**: Formats images in a two-column grid.
* **Simple**: Presents images without additional thumbnails.
* **Carousel**: Features a rotating carousel of product images.

<div><figure><img src="/files/VdgeORDdN7oGk5rrUHXt" alt="" width="375"><figcaption><p>Thumbnails Bottom</p></figcaption></figure> <figure><img src="/files/gIyk3HrvHzlQOe1YdU5h" alt="" width="375"><figcaption><p>Thumbnails Left</p></figcaption></figure> <figure><img src="/files/d9iED1KQGcnMCGyELRFN" alt="" width="375"><figcaption><p>Thumbnails Right</p></figcaption></figure></div>

<div><figure><img src="/files/un38gPbPOGQIBmUWL4h6" alt="" width="375"><figcaption><p>Grid 1</p></figcaption></figure> <figure><img src="/files/SLTmOsZPPsE61sCL9MIk" alt="" width="375"><figcaption><p>Grid 2</p></figcaption></figure> <figure><img src="/files/kFaLTMg6JxVNpcIWPLi7" alt="" width="375"><figcaption><p>Grid 3</p></figcaption></figure> <figure><img src="/files/SMzlLsL7722GMPnNd9db" alt="" width="375"><figcaption><p>Grid 4</p></figcaption></figure></div>

<div><figure><img src="/files/G7KHlM8Z4P0PfggJZJK7" alt="" width="375"><figcaption><p>Simple</p></figcaption></figure> <figure><img src="/files/UXzKd6AbudcW8pK6U656" alt="" width="375"><figcaption><p>Carousel</p></figcaption></figure></div>

#### Gallery Options

* **Enlarge Icon**: Toggle to show or hide the icon that allows users to enlarge images.
* **Mouse/Touch Behaviour**: Choose the action triggered by clicking or touching an image:
  * **Zoom/Lightbox**: Decide between zooming into the image or opening it in a lightbox.
* [**Gap**](#user-content-fn-1)[^1]: Set the space between gallery images. This option has responsive controls for various device sizes and applies to all gallery types except Simple.
* **Max Items**: Limit the number of images shown in the gallery or select "All" to display every image.
* [**Gallery Auto Play**](#user-content-fn-2)[^2]: Enter the interval (in seconds) for automatic image rotation.
* [**Navigation**](#user-content-fn-2)[^2]: Choose between **Arrows**, **Dots**, or both for navigation controls.
* [**Animation**](#user-content-fn-2)[^2]: Select **Slide** or **Fade** for image transitions.
* [**Carousel Thumbnails**](#user-content-fn-3)[^3]: Enable carousel view for thumbnails.
  * **Auto Thumbnails per View**: Automatically adjusts the number of thumbnails shown per view.
  * **Thumbnails per View**: Manually set the number of thumbnails displayed per view.
* **Max Items**: Limit the number of thumbnail items shown or select "All" to display all thumbnails.

## Sidebar

Configure the visibility and placement of the sidebar on your product page. You can choose to display or hide the sidebar, or adjust its position to fit your design needs. To turn on the sidebar simply switch the toggle to on and then it will become a section which you can click:

<figure><img src="/files/06NQEPVHsVSpHPabNJjo" alt=""><figcaption></figcaption></figure>

#### Sidebar Alignment

Choose the alignment of the sidebar:

<div align="center"><figure><img src="/files/mt39VLF1FUxbW7jlnkHs" alt="" width="335"><figcaption></figcaption></figure></div>

* **Left**: Position the sidebar on the left side of the Shop Page.
* **Right**: Position the sidebar on the right side of the Shop Page.

#### Full Height

Set the height of the sidebar to Full Height if you want it to have a 100% height within the container of the product.

#### Sidebar Widgets

The easiest and fastest way to manage your sidebar widgets is by clicking the **"Sidebar Widgets"** link within the customization options. This link will redirect you directly to the widget management area, where you can add, remove, or rearrange widgets with ease.

If you’re looking for more detailed instructions on adding widgets to your sidebar, or if you encounter any issues, please check the [adding widgets to the sidebar guide](/general/sidebars/troubleshooting-sidebar#adding-widgets-to-your-sidebar). This guide provides step-by-step instructions and troubleshooting tips to ensure your sidebar is set up exactly as you need.

{% hint style="info" %}
For additional styling and customization of the sidebar, you can adjust the global sidebar settings located under **Appearance -> Customize -> Sidebars**. This area allows you to manage the overall look and feel of sidebars across your site, check the [sidebar styling article](/general/sidebars).
{% endhint %}

## Breadcrumb

Manage the breadcrumb navigation on the product page, toggle to enable or disable the breadcrumb navigation.

#### Position

Choose the position of the breadcrumbs within the product page, it has two options:

* **Below Header**: Place the breadcrumb navigation under the header.
* **Above Title**: Position the breadcrumb navigation above the product title.

<div><figure><img src="/files/YIzBJhpZLkzbueymV1ya" alt="" width="375"><figcaption><p>Above Title</p></figcaption></figure> <figure><img src="/files/SHdoPHPoiWrQVT4yqLxi" alt="" width="375"><figcaption><p>Below Header</p></figcaption></figure></div>

## Tabs

Configure the layout and styling of product tabs, which is a crucial WooCommerce feature for products, there are three types of tab styles:

* Tabs
* Accordions
* Stacked

<div align="center"><figure><img src="/files/tXwqlLgPRWz4GksyV03j" alt="" width="336"><figcaption></figcaption></figure></div>

And each of them have the option to show the tab **Titles**, which when toggled will show. Below we'll explain each of the tab styles and their options.

<figure><img src="/files/4xS3emU9AGOEamYEfsje" alt=""><figcaption></figcaption></figure>

#### Tabs&#x20;

Display product details in a tabbed format:

* **Style**: Choose between **Underline** or **Pills**.
* **Orientation**: Select **Horizontal** or **Vertical** layout.

<div><figure><img src="/files/s5DGc9ZG0UJ3XmVXPIpS" alt="" width="375"><figcaption><p>Underline Style</p></figcaption></figure> <figure><img src="/files/yS2i7K6nFtf56gHELscu" alt="" width="375"><figcaption><p>Pill Style</p></figcaption></figure></div>

<div><figure><img src="/files/mrnLL5S7doRcRJGFPRf3" alt="" width="375"><figcaption><p>Horizontal Orientation</p></figcaption></figure> <figure><img src="/files/WAPkyk0qrvOTXFD7Di4n" alt="" width="375"><figcaption><p>Vertical Orientation</p></figcaption></figure></div>

#### Accordions

Show product details in expandable sections:

* **Show in Summary**: Toggle to display accordions within the summary or below it.
* **Collapse All**: Set all accordions to be collapsed by default.

<div><figure><img src="/files/zjsAXpXUnq95QCgx2SG4" alt=""><figcaption><p>Accordions</p></figcaption></figure> <figure><img src="/files/ziVXANgWALXHsn5XcxXw" alt=""><figcaption><p>Show in Summary</p></figcaption></figure></div>

#### Stacked

Displays tabs in a vertical stack without additional styling options.

<figure><img src="/files/Id5mZEYXeGmoSBmSLb0E" alt=""><figcaption><p>Stacked</p></figcaption></figure>

## Product Meta

Control the visibility of meta information on the product page:

<div align="center"><figure><img src="/files/hu900ldvyHl58RsoTFHo" alt="" width="337"><figcaption></figcaption></figure></div>

* **SKU**: Show or hide the product SKU.
* **Categories**: Toggle the display of product categories.
* **Tags**: Enable or disable the display of product tags.

<figure><img src="/files/7SVyfK02ujI1kohQs7dz" alt=""><figcaption></figcaption></figure>

#### Social Sharing

Allow visitors to share your product on various social networks directly from the product page. These are the options for social sharing:

<div align="left"><figure><img src="/files/sLXWRH722yKKPrwSUxiE" alt="" width="329"><figcaption></figcaption></figure></div>

#### Style

* **Labels**: Displays text labels for sharing buttons.
* **Icons**: Displays only icons for sharing buttons.

#### Share Networks

Add or remove sharing networks from the following options:

* Facebook
* X (Twitter)
* Pinterest
* Email
* LinkedIn
* Tumblr
* VKontakte
* WhatsApp
* Telegram
* Print

## Reviews

Customize the display of product reviews:

<div align="center"><figure><img src="/files/aQy0Z4pStgUPnG6mjCvM" alt="" width="335"><figcaption></figcaption></figure></div>

* **Rating Style**: Choose between **Circles** or **Stars** for the rating display.
* **Rating Color**: Select the color for the rating display.

<div><figure><img src="/files/eGj1w2NzB3WtRy12FblE" alt=""><figcaption><p>Star Rating</p></figcaption></figure> <figure><img src="/files/XhWu1t6HcCXkHPH9CbHv" alt=""><figcaption><p>Circle Rating</p></figcaption></figure></div>

## Related Products & Upsells

Manage the display of related and upsell products within the product page:

<div align="center"><figure><img src="/files/EXuYnE6BDmdwzapy1yHv" alt="" width="334"><figcaption></figcaption></figure></div>

#### Upsell Products

Toggle to show or hide upsell products.

<figure><img src="/files/ZPeRf3hfABDd01yYCoyZ" alt=""><figcaption></figcaption></figure>

#### Related Products

Show or hide related products in the product page, when toggled it will become a clickable section with the following options:

<figure><img src="/files/jHuPDOAGz23XXHr3bKP7" alt=""><figcaption></figcaption></figure>

* **Products Count**: Set the number of related products to display.
* **Product Columns**: Adjust the number of columns for related products.

<div align="center"><figure><img src="/files/uYA2Ql3V0dbKrudysTeA" alt="" width="345"><figcaption><p>General Tab</p></figcaption></figure></div>

Customize the appearance of related products:

<div align="center"><figure><img src="/files/DX4ztky96Bmfk8jXvcYu" alt="" width="347"><figcaption><p>Style Tab</p></figcaption></figure></div>

* **Background**: Choose a background color for the related products section.
* **Padding**: Adjust the top and bottom padding around related products.

[^1]: **Does not apply for:**\
    \- Simple

[^2]: **Applies only for:**\
    \- Thumbnails Bottom\
    \- Thumbnails Left\
    \- Thumbnails Right\
    \- Simple\
    \- Carousel

[^3]: **Applies only for:**\
    \- Thumbnails Bottom\
    \- Thumbnails Left\
    \- Thumbnails Right


# Product Images

Customize the display of product images across your WooCommerce store with the settings found under **Appearance -> Customize -> WooCommerce -> Product Images**. These options allow you to adjust how images appear on single product pages and throughout your catalog, helping you create a visually appealing and consistent look for your products.

### Main Image Width

This setting controls the width of the main product image on single product pages. Images displayed here will remain uncropped, preserving their original aspect ratio. Adjusting this width allows you to optimize the display of product images for different screen sizes and layouts, ensuring that they are shown in the best possible quality.

### Thumbnail Width

This option determines the size of product images in your catalog, including product grids and lists. By setting the thumbnail width, you can control how large or small product images appear in these areas, making it easier to create a visually appealing and consistent product display.

### Thumbnail Cropping

#### 1:1

Crops images into a square shape. This option ensures that all thumbnails have the same dimensions, creating a uniform look across your product catalog.

<figure><img src="/files/eYGKFIdSAgdFZ3f0UVQF" alt=""><figcaption></figcaption></figure>

#### Custom

Allows you to crop images to a custom aspect ratio. This flexibility enables you to match the image dimensions to your specific design requirements or layout preferences.

<figure><img src="/files/8lfNHjsyKEOoREjj7ggQ" alt=""><figcaption></figcaption></figure>

#### Uncropped

Displays images using the original aspect ratio in which they were uploaded. This option preserves the natural dimensions of your images but may result in varying thumbnail sizes.

<figure><img src="/files/fYnP0Lwy3NF637ujdNfd" alt=""><figcaption></figcaption></figure>


# Cart & Checkout

This section in WooCommerce allows you to customize how the checkout process is displayed to your customers, offering several options to enhance the shopping experience. This section is located under **Appearance -> Customize -> WooCommerce -> Cart & Checkout**.

### Order Review Style

Choose how the order review is shown during cart and checkout, it has the following options:

* **Invoice Cut**: Displays the order summary in a cut style for a more dynamic look.
* **Invoice Flat**: Shows the order summary in a simple, flat layout.
* **Sticky**: Keeps the order review visible as customers scroll down the page, ensuring they can always see their order details.

<div><figure><img src="/files/zlv9Z26F5qPyz5GKabhd" alt="" width="375"><figcaption><p>Invoice Flat</p></figcaption></figure> <figure><img src="/files/i5dRka6UnKh79ynGxsGr" alt="" width="375"><figcaption><p>Invoice Cut</p></figcaption></figure></div>

### Steps

Configure how the cart and checkout process is structured to enhance the user experience on your store’s cart and checkout pages, these are the options:

* **Multi Steps**: Breaks the checkout process into multiple steps, guiding customers through each phase of the purchase.
* **Step Numbers**: Allows you to toggle the visibility of step numbers during the checkout process.

<figure><img src="/files/fh5XwrLEHzEYa9qpU7rN" alt=""><figcaption></figcaption></figure>

### Checkout

Options for customizing the appearance and functionality of the checkout page.

<div><figure><img src="/files/pnA6retIXdNGWTj2cEgQ" alt="" width="375"><figcaption><p>Product Image Option</p></figcaption></figure> <figure><img src="/files/45moOrpSHnTNIuIIVwbf" alt="" width="375"><figcaption><p>Link to Product Option</p></figcaption></figure></div>

* **Product Image**: Shows or hides product images in the order review section.
* **Link to Product**: Makes product names clickable, allowing customers to view product details directly from the checkout page.


# My Account

The My Account section in WooCommerce allows you to add an image next to the login and registration forms. You can find this option under **Appearance -> Customize -> WooCommerce -> My Account**.

<figure><img src="/files/Ln2VNYG4YJTrAi68bQJF" alt="" width="345"><figcaption></figcaption></figure>

To add an image, simply click or drag an image into the upload area. If you don't select an image, none will be displayed by default.

Here are screenshots showing how the option looks and how the form can appear with an image added:

<figure><img src="/files/WVqLFCu8KtlZeAUVufCb" alt=""><figcaption></figcaption></figure>


# Store Notice

The Store Notice feature in WooCommerce allows you to display a message across your online store, ideal for announcements or updates.

### How to Use the Store Notice

Navigate to **Appearance -> Customize -> WooCommerce -> Store Notice** in your WordPress dashboard.

<figure><img src="/files/m0PwgrOv5oOuCj5gYAQ5" alt=""><figcaption></figcaption></figure>

It has the following options:

* **Enable/Disable Notice**: Check the box to show the notice bar on your site. Uncheck to hide it.
* **Store Notice**: Enter the message you want to display.

You can preview the notice live as you edit it, making sure it looks just right before going live.


# Search Results

{% embed url="<https://www.youtube.com/watch?v=nsIimGdgu3E>" %}


# What are Template Parts?

{% embed url="<https://youtu.be/2PBk-CBg9HI>" %}

Ever wanted to show a special section only on product pages? Or maybe use a different footer during a sale? Even replace the default 404 page with something more helpful or on-brand? That’s what Template Parts are for.

They let you display custom content in specific areas of your site, exactly where and when you want. No coding needed, and you can build everything using the page builder you're already comfortable with: Gutenberg, Elementor, or WPBakery.

Here are some examples of Template Parts and how they can help:

* Show a banner during a holiday sale
* Use a simpler footer on checkout and thank-you pages
* Display a different header when users are logged in
* Customize your blog category layout with a unique design
* Add a call-to-action after product descriptions
* Replace the default 404 page with something more useful
* ...and many other possibilities

Template Parts are flexible, reusable, and give you a powerful way to personalize your site.

***

### Enabling Template Parts

Template Parts are enabled by default when you install Kalium. If you ever need to turn them off or back on:

1. Go to **Kalium → Settings** in your WordPress admin.
2. On the left sidebar, click **Template Parts**.
3. Use the toggle switch to enable or disable the feature.

This gives you the flexibility to turn the feature off if you're not using it, and re-enable it later when needed.

<figure><img src="/files/HnX7YnvLKupNiyJljpdZ" alt=""><figcaption></figcaption></figure>


# Creating Template Parts

Now that you’ve learned what Template Parts are and how they work, it’s time to start creating one. Whether you’re adding a custom section, replacing your site’s footer, or building a new layout for your 404 page, the process is simple and familiar.

Template Parts are managed from one place in your WordPress admin — and the interface works just like creating a regular post or page, so it’ll feel familiar right away.

To get started, go to **Kalium → Template Parts** in your dashboard.

<figure><img src="/files/ky51RNuWQDpZRXo5fwkx" alt=""><figcaption></figcaption></figure>

***

### Types of Template Parts

There are four types of Template Parts you can create:

* **Section** – Insert content into specific areas of your site using WordPress and plugin hook locations, like before the header, after the content, or between elements on WooCommerce pages.
* **Header** – Use a custom header instead of the default site header.
* **Footer** – Swap out the footer based on the page, user, or even date.
* **Page** – Replace the layout of pages like 404, search results, category archives, and more.

Each type has a specific purpose, and you can create as many as you need depending on the parts of your site you want to customize.

***

### Tabs Overview

At the top of the Template Parts screen, you’ll see a set of tabs that help you filter, organize and view different types of Template Parts.

<div align="left"><figure><img src="/files/758kyj1ptoJzmmiUnKRm" alt="" width="375"><figcaption></figcaption></figure></div>

These tabs make it easier to find what you’re working on, especially if you have a lot of Template Parts.

{% hint style="info" %}
When adding a new Template Part, it’s helpful to switch to the tab that matches what you’re creating (like **Sections**) before clicking **Add New**. The type will be set automatically based on the tab you’re in — but you can still change it later if needed.
{% endhint %}

***

Now that you’ve seen how Template Parts are organized and where to find them, let’s go ahead and create our first one.


# Creating a Section

Sections let you insert custom content into specific parts of your site — like above the header, below the content, or inside WooCommerce product pages. These are placed using WordPress and plugin hook locations, and you can decide exactly when and where they appear using display conditions.

{% embed url="<https://youtu.be/2PBk-CBg9HI>" %}

In this example, we’ll create a banner that displays after the header across the entire site.

***

### 1. Go to Template Parts

In your WordPress dashboard, go to **Kalium → Template Parts**.

Switch to the **Sections** tab at the top, then click **Add New** in the top-left corner.

<figure><img src="/files/RfsywR5wBAsU6ZVZZpX6" alt=""><figcaption></figcaption></figure>

***

### 2. Create the Section

Enter a name for your section. For example: **30% Off Summer Sale Banner**

Now add your content in the editor. This can be anything — a short message, a call-to-action, a promotional banner, or even a more complex layout with images and buttons.

<figure><img src="/files/DhirL9dKO6Et5OCQJGwr" alt=""><figcaption></figcaption></figure>

In this example, we’ll use the default WordPress editor (Gutenberg) to build the section. If you prefer using **Elementor** or **WPBakery**, please check the respective articles:

{% content-ref url="/pages/dXg2neFEgyeAMSfUEASQ" %}
[Creating a Section with Elementor](/template-parts/creating-template-parts/creating-a-section/creating-a-section-with-elementor)
{% endcontent-ref %}

{% content-ref url="/pages/Zp6CPeBFRghEr79810o4" %}
[Creating a Section with WPBakery](/template-parts/creating-template-parts/creating-a-section/creating-a-section-with-wpbakery)
{% endcontent-ref %}

***

### 3. Open Template Part Settings

Click the **Kalium icon** in the top-right corner to open the **Template Part Settings** panel.

<figure><img src="/files/PCRlwYyw3hQIlV131Ncb" alt=""><figcaption></figcaption></figure>

***

### 4. Set the Type

Make sure the **Type** is set to **Section**.\
If it's not, switch it manually — otherwise the section may not behave as expected.

<figure><img src="/files/vLBYoEnftRDIM8neReLY" alt="" width="278"><figcaption></figcaption></figure>

For a complete overview of all types and how to use them, see the article below:

{% content-ref url="/pages/T9wqAxfvja1RR4KDr9ei" %}
[Type](/template-parts/settings/type)
{% endcontent-ref %}

***

### 5. Set Display Conditions

Click **Add Condition** to choose where this section should appear.

<div><figure><img src="/files/BHk6N17nlPxjS1TI5nW0" alt="" width="276"><figcaption></figcaption></figure> <figure><img src="/files/ghR7WSCUoywR60KiFift" alt="" width="275"><figcaption></figcaption></figure></div>

For this example, we want the banner to show across the entire site:

* Set **General Page** → **Is** → **Entire Site**

You can always add more than one condition and combine them using **AND** or **OR** logical operators to create more advanced specific rules.

For a complete overview of all condition types and how to use them, see the article below:

{% content-ref url="/pages/fhux5jLYvL8E4wx7kF3N" %}
[Display Conditions](/template-parts/settings/display-conditions)
{% endcontent-ref %}

***

### 6. Choose Placement

This setting is available only for **Sections**.

Click **Add New Location** to choose where the section appears on the page.

You can:

* Select from a list of predefined hook locations
* Search within the list
* Or click the **target icon** to open a visual popup where you can select the exact area

<figure><img src="/files/49uwWBScB1OySTeLqz9g" alt=""><figcaption></figcaption></figure>

For this example, choose **Header After**.

<figure><img src="/files/tzRrjW7LUidFvLfcVZvk" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Want to see the same hook locations as shown in the popup — but live on your site?\
Just add `?view-theme-hooks=1` to the end of any page URL. This will display all available hook positions directly on the front end, exactly like the visual overlay in the Placement popup above. It's a helpful tool for advanced placement and testing.
{% endhint %}

Leave the **Priority** set to `10` unless you need to control the display order of multiple sections targeting the same location.

Sections with **lower priority numbers** appear first. For example, a section with priority `5` will show before one with priority `10` in the same hook location.

This is especially useful when you're stacking multiple sections in the same area (e.g. adding a notice above a banner).

***

### 7. Container Settings

Under **Container Settings**, you can fine-tune how your section is wrapped and displayed:

* **Wrap with Container** – This is enabled by default. Turn it off if you want your content to stretch full-width or appear without wrapper elements.
* **Visibility** – Choose whether the section appears on desktop, tablet, mobile — or all.
* **Container Classes** – You can enter a class like `container` if you want the content to follow your site’s layout width. For this example, leave it blank.
* **Tag Name** – You can optionally set a semantic HTML tag like `<aside>` or `<section>`. By default, this is set to `<div>`, so you can leave it empty.

<div><figure><img src="/files/qZW4hEhlyrt42mAkAubv" alt="" width="277"><figcaption></figcaption></figure> <figure><img src="/files/YU7fxuP0VCfJ0QojDmyX" alt="" width="563"><figcaption></figcaption></figure></div>

***

### 8. Publish

Once everything is configured, click **Publish**.

<figure><img src="/files/eIQe6CsBRB8xn6NcAJIS" alt=""><figcaption></figcaption></figure>

Your section will now appear after the header on every page of your site, based on the conditions and placement you selected, as you can see below:

<figure><img src="/files/f0cZLlqB1M4FS0RNCiOz" alt=""><figcaption></figcaption></figure>

***

### Optional: Insert the Section Manually

In addition to automatic placement, Kalium lets you manually insert Template Part sections anywhere inside a page or post using the default editor.

This is especially useful when you want to show a section in a very specific spot, without relying on automatic placement rules.

It only applies to **Sections**, since they’re designed to be embedded within content. Other types like **Headers**, **Footers**, and **Pages** replace parts of your site and can’t be inserted manually.

Below, we’ll explain how to insert sections manually using each method.

#### Why use this?

* **Visual placement** – Drop the section exactly where you want in your design
* **Simple selection** – Choose any existing section from the dropdown
* **No display rules needed** – Skip conditions and hook settings if you want manual control

To insert a section manually:

1. Edit your page or post in the default WordPress editor.
2. Start by typing `/` or click the “+” icon to add a new block.<br>

   <figure><img src="/files/VkEVQqVTaaOAYeNaL6o5" alt=""><figcaption></figcaption></figure>
3. Search for **Content Section** and select the block.
4. In the block settings, choose the section you want to display from the dropdown.<br>

   <figure><img src="/files/5APxldfBS41DhPQYR0xt" alt=""><figcaption></figcaption></figure>

You’ll also find options to **Change Section**, **Check Conditions**, and **Edit Template**. Clicking **Edit Template** will open the template in a new tab so you can edit it directly.

<figure><img src="/files/rPRqplpshvorAZU7NHts" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Check Conditions lets you control where and when this section appears, for example, only on specific pages or for certain user roles.
{% endhint %}

***

#### Optional: Shortcode Option

If you prefer, you can insert any Template Part Section using a shortcode.

**Shortcode format:**

```
[kalium_section id="123"]
```

You don’t need to look up the ID manually — the shortcode is already visible next to each Template Part in the **Template Parts** dashboard. Just copy and paste it wherever you need.

#### Controlling Display Conditions

You can control whether the shortcode respects the section’s display conditions by adding the `check_conditions` parameter:

* `check_conditions="yes"` – The section will only appear if its display conditions are met
* `check_conditions="no"` – The section will appear unconditionally, wherever the shortcode is placed

**Example**:

```
[kalium_section id="123" check_conditions="no"]
```

This is useful if you're placing the section inside:

* Widgets
* Custom HTML areas
* Third-party shortcode-compatible plugins


# Creating a Section with Elementor

{% embed url="<https://www.youtube.com/watch?v=tisB5o8trIA>" %}

Template Parts work seamlessly with Elementor and allow you to visually build custom sections and place them anywhere on your site — all without needing **Elementor Pro**. This gives you theme-builder-level flexibility, built directly into Kalium.

In this example, we’ll walk through how to create a **Section** using Elementor.&#x20;

***

### 1. Enable Template Parts in Elementor

By default, Template Parts are not editable with Elementor unless you enable the option manually.

To do that:

1. Go to **Elementor → Settings**
2. Under the **Post Types** section, make sure **Template Parts** is checked
3. Click **Save Changes**

<figure><img src="/files/iR8yEa8DhXziWoCG6xb3" alt=""><figcaption></figcaption></figure>

***

### 2. Create the Section

Now that Elementor can edit Template Parts, you’re ready to create one:

1. Go to **Kalium → Template Parts**
2. Click **Add New**
3. Add a title for your section (e.g. `30% Off Banner`)
4. Click **Publish**

{% hint style="info" %}
&#x20;You can set up **Display Conditions**, **Placement**, and **Container Settings** now or later — the process is the same as when using Gutenberg.
{% endhint %}

<figure><img src="/files/mYle7xrm3xhwc1rvsUyh" alt=""><figcaption></figcaption></figure>

***

### 3. Edit with Elementor

Once the Template Part has been published, you’ll see the **Edit with Elementor** button appear.

Click it to open the section in the Elementor editor.

{% hint style="warning" %}
If the **Edit with Elementor** button doesn't show up, it means Template Parts are not enabled in **Elementor → Settings**. Make sure the checkbox is active under **Post Types**.
{% endhint %}

***

### 4. Add Your Content

Now you're in the Elementor editor.

1. Add your content — for this example, we’ve added a banner block announcing a **30% Sale**
2. Design the section as you like
3. When finished, click **Publish**

<figure><img src="/files/ihEHtfiVO8u8ckU4VY5M" alt=""><figcaption></figcaption></figure>

***

### 5. Check Your Section

Return to **Kalium → Template Parts** and you'll see your newly created section listed with an **Elementor** label. This means the section was built using Elementor and can be edited with it any time.

<figure><img src="/files/5lqAA7LrypE79TndIj4l" alt=""><figcaption><p>The "Elementor" label shows after the section title, so you will know it's built with Elementor</p></figcaption></figure>

***

### Optional: Insert the Section Manually

The **Content Section** element in Elementor lets you easily insert any section of Template Parts directly into your layout — no need to configure display conditions or placement settings.

#### Why use this?

* **Visual placement** – Drop the section exactly where you want in your design
* **Simple selection** – Choose any existing section from the dropdown
* **No display rules needed** – Skip conditions and hook settings if you want manual control

**To use it:**

1. Edit any page with Elementor.
2. In the Elements panel, search for **Content Section** under the **Kalium** category.<br>

   <figure><img src="/files/e3jbr5u1PDbDRILvXLK5" alt=""><figcaption><p>Click the "Content Section"</p></figcaption></figure>
3. Drag the element into the desired spot in your layout.
4. In the Content Section settings, you'll find:<br>

   <figure><img src="/files/D1y7XUNTR8f3GssfouTa" alt=""><figcaption></figcaption></figure>

   * **Display Section** – Select the section you want to show.
   * **Check Display Conditions** – Enable this to respect the section’s Display Conditions.<br>

     > Check if this section should be visible based on its Display Conditions. This has no effect unless conditions are defined in the section settings.\
     > \
     > If you leave **Check Display Conditions** off, the section will always appear wherever you’ve placed it.
5. When you're done editing click **Publish**

And this is how it looks in the page we have added:

<figure><img src="/files/KyuEie1bCKWN3cOU8QfD" alt=""><figcaption><p>And here is the final result, we have added the section created with Elementor in Contact page</p></figcaption></figure>


# Creating a Section with WPBakery

{% embed url="<https://www.youtube.com/watch?v=Y6zofiX8ZoI>" %}

Template Parts work seamlessly with **WPBakery Page Builder**, allowing you to visually build custom sections and place them anywhere on your site — without needing extra plugins or complex configuration. It’s a theme-builder-like experience built right into Kalium.

In this example, we’ll walk through how to create a **Section** using WPBakery.&#x20;

***

### 1. Create the Section

To begin:

1. Go to **Kalium → Template Parts**
2. Click **Add New**
3. Add a title for your section (e.g. `Summer Sale - 20% Off`)
4. Click **Publish**

{% hint style="info" %}
You can configure **Display Conditions**, **Placement**, and **Container Settings** now or later — the process is the same regardless of the builder you use.
{% endhint %}

<figure><img src="/files/dmT8SpwuwIyammHW6vYG" alt=""><figcaption></figcaption></figure>

***

### 2. Edit with WPBakery

After publishing, click the **Edit with WPBakery Page Builder** button to open the section in the visual editor.

{% hint style="warning" %}
If the **Edit with WPBakery** button doesn’t appear, go to **WPBakery → Role Manager**, and make sure Template Parts are enabled under **Post Types**.
{% endhint %}

***

### 3. Add Your Content

Now you're inside the WPBakery editor.

1. Add your content — for this example, we’ve used a banner with a call-to-action
2. Design the layout and styling as needed
3. When you're done, click **Update**

<figure><img src="/files/I11C9x8d9f9lQsd38V6n" alt=""><figcaption></figcaption></figure>

That’s it, you’ve successfully created a reusable Template Part section using WPBakery. It can now be displayed automatically using placement and display conditions, or inserted manually anywhere on your site.

***

### Optional: Add the Section Manually

The **Content Section** element in WPBakery lets you insert any Template Part section directly into your layout — without needing to set up display conditions or placement rules.

#### Why use this?

* **Visual placement** – Drop the section exactly where you want on the page
* **Simple selection** – Choose from your existing Template Part sections
* **No display logic required** – Skip conditions and hook settings for full manual control

**To insert a Section manually:**

1. Edit the page using WPBakery.<br>

   <figure><img src="/files/RjpCf6U3V5IOaApWzJTk" alt=""><figcaption></figcaption></figure>

2. Click **Add Element** and search for **Content Section** under **Laborator** tab.<br>

   <figure><img src="/files/zbRY0fWNNpdsvkOfK7kU" alt=""><figcaption></figcaption></figure>

3. Select the section you want to display using the **Display Section** dropdown.<br>

   <figure><img src="/files/nnIxB6txua9KXPt5Bkt0" alt=""><figcaption></figcaption></figure>

4. Enable **Check Display Conditions** if you want the section to respect its defined visibility rules.

   > *Check if this section should be visible based on its Display Conditions. This has no effect unless conditions are defined in the section settings.*

5. Save the changes and click **Update**

You can place this element anywhere in your layout, below you can see how it looks live:

<figure><img src="/files/sMrTzG84u4zsQXTlyzbM" alt=""><figcaption><p>Live preview of the section we just added</p></figcaption></figure>


# Creating a Header

We’re working on this feature and it will be available soon in an upcoming update.


# Creating a Header

We’re working on this feature and it will be available soon in an upcoming update.


# Replace a Page

We’re working on this feature and it will be available soon in an upcoming update.


# Popups

Popups are a powerful way to capture visitor attention and drive engagement on your website. Whether you're promoting a sale, collecting newsletter subscribers, displaying important announcements, or presenting exit offers, Kalium's popup system gives you complete control over when, where, and how your popups appear.

### Getting Started

#### Creating a Popup

1. Navigate to **WordPress Admin → Kalium → Template Parts**
2. Click the **Add New** button
3. Select **Popup** as the template part type
4. Design your popup content using your preferred editor:
   * **Gutenberg** (default) - WordPress block editor
   * **Elementor** - If installed and active
   * **WPBakery** - If installed and active
5. Configure the popup settings in the sidebar panels
6. **Publish** when ready

Your popup will automatically appear on your site based on the conditions and triggers you configure.

***

### Settings Panels

The popup settings are organized into panels in the editor sidebar. Each panel controls a specific aspect of your popup's behavior and appearance.

***

### Display Conditions

Control where your popup appears on your website. You can target specific pages, posts, categories, or other conditions to ensure your popup shows only to the right audience.

Read more about [Display Conditions](/template-parts/settings/display-conditions) here.

***

### Popup Triggers

Define what action causes your popup to appear. You can add multiple triggers, and the popup will show when **any one of them** is activated (first match wins).

#### On Page Load

Shows the popup when the page finishes loading.

| Option | Description                                 |
| ------ | ------------------------------------------- |
| Delay  | Seconds to wait before showing (default: 0) |

**Use case:** Welcome messages, cookie notices, or announcements that should appear immediately.

***

#### On Scroll

Shows the popup when the visitor scrolls to a certain position on the page.

| Option          | Description                                        |
| --------------- | -------------------------------------------------- |
| Direction       | Scroll direction to monitor: **Down** or **Up**    |
| Scroll Position | How far to scroll before triggering (default: 50%) |

The scroll position supports different units:

* **Percentage (%)** - Percentage of total page height
* **Pixels (px)** - Fixed pixel distance
* **Viewport Height (vh)** - Percentage of screen height

**Use case:** Show a newsletter signup after visitors have engaged with your content.

***

#### On Scroll to Element

Shows the popup when a specific element becomes visible on screen.

| Option       | Description                                                                |
| ------------ | -------------------------------------------------------------------------- |
| CSS Selector | The element to watch for (e.g., `#contact-form`, `.cta-section`, `footer`) |

**Use case:** Trigger a popup when visitors reach your pricing section or contact form.

***

#### On Click

Shows the popup when the visitor clicks on a specific element.

| Option       | Description                                |
| ------------ | ------------------------------------------ |
| CSS Selector | Element that triggers the popup (optional) |

If no selector is provided, clicking anywhere on the page will trigger the popup.

**Use case:** Create custom buttons or links that open your popup, like "Get a Quote" or "Learn More" buttons.

***

#### After Inactivity

Shows the popup after the visitor has been idle for a period of time (no mouse movement, scrolling, or keyboard activity).

| Option    | Description                                        |
| --------- | -------------------------------------------------- |
| Idle Time | Seconds of inactivity before showing (default: 30) |

**Use case:** Re-engage visitors who may have gotten distracted or are about to leave.

***

#### On Page Exit Intent

Shows the popup when the visitor moves their mouse toward the browser's close/back buttons (top of the viewport). This detects when someone is about to leave your page.

This trigger has no additional options.

**Use case:** Last-chance offers, discount codes, or "Wait! Before you go..." messages.

***

#### Based on Visitor Activity

Shows the popup based on cumulative visitor behavior tracked across their browsing session or multiple visits.

| Activity Type     | Description                                                             |
| ----------------- | ----------------------------------------------------------------------- |
| **Page Views**    | Trigger after viewing X pages (default: 3)                              |
| **Sessions**      | Trigger after X separate browsing sessions (default: 3)                 |
| **Clicks**        | Trigger after X clicks anywhere on the site (default: 3)                |
| **Scroll Amount** | Trigger after scrolling X total pixels across all pages (default: 5000) |

All activity types also support an optional **Delay** setting to wait before showing the popup once the threshold is reached.

**Use cases:**

* Show a special offer to returning visitors (Sessions)
* Reward engaged readers with exclusive content (Page Views)
* Target highly engaged users (Scroll Amount)

***

### Display Frequency

Control how often the popup reappears after a visitor closes it. This prevents annoying repeat displays while still ensuring your message reaches visitors.

| Option               | Behavior                                                    |
| -------------------- | ----------------------------------------------------------- |
| **Once Per Session** | Shows once per browser session (resets when browser closes) |
| **Once Per Day**     | Shows once every 24 hours                                   |
| **Once Per Week**    | Shows once every 7 days                                     |
| **Once Per Month**   | Shows once every 30 days                                    |
| **One Time Only**    | Never shows again after being closed                        |
| **Custom Interval**  | Specify exact seconds between displays                      |

**Tip:** For important announcements, "Once Per Session" works well. For promotional popups, "Once Per Day" or "Once Per Week" is less intrusive.

***

### Layout

Configure the popup's size, position, and visual styling.

#### Size

| Option     | Description                                                                   |
| ---------- | ----------------------------------------------------------------------------- |
| **Width**  | Popup width (default: 60%). Supports responsive values for tablet and mobile. |
| **Height** | Popup height. Leave empty to automatically fit the content.                   |

#### Position

| Option         | Values              |
| -------------- | ------------------- |
| **Horizontal** | Left, Center, Right |
| **Vertical**   | Top, Center, Bottom |

#### Offset

Fine-tune the popup's position from the edges of the screen.

| Option       | Description                       |
| ------------ | --------------------------------- |
| **X Offset** | Horizontal distance from the edge |
| **Y Offset** | Vertical distance from the edge   |

#### Scroll Lock

When enabled, prevents the page from scrolling while the popup is open. Useful for important popups that require user attention.

#### Style

| Option            | Description                                                                                          |
| ----------------- | ---------------------------------------------------------------------------------------------------- |
| **Background**    | Popup background color (supports theme colors)                                                       |
| **Padding**       | Inner spacing around your content. Supports individual values for each side and responsive settings. |
| **Border Radius** | Corner roundness. Supports individual values for each corner.                                        |
| **Box Shadow**    | Drop shadow effect behind the popup                                                                  |

***

### Overlay

Configure the backdrop that appears behind your popup.

| Option              | Description                                                  |
| ------------------- | ------------------------------------------------------------ |
| **Overlay**         | Enable or disable the darkened backdrop                      |
| **Overlay Color**   | Backdrop color with opacity (default: semi-transparent dark) |
| **Background Blur** | Blur the page content behind the overlay (0-10 pixels)       |
| **Close on Click**  | Allow visitors to close the popup by clicking the overlay    |

***

### Closing

Configure how visitors can close the popup.

#### Close Button

| Option                | Description                                           |
| --------------------- | ----------------------------------------------------- |
| **Close Button**      | Show or hide the X button                             |
| **Button Position**   | Inside or Outside the popup                           |
| **Button Size**       | Size of the close button (supports responsive values) |
| **Button Color**      | Icon color for normal and hover states                |
| **Button Background** | Background color for normal and hover states          |

#### Keyboard

| Option           | Description                                  |
| ---------------- | -------------------------------------------- |
| **Close on ESC** | Allow visitors to close using the Escape key |

#### Auto-Close

| Option         | Description                                 |
| -------------- | ------------------------------------------- |
| **Auto Close** | Automatically close the popup after a delay |
| **Delay**      | Seconds before auto-closing (default: 10)   |

**Use case:** Time-limited announcements or messages that should disappear automatically.

***

### Animation

Configure the opening and closing effects for your popup.

#### Animation Type

| Type            | Description                     |
| --------------- | ------------------------------- |
| **None**        | No animation, appears instantly |
| **Fade**        | Smooth opacity transition       |
| **Zoom**        | Scales from small to full size  |
| **Slide Up**    | Enters from the bottom          |
| **Slide Down**  | Enters from the top             |
| **Slide Left**  | Enters from the right           |
| **Slide Right** | Enters from the left            |
| **Bounce In**   | Playful bouncing effect         |

#### Animation Duration

Speed of the animation in seconds (default: 0.3). Lower values create snappier animations, higher values create smoother, slower effects.

***

### Responsive

Control which devices display your popup.

| Option      | Description             |
| ----------- | ----------------------- |
| **Desktop** | Show on desktop screens |
| **Tablet**  | Show on tablet devices  |
| **Mobile**  | Show on mobile phones   |

All devices are enabled by default. Disable any device type to hide the popup on that screen size.

**Tip:** If your popup content doesn't work well on small screens, consider disabling mobile display or creating a separate mobile-optimized popup.

***

### Best Practices

1. **Don't be intrusive** - Use appropriate display frequencies and consider user experience
2. **Time your triggers** - Let visitors engage with your content before showing popups
3. **Keep it focused** - Each popup should have one clear purpose and call-to-action
4. **Test on all devices** - Ensure your popup looks good on desktop, tablet, and mobile
5. **Provide easy exit** - Always allow visitors to close the popup easily
6. **Match your brand** - Use colors and styling consistent with your website design


# Settings

Template Parts in Kalium have a dedicated settings panel that lets you control how and where your content appears on your site. Depending on the type of Template Part you're creating (Section, Header, Footer, or Page), the available settings may vary.

In this article, we’ll walk through the main parts of this panel — including how to open it and switch between Template Part types.

***

## Settings Panel

To open the Template Part settings, click the **Kalium icon** in the top-right corner while editing a Template Part.

This will toggle the settings panel on the right side of the editor. From here, you can configure all available options for your Template Part.

<figure><img src="/files/PCRlwYyw3hQIlV131Ncb" alt=""><figcaption></figcaption></figure>


# Type

At the top of the panel, you’ll see the **Type** dropdown. This defines the kind of Template Part you’re working on:

* **Section** – Used to inject content into hook locations across the site.
* **Header** – Replaces the default site header.
* **Footer** – Replaces the default footer.
* **Page** – Replaces entire pages like 404, search results, or archives.

<figure><img src="/files/vLBYoEnftRDIM8neReLY" alt="" width="278"><figcaption></figcaption></figure>


# Display Conditions

Display Conditions let you control **where** and **when** a Template Part appears on your site.

You can create rules to include or exclude specific areas based on page type, user role, WooCommerce state, date, and more — giving you full control over visibility without writing any code.

This works with all Template Part types: **Sections**, **Headers**, **Footers**, and **Pages**.

***

### How to Add Conditions

While editing a Template Part:

1. Click the **Kalium icon** in the top-right corner to open the settings panel
2. Scroll to the **Display Conditions** section
3. Click **Add Condition**\
   ![](/files/BHk6N17nlPxjS1TI5nW0)
4. Choose a condition type (e.g. General Page, Single Post, etc.)\
   ![](/files/ghR7WSCUoywR60KiFift)
5. Set the rule using **is** or **is not**
6. Select the target (e.g. a specific page, post type, or user role)

***

### Using “is” and “is not”

Each condition supports two rule types:

* **is** – The Template Part will be shown on the selected target(s)
* **is not** – The Template Part will be hidden on the selected target(s)

{% hint style="info" %}
Example:

* **is** → Show on the Front Page
* **is not** → Show everywhere **except** the Front Page
  {% endhint %}

***

### Condition Types

Here’s a full list of supported condition types, grouped for clarity. These allow you to target content by page, post, user status, device type, time, and more.

| **General Page** | **Where it applies**                |
| ---------------- | ----------------------------------- |
| Entire Site      | Applies to every page on your site  |
| Front Page       | The homepage of your WordPress site |
| Blog Page        | The main blog listing page          |
| 404 Error Page   | The "Page Not Found" screen         |
| Search Page      | Search results pages                |

| **Singular Content**    | **Where it applies**                                                              |
| ----------------------- | --------------------------------------------------------------------------------- |
| Single Post             | Individual blog posts                                                             |
| Single Page             | Individual static pages                                                           |
| Custom Post Type Single | Select any custom post type (e.g. Portfolio, Product), then choose specific items |
| Attachment              | Media attachment pages                                                            |

| **Archive**              | **Where it applies**                                           |
| ------------------------ | -------------------------------------------------------------- |
| Blog Archive             | The main post archive                                          |
| Date Archive             | Archives by day, month, or year                                |
| Author Archive           | Pages listing posts by a specific author                       |
| Custom Post Type Archive | Archive page for custom post types (e.g. Products, Portfolios) |

| **Taxonomy**            | **Where it applies**                                                        |
| ----------------------- | --------------------------------------------------------------------------- |
| Category Archive        | Blog categories (e.g. News, Tutorials)                                      |
| Tag Archive             | Blog tags                                                                   |
| Custom Taxonomy Archive | Choose custom taxonomy and terms (e.g. Product Categories, Portfolio Types) |

| **User**   | **Where it applies**                                                         |
| ---------- | ---------------------------------------------------------------------------- |
| Logged In  | Shows only to users who are logged in                                        |
| Logged Out | Shows only to users who are not logged in                                    |
| User Role  | Target specific roles like Administrator, Editor, Subscriber, Customer, etc. |

| **WooCommerce**          | **Where it applies**                        |
| ------------------------ | ------------------------------------------- |
| Product Page             | Individual product pages                    |
| Shop Archive             | The main shop page                          |
| Product Category Archive | Category listings (e.g. T-Shirts, Shoes)    |
| Product Tag Archive      | Tag listings on products                    |
| Cart Page                | The WooCommerce cart page                   |
| Checkout Page            | The WooCommerce checkout                    |
| My Account Page          | Customer account area (login, orders, etc.) |

{% hint style="info" %}
WooCommerce-specific conditions only appear if WooCommerce is active on your site.
{% endhint %}

| **Date & Time** | **Where it applies**                                |
| --------------- | --------------------------------------------------- |
| Specific Date   | Show only on a selected date                        |
| Specific Time   | Show only during a specific time of day             |
| Specific Days   | Show only on selected weekdays (e.g. weekends only) |

| **Custom Condition** | **Where it applies**                                                      |
| -------------------- | ------------------------------------------------------------------------- |
| PHP Callback         | Enter a custom PHP function that returns true/false                       |
| Post Meta            | Target based on a meta key/value with operators (e.g. `meta_key = value`) |
| URL Query String     | Match parts of the URL (e.g. `?utm_campaign=summer`)                      |
| Referrer URL         | Show based on the referring page or site                                  |

***

### Logical Operators: AND / OR

When adding more than one condition, you'll see a toggle at the top of the conditions panel to choose between **AND** and **OR**.

<div align="left"><figure><img src="/files/FYwe709SWVgfG1rnSCcp" alt="" width="112"><figcaption></figcaption></figure></div>

These are called **logical operators**, and they control how the conditions work together:

* **AND** – All conditions must match for the Template Part to appear\
  *Example: Show only on the Cart page **AND** only for logged-in users*
* **OR** – The Template Part appears if **any** of the conditions match\
  *Example: Show on the Front Page **OR** the Blog page*

You can switch between these modes at any time to change how your display rules are applied.

***

Display Conditions are one of the most powerful features in Template Parts. Combined with Placement and Container Settings, they give you full control over when and where your content appears — without any custom code.


# Placement

The **Placement** setting is only available when you're creating a **Section**, and it defines where that section appears on the page. They are explained in detail in [Creating a Section](/template-parts/creating-template-parts/creating-a-section).


# Container Settings

The **Container Settings** section is also specific to **Sections**, allowing you to control layout, device visibility, and wrapper settings. They are explained in detail in [Creating a Section](/template-parts/creating-template-parts/creating-a-section).


# Fonts

Fonts play a crucial role in shaping the visual identity and readability of your site. They help establish the tone and style of your content, making it more engaging and easier to read. Kalium offers a wide range of font options to ensure that you can find the perfect typeface for your needs.

### Types of Fonts

We offer several types of fonts:

* [**Google Fonts**](/typography/fonts/how-to-add-a-font): A vast collection of free, open-source fonts provided by Google.
* [**Premium Fonts**](/typography/fonts/how-to-add-a-font): High-quality fonts that we have purchased and included for free in the theme. These fonts are available at no additional cost.
* [**Adobe Fonts**](/typography/fonts/how-to-add-a-font/adding-adobe-fonts): Fonts from Adobe’s extensive library, accessible with an Adobe Creative Cloud subscription.
* [**Self-Hosted Fonts**](/typography/fonts/how-to-add-a-font/adding-self-hosted-fonts): Fonts that you upload and host yourself on your server.
* [**External Fonts**](/typography/fonts/how-to-add-a-font/adding-external-fonts): Fonts hosted on third-party services that you can link to from your site.
* [**System Fonts**](/typography/fonts/how-to-add-a-font): Fonts that are pre-installed on users’ devices, ensuring compatibility and faster load times.


# How to Add a Font

This guide will show you how to easily add and manage fonts on your site. The steps are simple and straightforward, so you can quickly choose and apply fonts to get the look you want for your site.&#x20;

Let's add a new font, navigate to **Kalium -> Typography** from the WordPress admin dashboard.

{% hint style="info" %}
This guide covers Google Fonts, Premium Fonts, and System Fonts. For information on [Adobe Fonts](/typography/fonts/how-to-add-a-font/adding-adobe-fonts), [External Fonts](/typography/fonts/how-to-add-a-font/adding-external-fonts), and [Self-Hosted Fonts](/typography/fonts/how-to-add-a-font/adding-self-hosted-fonts), please refer to the other articles.
{% endhint %}

### 1. Add a New Font

Click on the "**+ Add Font**" button to start adding a new font.

<figure><img src="/files/KXkp9pivVJ2qen5Xw8K8" alt=""><figcaption></figcaption></figure>

### 2. Choose the Font Source

Select the font source from the available options, such as Google Fonts, Premium Fonts, Adobe Fonts, Self Hosted Fonts, External Fonts, or System Fonts. The options you see will depend on the font source you choose.

<figure><img src="/files/5PKN5dK5WhYmc3UTnPTg" alt=""><figcaption></figcaption></figure>

### 3. Select Your Font

In the left panel, browse through the available fonts or use the search option to find a specific font. You can also filter fonts by categories such as serif or sans-serif. Once you find the font you want, select it.

<figure><img src="/files/Y31PQDXEIlqHYEHTH43c" alt=""><figcaption></figcaption></figure>

### 4. Select Variants

On the right side, you’ll see the variant selector. Choose the specific variant of the font you wish to use, such as Regular, Bold, or Italic. If you don’t need a particular variant, it’s best not to select it, as unnecessary variants can impact your site’s performance.

### 5. Apply the Font

Decide where you want the font to be applied, such as "Sitewide," "Headings," or "Paragraphs." By default, the font will be applied sitewide. If you want to use different fonts for different sections, you can customize the settings to apply one font to headings and another to paragraphs, or adjust as needed.

<figure><img src="/files/Gn10uAxuGS4VaIXZe26u" alt=""><figcaption></figcaption></figure>

That’s all for the basic font setup. Be sure to save your changes by clicking the **Save Changes** button. The additional options available, such as Conditional Loading and Overwriting Font Settings, are more advanced and not necessary for loading a font but can be explored if you need more control over font management.


# Adding Adobe Fonts

The process of adding Adobe Fonts is quite similar to the general font adding process. By following these steps, you’ll be able to seamlessly incorporate Adobe Fonts into your site and enhance your typography.

### 1. Go to Adobe Fonts

Start by visiting [Adobe Fonts](https://fonts.adobe.com) and searching for the font you want to use on your site. Adobe Fonts offers a wide selection, so take your time to find the perfect match for your design needs.

{% embed url="<https://fonts.adobe.com/>" %}

### 2. Add to Web Project

Once you've selected a font, click the **\</> Add to Web Project** button. This will allow you to use the font on your website by linking it to a web project.

<figure><img src="/files/ObSpXHAZmEaghs43OJGM" alt=""><figcaption></figcaption></figure>

### 3. Create a Web Project

A new popup will appear, prompting you to add the name of your project, name the project and choose the desired font variants (e.g., Regular, Bold, Italic) for this project, then click the "**Create**" button to generate your web project.

<figure><img src="/files/IS8yashR8TsIebbLWJa7" alt=""><figcaption></figcaption></figure>

### 4. Access Your API Token

Now that you've created your web project, head to the top right area of the Adobe Fonts page. Click on your profile icon, and in the dropdown menu, select "**API Tokens**." This is where you'll find the necessary API token to integrate Adobe Fonts with your site.

<figure><img src="/files/t8HsCEYGyIKzV0WvRbu2" alt=""><figcaption></figcaption></figure>

### 5. Copy Your API Token

On the API Tokens page, locate your token on the left side. Copy this token, as you'll need it to connect Adobe Fonts with your site through Kalium.

<figure><img src="/files/qK7azBHoKrC6VuBYnwwy" alt=""><figcaption></figcaption></figure>

### 6. Integrate with Kalium

To finalize the process, navigate to **Kalium -> Typography -> Settings** in your WordPress dashboard. Paste the API token you copied into the "**Adobe Fonts API Token**" field. This will link your Adobe Fonts to Kalium, allowing you to use them on your site.

<figure><img src="/files/jWvytb4FqBOTD5KoJhf9" alt=""><figcaption></figcaption></figure>

### 7. Add a New Font

Navigate to the **Fonts** tab under **Kalium -> Typography**, then click on the "**+ Add Font**" button to start adding a new font.

<figure><img src="/files/KXkp9pivVJ2qen5Xw8K8" alt=""><figcaption></figcaption></figure>

### 8. Choose the Font Source

Select the font source from the available options, in this case Adobe Fonts, and click "**Continue ->**".&#x20;

<figure><img src="/files/Cr6l5ZEAKEMd8j6ShYuz" alt=""><figcaption></figcaption></figure>

### 9. Select Your Font <a href="#id-3.-select-your-font" id="id-3.-select-your-font"></a>

In the left panel, the fonts you've selected and added to your project in Adobe Fonts will show while in the right you will see the variants you've selected.

<figure><img src="/files/VNId9TWTVKY56NnMlJpC" alt=""><figcaption></figcaption></figure>

### 10. Apply the Font

Decide where you want the font to be applied, such as "Sitewide," "Headings," or "Paragraphs." By default, the font will be applied sitewide. If you want to use different fonts for different sections, you can customize the settings to apply one font to headings and another to paragraphs, or adjust as needed.

<figure><img src="/files/Gn10uAxuGS4VaIXZe26u" alt=""><figcaption></figcaption></figure>

### Save Changes

Well done! You’ve successfully added Adobe Fonts to your site. Now, you can start applying these fonts to various elements, ensuring your site’s typography reflects the style you’re aiming for.


# Adding Self-Hosted Fonts

The process of adding Self-Hosted Fonts is quite similar to the general font-adding process. This method also ensures compliance with GDPR regulations by hosting the font directly on your website rather than fetching it from external sources.

By following these steps, you’ll be able to seamlessly incorporate your own fonts into your site and enhance your typography.

### 1. Add a New Font

Navigate to the **Fonts** tab under **Kalium -> Typography**, then click on the "**+ Add Font**" button to start adding a new font.

<figure><img src="/files/KXkp9pivVJ2qen5Xw8K8" alt=""><figcaption></figcaption></figure>

### 2. Choose the Font Source

Select the font source, in this case **Self-Hosted Fonts** and click "**Continue ->**".&#x20;

<figure><img src="/files/yCP7emhcs5FBQYt1R5oE" alt=""><figcaption></figcaption></figure>

### 3. Name Your Font&#x20;

Once you’re on the self-hosted font page, start by naming the font face you will be adding. For instance, if you are uploading the "Inter" font, you will name it "Inter."&#x20;

### 4. Upload and Set Up Self-Hosted Font and Variants

Now you can set up the font style, weight, and upload the font files. You can also preview the font on the right side of the page. Here’s what you need to do:

* **Font Style**: Choose between Normal or Italic.
* **Font Weight**: Select the appropriate font weight for the variant you are uploading.
* **Font Files**: Upload the WOFF2 font file or choose it from the media library. WOFF2 is the only necessary font file; the others are optional for older browser support but not required.

<figure><img src="/files/oiqkr2Ykerrqdgu4FirX" alt=""><figcaption></figcaption></figure>

The “**Show more options**” button is designed for advanced use only. If you click it, you’ll have the option to upload various web font formats, including WOFF, TTF, EOT, and SVG, in addition to WOFF2.

If you have additional font variants, such as Bold, you can create them by clicking the "**+ Add Font Variant**" button, the variants will show on the right area of the page where you can preview the font you've added. Once you’ve set up the font variants, click "**Save Changes**."

### 5. Apply the Font

Decide where you want the font to be applied, such as "Sitewide," "Headings," or "Paragraphs." By default, the font will be applied sitewide. If you want to use different fonts for different sections, you can customize the settings to apply one font to headings and another to paragraphs, or adjust as needed.

<figure><img src="/files/Gn10uAxuGS4VaIXZe26u" alt=""><figcaption></figcaption></figure>

### 6. Save Changes

Finally, save your changes to apply the font to your website. Your self-hosted font is now ready to use.

Well done! You’ve successfully added a self-hosted font to your site. Now, you can start applying these fonts to various elements, ensuring your site’s typography reflects the style you’re aiming for.


# Adding External Fonts

Adding external fonts to your site is a straightforward process that involves linking to a stylesheet containing the web fonts you want to use. This method allows you to easily integrate fonts from external sources with minimal setup.

### 1. Add a New Font

Navigate to the **Fonts** tab under **Kalium -> Typography**, then click on the "**+ Add Font**" button to start adding a new font.

<figure><img src="/files/KXkp9pivVJ2qen5Xw8K8" alt=""><figcaption></figcaption></figure>

### 2. Choose the Font Source

Select the font source, in this case **External Fonts** and click "**Continue ->**".&#x20;

<figure><img src="/files/ChVTV0Qd9GKVlArfayiX" alt=""><figcaption></figcaption></figure>

### 3. Add the font URL&#x20;

In the “**Font Stylesheet URL**” field, you need to paste the URL of a stylesheet that includes the web fonts you want to use on your site. This stylesheet should contain `@font-face` rules, which define how the fonts are displayed.&#x20;

For example, if you are adding the Merriweather font directly from Google Fonts, you would use a URL like `https://fonts.googleapis.com/css2?family=Merriweather`.&#x20;

This URL links directly to a stylesheet that includes the necessary font declarations, ensuring that the Merriweather font is properly loaded and applied to your site.

<figure><img src="/files/zXijI7EFis2msJ8rcSPM" alt=""><figcaption></figcaption></figure>

### 5. Apply the Font

Decide where you want the font to be applied, such as "Sitewide," "Headings," or "Paragraphs." By default, the font will be applied sitewide. If you want to use different fonts for different sections, you can customize the settings to apply one font to headings and another to paragraphs, or adjust as needed.

<figure><img src="/files/Gn10uAxuGS4VaIXZe26u" alt=""><figcaption></figcaption></figure>

### 6. Save Changes

After entering the stylesheet URL, click “**Save Changes**” to apply the font to your site. The font will automatically load from the external source and be available for use.


# Custom Selectors

In this section, you can apply the font to specific areas of your site by choosing from the list of pre-defined selectors or by entering a relevant CSS class or ID. This feature gives you precise control over where the font appears on your site.

For example, if you want all blockquotes to be bold and use a specific font, you can select this option from the pre-defined templates. This way, every blockquote across your site will automatically adopt the font settings you've chosen, such as making it bold. This granular control helps you ensure that the font is used exactly where and how you need it.

<figure><img src="/files/T8Mdn7qzp3o9c9CyGhxx" alt=""><figcaption></figcaption></figure>

Keep in mind that if you change the font size here, it will override the default "Font Sizes" settings. For those new to CSS, it's advisable to first review the "Font Sizes" tab to understand the basics.


# Advanced Settings

Here, you can manage advanced options to customize the font experience, including when to load the font and how to override default font settings. This section is ideal for users who need specific configurations for different parts of their site or want to optimize font loading performance.

### Conditional Loading

Configure when to include the font on specific pages, posts, or other post types. You can also exclude it from certain areas if needed:

<figure><img src="/files/ojW5UDQvofAbJGkG079m" alt=""><figcaption></figcaption></figure>

### Overwrite Font Settings

Manage additional font settings which will overwrite the font settings such as [Font Preload](/typography/typography-settings#font-preload) or [Import Font](/typography/typography-settings#font-import-placement), you can also set the status of the font from Active to Inactive or vice-versa.


# Font Sizes

Managing font sizes is important for a clean and consistent look on your site. The Font Sizes tab settings let you adjust how text appears across your website, including font size, line height, and letter spacing. Here’s a simple guide to help you customize these settings.

<figure><img src="/files/j3Z9FkQnBM7ENqOfcPcZ" alt=""><figcaption></figcaption></figure>

### Font Sizes

You can change the font sizes for different parts of your site, including headings, paragraphs, and other text elements. This setting ensures that your typography scales appropriately across different sections of your site.

### Line Height

Adjust the line height to control the vertical spacing between lines of text. This setting helps improve readability and ensures that text is properly spaced.

### Letter Spacing

Set the letter spacing to control the horizontal space between characters. This can enhance the overall readability and visual impact of your text.

### Text Transform

The Text Transform option allows you to adjust the case of your text, such as making it uppercase, lowercase, or capitalizing the first letter of each word. This helps with styling and consistency across your content.

### Units

You can select from various units for font sizes, line height, letter spacing, and text transform, including:

* **PX** (Pixels)
* **EM** (Relative to the font size of the element)
* **REM** (Relative to the root element’s font size)
* **PT** (Points)
* **%** (Percentage)
* **VW** (Viewport Width)

Alternatively, you can use the global unit setting available under [**Kalium -> Typography -> Settings** **->** **Default Unit**](/typography/typography-settings#default-unit) to standardize the unit across your site.

### Responsive Options

Each section for font sizes, line height, letter spacing, and text transform includes responsive options for different devices:

* **Desktop**
* **Tablet**
* **Mobile**

This ensures that your typography adjusts appropriately for various screen sizes and devices, providing a seamless experience for all users.

By adjusting these settings, you can ensure that your site's typography is not only visually appealing but also consistent and responsive across different devices.

***

### Base Font

<figure><img src="/files/FdI0cZBel1dh1UoXZqPP" alt=""><figcaption></figcaption></figure>

The **Base Font** section allows you to set the root font size for the site. This is particularly important when using relative units such as **EM**, **REM**, and **%**, as these units are based on the base font size. By defining the base font size, you ensure that all relative font sizes scale appropriately across your site. This setting provides a consistent typographic scale and helps maintain readability.

Adjusting the base font size affects how other font sizes are calculated when using relative units. For example, if you set the base font size to 16px, a font size of 1.5rem will be 24px (1.5 times the base size). This consistency is crucial for responsive design, ensuring that text remains proportionate and legible across different devices.

***

### How Can I Set a Specific Font Size for a Selector on the Site?

To customize the font size for a specific CSS class on your site, follow these simple steps:

* Go to **Kalium -> Typography -> Fonts**.
* Select the font you’re using from the list.
* Scroll down to **Custom Selectors**.
* Click on **+ Add New Selector**.
* Enter your desired class name, for example, `.my-custom-class`.
* Set the font size and other settings as needed.
* Save changes

<figure><img src="/files/45qmJ1eLrnX5Y7aY4JYv" alt=""><figcaption></figcaption></figure>

By doing this, you can easily apply custom font sizes and other styling to specific elements on your site by targeting their CSS class. By using Inspect Element, you can accurately identify and target the exact area where you want to apply custom font sizes and other styling adjustments.

#### Targeting a Specific Area Using Inspect Element

To apply the font size to a specific area on your site, you first need to identify the CSS class used for that area. Here’s how to do it:

1. **Right-click on the area** of your site where you want to apply the custom font size.
2. **Select "Inspect"** <img src="/files/zvwxjYksJlLL5ZG5IEra" alt="" data-size="line"> or "Inspect Element" from the context menu . This will open the browser’s developer tools.
3. **Look for the CSS class** applied to the selected element in the HTML structure on the left side of the developer tools.
4. **Copy the class name**. For example, you might see something like `<div class="header-title">`.
5. **Use this class name** (e.g., `.header-title`) when adding a new selector in the Font settings.
6. **Follow the steps** to add a new selector and set the font size for this class.


# Typography Settings

Various settings are available to help you customize the typography on your site. Here’s a look at the options for managing and adjusting your fonts

<figure><img src="/files/bS78L41ZRqOEKJySVRnT" alt=""><figcaption></figcaption></figure>

### Typography Status

This setting allows you to enable or disable fonts on the front end of your website. By toggling this option, you can control whether the selected fonts are applied to your site’s design.

### Font Preload

The Font Preload option helps improve page loading speed and user experience by preloading the fonts. When enabled, it loads the fonts early in the page rendering process, making sure your text displays as soon as possible.

### Pull Google Fonts

When this option is enabled, Kalium will load Google Fonts locally instead of pulling them from Google’s servers. This can help with site performance and privacy by reducing external requests.

### Font Import Placement

This setting determines where the font import code is placed within your HTML document. You can choose between:

* **Before page renders (Inside `<head>`)**: This option loads fonts before the page content is displayed.
* **After page renders (Inside `<body>`)**: This option loads fonts after the page content is displayed.

### Font Face Rendering

The Font Face Rendering setting lets you choose how to render the font faces for better performance. The available options are:

* **Swap (default)**: Ensures text is displayed using a fallback font until the custom font is fully loaded.
* **Auto**: The browser decides the best rendering method.
* **Block**: Prevents text from being displayed until the custom font is fully loaded.
* **Fallback**: Uses a fallback font initially, then swaps to the custom font.
* **Optional**: Similar to fallback, but with less priority on loading the custom font.

### Adobe Fonts API Token

To use Adobe Fonts with Kalium, you need to provide an Adobe Fonts API token. This token fetches your font projects and integrates them into the theme, allowing you to utilize Adobe’s extensive font library.

### Default Unit

This option allows you to set the default unit for font sizes, line heights, and letter spacing. You can choose between units like pixels (px), em, or rem, depending on your design preferences.

### Font Preview Text

Here, you can enter custom text that will be displayed as a preview when selecting different font variants. This allows you to see how your chosen fonts will appear with your specific text.

### Font Preview Size

This setting lets you specify the font size, in pixels, for the preview text. Adjusting this helps you better visualize how the font will look in different sizes.

### Fonts Directory

The Fonts Directory option shows you where your fonts are stored and managed. The default directory is: `~/wp-content/uploads/typolab-fonts/` This is where your locally stored fonts are kept and where you can manage permissions for font usage.

### Export Fonts

The Export Fonts section allows you to export various font settings, making it easy to back up or transfer your typography setup. You can choose to export:

* **Fonts**
* **Font Sizes**
* **Font Settings**

Simply click the **Export** button to generate an export string.

### Import Fonts

In the Import Fonts section, you can paste an export string from another site or backup to import your font settings. This makes it simple to replicate typography settings across multiple sites.

These typography settings give you granular control over how fonts are managed, rendered, and displayed on your site, ensuring a consistent and professional appearance.


# Brand and Logo

In Kalium, setting up your site's branding is quite simple. You can easily manage your branding elements through the **Appearance** -> **Customize** -> **Styling** -> **Brand** section. You have the option to use a logo or not by switching the toggle. This area allows you to customize the following key brand elements:

<figure><img src="/files/kcWOqaguYjiVCvh21Taf" alt=""><figcaption></figcaption></figure>

* **Site Title**\
  Set the name of your website, which will be displayed in various parts of your site and can enhance your site's identity.
* **Tagline**\
  Add a brief description or slogan for your website, giving visitors a quick insight into what your site is about.
* **Site Logo**\
  Upload your logo to represent your brand visually across your website. You can choose to enable or disable the display of the logo as needed.
  * **Logo Width**\
    Adjust the width of your logo to fit your site's design. Responsive options are available, allowing you to set different logo widths for various devices (desktop, tablet, and mobile) to make sure your logo looks perfect on all screen sizes.
* **Site Icon**\
  The Site Icon is the small image you see in browser tabs, bookmark bars, and within the WordPress mobile apps also known as the favicon. It’s an important branding element for a professional appearance. The icon should be square and at least `512 × 512` pixels in size.
* **Tab Color**\
  This color applies only on browsers that support the `theme-color` feature. It appears on some browsers that support it, allowing you to match your tab color with your site's branding.


# Colors

Colors are a fundamental aspect of the theme, and understanding how to work with them will help you achieve the best results and enhance your site’s overall appearance.

To manage and edit colors go to **Appearance** -> **Customize** -> **Styling** -> **Colors**

***

### Base Palette

The color palette defines the base colors of your site based on your brand guidelines.

It is a set of of **8 colors** by default but you can add more colors by clicking the :heavy\_plus\_sign: icon in upper part of colors strip.

Base palette colors are utilized to be used throughout all color pickers as references so when you update a color in the base palette, every other reference is updated automatically as well.

You can also choose from predefined palettes by clicking the :art: palette icon.

<figure><img src="/files/cx1U5l0vfdy8yRxoHZYO" alt="" width="327"><figcaption><p>Default Color Palette</p></figcaption></figure>

When the colors are modified, the :pencil2: icon will show up instead of the :heavy\_plus\_sign: icon where you can save the current set of colors as a palette:

<figure><img src="/files/grv9nla9jOiAZe6tvKYJ" alt="" width="324"><figcaption><p>Custom colors can be saved as new palette</p></figcaption></figure>

After you save the palette, it appears in the list of **Custom Palettes** as **Palette X** where X is an ordered number:

<figure><img src="/files/cUrxOUkg7tqXTFcUsKP7" alt="" width="333"><figcaption><p>List of theme defined palettes with custom user palettes</p></figcaption></figure>

You can also export or import existing palettes including current colors in the same dialog by clicking **Export/Import** tab:

<figure><img src="/files/lrUJWB865bFVyZiloehW" alt="" width="331"><figcaption><p>Export and/or Import current palette colors and custom user palettes</p></figcaption></figure>

***

### Global Theme Colors

Theme palette colors are also recognized by both the Gutenberg and Elementor. This ensures consistency across your site’s design, allowing you to seamlessly apply your chosen color palette in different parts of your site, whether you’re using the Gutenberg blocks or Elementor’s widgets.

<figure><img src="/files/ztXiciOgqiEkXD8ES6kJ" alt="" width="255"><figcaption><p>Gutenberg Color Palette</p></figcaption></figure>

<figure><img src="/files/XU97YNoXlkraukLUy4qB" alt="" width="295"><figcaption><p>Elementor Color Palette</p></figcaption></figure>

***

### Global Colors

* **Links** - Normal and hover color for every link in the theme.
* **Text** - Default text color and muted text color.
* **Text Selection** - Change how selected text looks when selected.

***

### Headings

* **Headings H1-H6**  - Default colors for all headings (as every heading size inherits from this value).
* **Heading 1** to **Heading 6** - Custom color for every heading size.

***

### Other Colors

* **Footer** - Footer background, text, headings and link colors.
* **Site Background** - The body background color.
* **Overlay** - Default color of backdrop overlays for lightboxes.

### CSS Color References

Every color provides a CSS variable reference of this form you can use throughout the site:

```css
var(--k-color-1)
var(--k-color-2)
var(--k-color-3)
var(--k-color-4)
var(--k-color-5)
var(--k-color-6)
var(--k-color-7)
var(--k-color-8)
var(--k-color-9) /* custom added colors */
```

As well as their RGB variant:

```css
var(--k-color-1-rgb)
var(--k-color-2-rgb)
var(--k-color-3-rgb)
var(--k-color-4-rgb)
var(--k-color-5-rgb)
var(--k-color-6-rgb)
var(--k-color-7-rgb)
var(--k-color-8-rgb)
var(--k-color-9-rgb) /* custom added colors */
```

So you can use with custom opacity for example:

```css
background: rgba(var(--k-color-1-rgb), 0.5);
```


# Buttons

Globally manage the appearance of buttons across your site to have a consistency in design. Customize the button styles under **Appearance** -> **Customize** -> **Styling** -> **Buttons**. Each button style can be set for three states:&#x20;

* Normal
* Hover
* Active

<figure><img src="/files/dTiZmMc9HD02yQMexxLz" alt=""><figcaption></figcaption></figure>

This means that you can define how buttons look by default, how they change when hovered over, and their appearance when actively clicked or pressed. All options related to colors apply to these three states.

***

### Color

<figure><img src="/files/27r18kgRJSL7USCh4ynp" alt="" width="340"><figcaption></figcaption></figure>

#### **Text Color**

Set the color of the text on your buttons. Make sure there is enough contrast with the background color to help users with different abilities read the text easily.

#### Background Color

Choose the background color for your buttons. Ensure it contrasts well with the text color to make it easy to see.

***

### Box Shadow

<figure><img src="/files/VD7SS2myNRYHqfZFk38l" alt="" width="340"><figcaption></figcaption></figure>

#### Box Shadow

Add a shadow effect to your buttons. You can adjust the shadow’s color, blur, spread, and position to give the button a 3D look and make it stand out.

***

### Padding & Border

<figure><img src="/files/aR9QPUXn8KhY65lsgP71" alt="" width="343"><figcaption></figcaption></figure>

#### Padding

Adjust the space around the button text to change its size and spacing. This setting applies to all buttons and doesn’t change with different states.

#### Border Radius

Set how rounded the corners of the buttons are. This lets you create buttons with either square or rounded edges.

#### Border

Customize the border color, style, and width of your buttons. Keep in mind that the border color on Hover and Active states won’t be visible unless a border width is set. If you want to set the border width and color manually for each of the four sides, click the link icon (🔗) to unlink the values.


# Forms

Manage the appearance and layout of forms across your entire site to maintain a consistent design. This applies to all forms, including contact forms, search forms, comment sections, checkout pages, and more. You can customize the form styles under **Appearance** -> **Customize** -> **Styling** -> **Forms**.

<figure><img src="/files/Ks6EgVSJNNT8BepcgRD2" alt=""><figcaption></figcaption></figure>

### General

The General tab in allows you to control the overall layout and style of forms across your site. This tab includes options to choose the layout type and activate the legacy form style if needed.

#### Form Layout

This section lets you select the basic structure of your forms. You can choose between two layout types:

<figure><img src="/files/yZutLofZHeSofLYImfeM" alt="" width="345"><figcaption></figcaption></figure>

#### Type 1

The default form layout option. This style features a boxed layout, providing a traditional and structured appearance for your forms.

#### Type 2

A more minimalistic layout option where form fields appear as underlined rather than boxed. This style gives your forms a modern and sleek look.

{% hint style="info" %}
**Legacy Form Style**\
This toggle is available for users who have migrated from Kalium 3 and want to continue using the old Kalium forms. However, it's not recommended to use this option as it is considered legacy and will be removed in future updates.
{% endhint %}

***

### Style

In the Style tab, you can customize various aspects of the form fields:

#### Input & Textarea

<figure><img src="/files/GwJGNMyH7rMkaFQo46o1" alt="" width="341"><figcaption></figcaption></figure>

* **Placeholder**: Set the text color for the placeholder in form fields.
* **Text**: Customize the text color for three states — Normal, Hover, and Active.
* **Border**: Define the border color for the three states — Normal, Hover, and Active.
* **Border Width**: Adjust the thickness of the border around form fields.
* **Padding**: Control the space inside the form fields to adjust the size and spacing of the text.
* **Border Radius**: Set how rounded the corners of the form fields are.

#### Box Shadow

Add a shadow effect to the form fields to give them depth and make them stand out, available for the three states (Normal, Hover and Focus).

<figure><img src="/files/0GXotlxDdDF9a1U60Wkb" alt="" width="339"><figcaption></figcaption></figure>

{% hint style="info" %}
Some style elements won’t be visible when using Type 2, as it lacks a regular border. Features like border radius and box shadow won’t be applied in this layout.
{% endhint %}

#### Textarea

<figure><img src="/files/wd9OGz6pzzzexh6pSV0p" alt="" width="340"><figcaption></figcaption></figure>

* **Height**: Set the height of the textarea field to control how much text space is available.

#### Checkbox and Radio

<figure><img src="/files/dYnbHt5ZXmgBwHLpbcvi" alt="" width="337"><figcaption></figcaption></figure>

* **Checked**: Define the color that appears when a checkbox or radio button is selected.
* **Border Radius**: Set the roundness of the checkbox and radio button corners.

### Will Form Styling Apply to Other Form Plugins?

Kalium has been tested with the most well-known form plugins to ensure a seamless design experience. Even though these plugins have their own styling, Kalium will automatically select the necessary styling options so that our styles apply to each form.&#x20;

Make sure to select the **Theme Styled** option in your form plugin settings to make sure Kalium form styles are applied, no matter which plugin you're using.

The supported plugins include&#x20;

* Contact Form 7
* WPForms
* Fluent Forms
* Forminator
* Ninja Forms


# Layout

Layout options allow you to set the container size for the entire site and adjust block spacing.

To edit the layout options go to **Appearance** -> **Customizer** -> **Styling** -> **Layout**

### Container Width

There are three predefined widths you can set for the container size:&#x20;

* **Large -** Maximum width is 1296 pixels.
* **Medium** - *Default*, maximum width is 1116 pixels.
* **Small** - Maximum width is 936 pixels.
* **Custom** - User defined maximum width

<figure><img src="/files/S7EvzscCZsMKGVTQ9gtK" alt="" width="333"><figcaption><p>Container size controls</p></figcaption></figure>

If you want to set a full width for the container check the above option **Full Width Container** toggle.

### Block Spacing

Block Spacing controls the space between two blocks. It is especially useful for nested blocks, like images within a Gallery block. Setting the Block Spacing to zero removes the gap between blocks, while leaving it empty uses the default spacing.

You can choose between **8 predefined block spacings** but also set your preferred spacing value which is responsive friendly:

<figure><img src="/files/UJFfaovPTiZ6DGYfhJeA" alt="" width="331"><figcaption></figcaption></figure>

### Container Width on Single Page

If you want custom container size on page level (not entire site) you can do this by clicking **Edit Page** or  **Edit Post** (whatever single page):

Go to **Parameters and Options** -> **Page Options** -> **Other Settings**

<figure><img src="/files/dfC7le0O59eserGxEH2i" alt=""><figcaption><p>Setting custom container width for current page/post</p></figcaption></figure>

The same settings available in the Customizer are also found here.


# Link Styles

Links inside pages, blog posts and other related entry content can have custom link animation / style, which can be edited on **Appearance** -> **Customizer** -> **Styling** -> **Link Styles**

The default link style is Animated Underline which dates back from very first version of Kalium but you can change them to your preferred style and animation.

Every link style has its own set of options which you can set for individual styling.

### Standard

This type of link style is common on all websites. It makes plain links with default underline styling applied by the browser and has no custom options.

### Underline

This type of link style is more advanced in terms of appearance and options.&#x20;

It can be Static or Animated underline. You can set custom **direction** for underline animation, **thickness**, **position** and **color**.

A common option is to make everything go in reverse animation by toggling **Reverse State** option.

<figure><img src="/files/0F2ww2HCWjbDpxiWmFND" alt="" width="348"><figcaption><p>Underline link style options</p></figcaption></figure>

### Swap

This link style swaps the link in two directions **Top** and **Bottom**.

### Fill

This link style has two types: **Background** and **Text**.&#x20;

Background type sets the filling animation in specified direction: **top**, **bottom**, **left** and **right**.&#x20;

Text type animates the filling color inside text based horizontal direction **forwards** or **backwards**.

<figure><img src="/files/tokGL0qD9YlJuIfeDO3H" alt="" width="343"><figcaption><p>Fill link style options</p></figcaption></figure>


# Site Frame

Site frame is an optional feature that can be added to your site where it adds a border around your entire site. It is usually used by creative sites which want to have an unique experience of showcasing their services / products.

To enable the Site Frame go to **Appearance** -> **Customize** -> **Styling** -> **Site Frame** and click the toggle on the right to enable it:

<figure><img src="/files/ltgoZ0IhT1oYvDljrWHl" alt="" width="351"><figcaption><p>Enabling Site Frame</p></figcaption></figure>

There are variety of options that allow you to customize the look of the frame and the changes are shown on realtime while you edit them:

* **Color** - The color of the border.
* **Width** - The width of the border, responsive value.
* **Radius** - The radius of the border, responsive value.
* **Animation** - The entrance animation when the page first loads.
* **Duration** - The duration of animation (*in seconds*).
* **Delay** - The time to wait before animation starts (*in seconds*).
* **Visible On** - Toggle the device viewports where the site frame / border will be shown.

<figure><img src="/files/fFH7r4zE6tCZsA5tgHJK" alt=""><figcaption><p>Preview of the site frame while editing it</p></figcaption></figure>


# Translation introduction

At Laborator, we recognize that our theme should cater to a diverse, global audience. To accommodate this, we have built Kalium with translation in mind, ensuring that every word and sentence can be personalized to fit various languages and locales.

Whether your site is in a single language or supports multiple languages, Kalium provides flexible options for translation.

### Available Languages

Kalium comes with built-in support for 30 languages, so you can easily switch your site to one of these languages. The theme strings and words are translated for all these languages, but this does not mean that Kalium is limited to just these languages. The theme can be used with any language in the world, and you can translate it manually using tools which we'll mention later below.

The available languages include:

| :flag\_de: German       | :flag\_at: German *(AT)* | :flag\_ch: German *(CH)*     |
| ----------------------- | ------------------------ | ---------------------------- |
| :flag\_fr: French       | :flag\_es: Spanish       | :flag\_al: Albanian          |
| :flag\_it: Italian      | :flag\_nl: Dutch         | :flag\_be: Dutch *(BE)*      |
| :flag\_cn: Chinese (CN) | :flag\_jp: Japanese      | :flag\_kr: Korean            |
| :flag\_se: Swedish      | :flag\_gr: Greek         | :flag\_ru: Russian           |
| :flag\_pl: Polish       | :flag\_lt: Lithuanian    | :flag\_bg: Bulgarian         |
| :flag\_si: Slovenian    | :flag\_pt: Portuguese    | :flag\_br: Portuguese *(BR)* |
| :flag\_no: Norwegian    | :flag\_tr: Turkish       | :flag\_cz: Czech             |
| :flag\_fi: Finnish      | :flag\_sk: Slovak        | :flag\_ro: Romanian          |
| :flag\_hu: Hungarian    | :flag\_dk: Danish        | :flag\_ua: Ukrainian         |

To switch to one of the available languages:

1. Go to **Settings -> General** in your WordPress dashboard.
2. Change the **Site Language** to the desired language (e.g., Deutsch for German).
3. After a few minutes, check for updates under **Dashboard -> Updates**. Install the updates to apply the translations.

<figure><img src="/files/uKFsLZM1HsZYdUzHSIqy" alt=""><figcaption></figcaption></figure>

If you find any translation that doesn’t seem accurate, please report it on our [support forum](https://laborator.ticksy.com/).

***

### Single Language Sites

If your site operates in a single language, you’ll need to translate only the theme strings, you can use one of the following methods:

* **WordPress Plugin**: Use plugins like [Loco Translate](https://wordpress.org/plugins/loco-translate/) to translate strings directly from your WordPress dashboard. [Translating with Loco Translate](/translation/translating-with-loco-translate)
* **App**: Use applications like [Poedit](https://poedit.net/) to manually edit and translate the theme's `.po` files. [Translating with Poedit](/translation/translating-with-poedit)

These methods will help you translate and customize Kalium for any language.

***

### Multi-Lingual Sites

If you need your site to support multiple languages, you’ll need a multilingual plugin. There are several options available to help you achieve this:

* [**WPML**](https://kaliumtheme.com/go/wpml): A paid plugin that allows full translation of theme strings, pages, posts, and more. It’s thoroughly tested with Kalium and offers the most reliable experience. [Translating with WPML](/translation/translating-with-wpml)
* [**Polylang**](https://wordpress.org/plugins/polylang/): A freemium plugin offering basic multilingual features for free, with the option to unlock advanced functionalities through paid add-ons.
* [**Weglot**](https://kaliumtheme.com/go/weglot): This plugin provides instant translation with the option to manually adjust translations. It’s free for small sites, but you’ll need a paid plan for larger projects.

Each of these plugins can help you create a multilingual site, but for the best results, we recommend WPML due to its full compatibility and proven reliability with Kalium.

***

### Contributing to Translations

We are committed to making Kalium accessible in as many languages as possible, but translating the theme into every language is an ongoing effort. If you'd like to contribute to translating Kalium into a language that isn't fully supported yet or suggest improvements, we invite you to join our translation community:

1. Visit our [Kalium Translation Portal](https://translate.kaliumtheme.com/projects/kalium/) powered by GlotPress.
2. You can translate theme files directly through the platform or propose changes to existing translations.
3. Your contributions will be reviewed, and approved translations will be credited in the theme changelog.

Thank you for helping us enhance Kalium's accessibility for users around the world!




---

[Next Page](/llms-full.txt/1)

