Skip to main content

20 releases tagged with "faststore"

View All Tags

Β· 2 min read

Stores using FastStore have access to an image resizing and cropping service provided by VTEX, that caches the result on edge, which improves storefront performance.

VTEX is simplifying the domain layer of this capability in order to improve it. This means deprecating the current domain in favor of a new one.

What is changing?​

By the end of May 2023 the endpoint will stop working. The correct domain to use the image resizing and cropping feature is now {accountName}

Why are we making this change?​

VTEX has identified oportunities to improve performance that required the change of domain.

Namely, you can expect requests to this service to have decreased latency on cache misses, an increased cache hit ratio, and improved availability after implementing the new domain.

What needs to be done?​

You must replace all instances of for {accountName} in your FastStore project code by the end of May 2023. Otherwise your images may not be displayed correctly, returning a status 404 error.

Note that the new domain includes your account name.

See some examples of how to implement this replacements, considering a store with an account name of examplestore.

Old domainNew domain

Β· 2 min read

Gift, OrderSummary, SkuSelector, and CartItem components are now available in the FastStore UI. Also, updates to the FastStore API improve the shopping cart UX and allow adding user's session information to the orderForm.

FastStore UI​


  • πŸŽ‰ New component - #1443

    Use the Gift component to display promotional gift items.

    Gift component


  • πŸŽ‰ New component - #1456

    Use the OrderSummary component to provide a summary of the items in the cart, including the total price, related shipping tax, and discounts.

    OrderSummary component


  • πŸŽ‰ New component - #1462

    Use the SkuSelector component on Product Details Pages (PDPs) to display all SKUs available for a given product.

    SkuSelector component


  • πŸŽ‰ New component - #1461

    Use the CartItem component to display summarized data about an item placed in the shopping cart.

    CartItem component

FastStore API​

  • πŸ› Fixed "Buy 2 get 3" promotions - #1434

    Cart UX issues related to promotions, such as "Buy 2 get 3," have been fixed. Now, items and gifts are correctly combined when necessary.

    Cart discount

  • ✨ Product releaseDate now available - #1438

    The StoreProduct entity can now return the releaseDate of an item.

  • ✨ Session info now available as an argument of validateCart - #1444

    The validateCart mutation now accepts the session argument. This allows adding the user's session information to the orderForm, making the shopping flow consistent between storefront and checkout, and allowing for regionalized prices.


  • πŸŽ‰ New documentation feedback feature - #1448

    Documentation Feedback

New and improved docs​

Β· One min read

There are new and improved FastStore API guides available on our documentation portal:

What has changed?​

Previously, the GraphQL IDE guide focused on GraphiQL. However, GraphiQL is not natively supported by the Base Store starters anymore.

Now, you can still run your FastStore project locally and, although the new guide contains specific instructions for using graphql-playground, you may use your preferred GraphQL IDE.

In addition, now you can find more precise instructions and code examples of how to use the FastStore API in your storefront with the guides Fetching API data on the storefront and Extending the GraphQL schema.

Β· 3 min read
Ícaro Azevedo

In this article, we share our vision for the future of analytics on FastStore and invite you to share your thoughts.

Before we start, it's important to highlight that this is not a commitment to any of the following topics, and we have not yet planned when they will be implemented or even if they'll come to be. That being said, we envision an ever-evolving analytics solution for FastStore, and we count on you to build it together with us.

Universal Analytics​

We want to make it easy to migrate to FastStore, regardless of where you are coming from. To address that, we intend to support Universal Analytics on our official starters. We still plan to recommend and enforce Google Analytics 4 whenever possible. Still, we want to give our users and developers the time they need to fully understand and migrate to the new version of Google Analytics.

dataLayer completeness​

To create rich reports about ecommerce operations, collecting rich data is necessary. In Google Analytics and Google Tag Manager, this is done by pushing data to the dataLayer.

Currently, our official starters support only GA4 Enhanced Ecommerce capabilities. This is not enough for most stores, which need more data powering their reports. We want to address this issue.

There's no definitive answer for which properties we should include in our official starters' dataLayer by default, and that's why we want to hear from you.


Help us build the future of the Analytics SDK module by letting us know which are the most common properties and events you manually included in the dataLayer, why they're important and why they should be built into our starters.

Analytics libraries for store segments​

Grocery, fashion, and appliances are all store segments with specific needs regarding design, functionality, and, of course, analytics.

We believe it makes sense to have custom-built events targeted to specific store segments so these stores can fully understand the shoppers' behavior. For grocery, for example, we believe it would be helpful to know how many users try to enter their address, but there's no store near them or the most popular stores in a given area.

These libraries would be accompanied by extensive documentation explaining the meaning behind each event, when to fire them, which information is required, autocomplete, how to integrate it with Google Analytics, etc. Also, using these libraries would be optional.

Zooming out​

The Analytics SDK module, Partytown, and the built-in integration offered by our official starters make us really excited about our analytics solutions and what's to come. We have a great opportunity to offer our clients a delightful experience while still allowing them to explore options other than the ones we've established by default. The future can also look bright, and we want to hear from you: what would you like to see from the FastStore team regarding analytics?

Continue learning​

To continue learning, check our advanced guide about Analytics on FastStore.

Β· 5 min read

The search query has been enhanced to allow cross-selling and upselling of products. Also, the new subscribeToNewsletter mutation is now available in the FastStore API. In the FastStore UI, the Slider and PriceRange components now allow ref forwarding.

Β· 4 min read

The FastStore UI now includes the Hero and Dropdown components. Also, the FastStore API was enhanced to better support page error handling. Global changes were also implemented to enable price range filtering on PLPs.

Β· 3 min read

New OutOfStock and ProductCard components added to the FastStore UI. Also, improvements in the FastStore API now allow fetching additional properties of a product.

Β· One min read

We've recently changed the configurations needed for the secure subdomain. Hence, if you come across the "This connection is not private" error while trying to complete an order at your store website, check if your website's secure subdomain is pointing to secure.{hostname}, where {hostname} is the complete address of your store.

What has changed?​

The secure subdomain must now point to secure.{hostname}, where {hostname} is the complete address of your store. Before, the secure subdomain was being pointed to {account}

What needs to be done?​

If you come across the "This connection is not private" error in your store website, repeat the Hosting a FastStore + VTEX website guide, making sure that the secure subdomain is pointing to secure.{hostname}

Β· One min read

FastStore API reference documentation is now available. You can check it now via the GraphiQL IDE.

What has changed?​

While working on your FastStore website, you can run your project locally and use GraphiQL to explore the API. Now, when you do this you will see that each type, argument, query and mutation has an associated description.

What needs to be done?​

To explore the FastStore API reference documentation, follow these steps:

  1. Run yarn in your project to reinstall the @faststore/api dependency.
  2. Run yarn develop to start a local server.
  3. Access GraphiQL by going to this address:
  1. Click on the Docs button on the upper right corner.
  2. On the docs tab you can browse through the definitions or search for types by name.

Screen capture of the procedure described above.

Β· 4 min read

The FastStore API no longer includes unused Gatsby plugins and now handles channel as a facet for search and product queries. Also, check out the new Troubleshooting guides and the Starter submission form.