Enabling bypass to skip iSmartFrame optimizations or caching

By default, iSmartFrame optimizes and caches all pages and resources on your website. Its advanced caching algorithm allows the system to detect user actions such as logging in or any action that necessitates displaying the most up-to-date content on a page. This typically occurs when there is a non-GET or non-HEAD method operation performed on the page.

Note: Upon exiting the cache, only HTML resources will be presented to the user as up-to-date and without caching for that particular user. However, other static resources (such as CSS styles, images, JavaScripts, etc.) will still be served in their cached versions.

This implies that, for instance, when a user accesses their personal account, they can view and interact with their information in real-time, without iSmartFrame retaining any personal data. Nevertheless, there might be situations where it becomes necessary to bypass caching or all forms of manipulation performed by iSF for all users, whether they are logged in or anonymous, based on a specific condition.

To achieve this, iSF offers the bypass feature. When an area is bypassed, iSF acts solely as a reverse proxy, without caching content or applying optimizations and HTML manipulation.

Note: you can entirely bypass optimizations, caching, and any manipulation performed by iSmartFrame, but it is also possible to just skip caching while still retaining all optimizations.

Complete bypass

In the instance activation wizard, it is possible to configure certain areas to be entirely excluded from iSmartFrame (i.e., no caching and no optimization). These configurations can also be modified at a later time using the management dashboard. Please note that bypass configurations can only be set and modified by users with the necessary permissions on the respective website.

Setting up bypass configuration through the website setup wizard

In the instance activation wizard, there is a dedicated step called "CONFIGURE BYPASS FOR RESERVED AREAS" where you can perform the bypass configuration. Simply click the "Add" button and enter the URL or path of each page or area that needs to be bypassed. After adding all the desired pages and areas, click the "Next" button to save the configuration. You can later modify the list of bypassed pages and areas through a dedicated section in the dashboard.

Configuring bypass using the dashboard options

You have the ability to add, delete, or modify pages and areas in bypass through the dashboard. These actions can be performed in the "Configuration->General->Navigation" section. When you click the "Update" button within the "Soft Bypass Urls" box, the list of URLs and paths in bypass will be displayed. To add new entries, simply use the "Add" button. For modifying existing entries, update the values in the list. To delete entries, click the bin button on the right. Once all the necessary updates have been made, save the list by clicking the "Save configuration" button located in the top right corner.

Bypassing a single page

To bypass a single page, use the relative page path without the domain. For instance, if the full URL looks like this one:


The respective entry in the bypass configuration will be:


Bypassing an entire area

An area is defined by the relative path of a folder within the website structure. For example, to bypass all product pages, use the following entry:

To achieve a more flexible bypass, you can utilize Regular Expressions. In this scenario, it would look like this one --> .*?/products.*


This entry will bypass all pages with URLs containing "/product", such as:


You can add these settings using the two possible methods explained in the previous sections.

By following the aforementioned instructions, you can find an option within the dashboard that enables the exclusion of all manipulation and caching if a user has a specific Cookie configured while browsing your website. For instance, your website may utilize a designated cookie to identify logged-in users or those who have added items to their shopping cart. In such cases, you can specify the cookie's name to bypass iSmartFrame as well.

Cache-Only Bypass

iSmartFrame also provides the option to selectively bypass page caching while retaining optimizations. To enable this feature, you can follow the same steps mentioned earlier but navigate to the Cache section of the dashboard. Please note that all options, such as "Soft bypass URL," will now be labeled in a different way, e.g. "Bypass Cache by URL".

Last updated

All rights reserved © Akatop Technologies