Improving Initial Load

Improving initial load


Performance is an increasingly critical point in the creation of a store and, to ensure that your theme is within our best optimization practices, we created this course totally focused on points of improvement in a theme.

For this course, we can use a complete theme to focus only on points for improvement.

Clone the repository:

git clone

Fold block

Not all content on a page needs to be loaded first. Initially, when a user enters the store there is a limit on how much he can see. That is why with the __fold__ block you are able to control what will initially be seen, thus reducing the need to load data in the initial load . Automatically, what is below __fold__ is, then, loaded after the essentials are already available and the user starts to scroll down.


  1. Run a vtex workspace reset ensuring that no other themes are linked in the store

  2. Go to the cloned repository directory and link and then the offered theme:

    vtex link

    You should see the following store:


  3. The content below the Clearance shelf cannot be seen by the user, so let's optimize the first upload, postponing the fetching of this. To do this, in the home.jsonc file in the /store/blocks/home/ directory, add the __fold__ block just below the "shelf#clearance":

    "store.home": {
        "blocks": [
    +     "__fold__",

In your browser, then, run a CTRL (Cmd) + - (zooming out to be able to see the whole page) and notice that everything below theClearance is loaded after (as soon as the scroll is executed) to what is above:


Any questions?

See the answersheet for this step or check our [office hours] on the VTEX Developers channel(

Help us make this content better!

VTEX IO courses are open source. If you see something wrong, you can open a pull request!

Make a contribution

or open an issue