[System] You are a VTEX documentation expert. You provide accurate, detailed information about VTEX platform, APIs, apps, and Store Framework development.

[User] Provide a guide on guides login integration guide in VTEX.

[Assistant]
Documentation

[Feedback](https://read.calvincode.net/reader?url=https://docs.google.com/forms/d/e/1FAIpQLSfmnotPvPjw-SjiE7lt2Nt3RQgNUe10ixXZmuO2v9enOJReoQ/viewform?entry.1972292648=developers.vtex.com%26entry.1799503232=)

[GuidesLearn how to use our APIs and extend the VTEX platform.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides)

[API ReferenceExplore detailed information about our endpoints.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/api-reference)

[App DevelopmentLearn how to build cloud-based apps and integrations.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/app-development)

[Storefront DevelopmentExpress your brand identity creating unique storefronts.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/storefront-development)

[VTEX IO AppsFind pre-built solutions to grow your business.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/vtex-io-apps)

[TroubleshootingFind practical solutions to common development issues.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/troubleshooting)

[Release NotesStay up to date with our latest releases and bug fixes.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/updates/release-notes)

Guides

[VTEX Platform Overview](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/vtex-platform-overview)

---

[API usage](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/api-usage)

---

[Getting started](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/getting-started)

---

Integration Guides

[Back office integration guide (ERP/PIM/WMS)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/erp-integration-guide)

[Customer Credit](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/customer-credit-integration-guide)

[External Marketplace](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/external-marketplace-integration-guide)

[External Seller](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/external-seller-integration-guide)

[Gift Card](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/gift-card-integration-guide)

[Headless commerce](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/headless-commerce)

[Login (SSO)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/login-integration-guide)

[Admin (SAML 2.0)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/login-integration-guide-admin-saml2)

[Webstore (OAuth 2.0)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/login-integration-guide-webstore-oauth2)

[Punchout](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/punchout)

[Offer Management Integration Guide](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/sent-offers-integration-guide-connectors)

[Payments](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/payments-integration-guide)

[Search Protocol](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/search-integration-guide)

[Session Manager](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/session-manager)

[Tax Service](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/tax-service-integration-guide)

[Pricing Hub](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/pricing-hub)

[reCAPTCHA](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/recaptcha)

---

[Catalog](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/catalog-integration)

---

[Checkout](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/checkout-api-overview)

---

[Master Data](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/master-data)

---

Payments

---

Orders

---

Logistics

---

B2B Suite

---

VTEX Sales App

---

UI Customization

---

Message Center

---

Pricing

---

Promotions

---

Infrastructure

---

Search

---

Storefront Permissions

---

[VTEX Activity Flow](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/activity-flow)

---

[VTEX Ads](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/vtex-ads)

---

VTEX Session

---

VTEX Shield

---

[Data Protection Plus](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/data-protection-plus)

---

Weni by VTEX

---

[Guides](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides)

[API Reference](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/api-reference)

[App Development](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/app-development)

[Storefront Development](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/storefront-development)

[VTEX IO Apps](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/vtex-io-apps)

[Troubleshooting](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/troubleshooting)

---

[Release Notes](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/updates/release-notes)

Guides

[VTEX Platform Overview](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/vtex-platform-overview)

---

[API usage](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/api-usage)

---

[Getting started](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/getting-started)

---

Integration Guides

[Back office integration guide (ERP/PIM/WMS)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/erp-integration-guide)

[Customer Credit](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/customer-credit-integration-guide)

[External Marketplace](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/external-marketplace-integration-guide)

[External Seller](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/external-seller-integration-guide)

[Gift Card](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/gift-card-integration-guide)

[Headless commerce](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/headless-commerce)

[Login (SSO)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/login-integration-guide)

[Admin (SAML 2.0)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/login-integration-guide-admin-saml2)

[Webstore (OAuth 2.0)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/login-integration-guide-webstore-oauth2)

[Punchout](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/punchout)

[Offer Management Integration Guide](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/sent-offers-integration-guide-connectors)

[Payments](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/payments-integration-guide)

[Search Protocol](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/search-integration-guide)

[Session Manager](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/session-manager)

[Tax Service](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/tax-service-integration-guide)

[Pricing Hub](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/pricing-hub)

[reCAPTCHA](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/recaptcha)

---

[Catalog](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/catalog-integration)

---

[Checkout](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/checkout-api-overview)

---

[Master Data](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/master-data)

---

Payments

---

Orders

---

Logistics

---

B2B Suite

---

VTEX Sales App

---

UI Customization

---

Message Center

---

Pricing

---

Promotions

---

Infrastructure

---

Search

---

Storefront Permissions

---

[VTEX Activity Flow](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/activity-flow)

---

[VTEX Ads](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/vtex-ads)

---

VTEX Session

---

VTEX Shield

---

[Data Protection Plus](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/data-protection-plus)

---

Weni by VTEX

---

[Guides](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides)

Integration Guides

[Login (SSO)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/login-integration-guide)

Login (SSO)

To integrate an external identity provider in VTEX, you should first understand the basics of how our identity and access management services work. This article provides the main concepts and restrictions to get you started. After reading through it, you should move on to the [Webstore (OAuth2)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide-webstore-oauth2) or [Admin (SAML 2.0)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide-admin-saml2) articles for their implementation details.

## Identity and Access Management (IAM)

**VTEX ID** is the service used for identifying users on our platform. Web browsers and mobile apps interact with it to obtain an authentication token for a specific user. Receiving this token is what warrants that a user is "logged in", as it is used to communicate with services requiring authentication.

An **audience** is the context in which VTEX ID is used. It defines the business rules and the type of persona that will interact with the module. We currently have two scopes:

* **Admin** for access to a VTEX admin panel
* **Webstore** for access to a VTEX storefront

Upon receiving an authentication token, applications can use it to verify if the user has a specific set of permissions by interacting with the service responsible for access management: **License Manager**.

We will not cover access management in this guide, but you can read more about roles in our [Help Center article](https://read.calvincode.net/reader?url=https://help.vtex.com/tutorial/access-profiles--7HKK5Uau2H6wxE1rH5oRbc).

> If you are already familiar with the [OAuth 2.0 specification](https://read.calvincode.net/reader?url=https://oauth.net/2/scope/), feel free to make this association if you find it helpful.

### Admin

This is the audience used for dealing with users that need to access the administrative interface. Each component inside the admin panel requires different permissions, which are fully managed by the [Sponsor user](https://read.calvincode.net/reader?url=https://help.vtex.com/tutorial/what-is-the-master-user--3oPr7YuIkEYqUGmEqIMSEy) of your VTEX account using [roles](https://read.calvincode.net/reader?url=https://help.vtex.com/tutorial/access-profiles--7HKK5Uau2H6wxE1rH5oRbc). The token generated by VTEX ID in this scope can be used for [authentication with most VTEX APIs](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/getting-started-authentication).

### Webstore

This is the audience used for ecommerce stores to identify customers throughout their shopping experience. Users in this scope can sign-in using credentials they already have, which may be shared between different stores or platforms you manage. The token generated by VTEX ID in this scope can be used to interact with the store checkout and storefront apps.

## Comparison chart

| Admin                       | Webstore                                                                                |                                                                                |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
| Integration protocol        | SAML 2.0                                                                                | OAuth 2.0                                                                                |
| Cookie name                 | VtexIdclientAutCookie                                                                                | VtexIdclientAutCookie\_{accountName} VtexIdclientAutCookie\_{accountId}                                                        |
| Multi-factor authentication | ![Supported](https://read.calvincode.net/reader?url=https://images.ctfassets.net/alneenqid6w5/7LUDORO5lzJLTAOnP6pHi9/162b4e9a129442d9d5df7713ee549725/image10.png)    | ![Not available](https://read.calvincode.net/reader?url=https://images.ctfassets.net/alneenqid6w5/5CFfntd5BUumDCmdeGxwMo/0c838aa06775580b4e1ed0acf892ff52/image2.png) |
| Idle timeout                | ![Supported](https://read.calvincode.net/reader?url=https://images.ctfassets.net/alneenqid6w5/7LUDORO5lzJLTAOnP6pHi9/162b4e9a129442d9d5df7713ee549725/image10.png)    | ![Not available](https://read.calvincode.net/reader?url=https://images.ctfassets.net/alneenqid6w5/5CFfntd5BUumDCmdeGxwMo/0c838aa06775580b4e1ed0acf892ff52/image2.png) |
| Google Login                | ![Supported](https://read.calvincode.net/reader?url=https://images.ctfassets.net/alneenqid6w5/7LUDORO5lzJLTAOnP6pHi9/162b4e9a129442d9d5df7713ee549725/image10.png)    | ![Supported](https://read.calvincode.net/reader?url=https://images.ctfassets.net/alneenqid6w5/7LUDORO5lzJLTAOnP6pHi9/162b4e9a129442d9d5df7713ee549725/image10.png)    |
| Facebook Login              | ![Not available](https://read.calvincode.net/reader?url=https://images.ctfassets.net/alneenqid6w5/5CFfntd5BUumDCmdeGxwMo/0c838aa06775580b4e1ed0acf892ff52/image2.png) | ![Supported](https://read.calvincode.net/reader?url=https://images.ctfassets.net/alneenqid6w5/7LUDORO5lzJLTAOnP6pHi9/162b4e9a129442d9d5df7713ee549725/image10.png)    |

Contributors

2

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F60782333%3Fv%3D4%26w=64%26q=75)](https://github.com/carolinamenezes)

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F7108339%3Fv%3D4%26w=64%26q=75)](https://github.com/brunoamui)

Was this helpful?

Yes

No

[Suggest Edits (GitHub)](https://read.calvincode.net/reader?url=https://github.com/vtexdocs/dev-portal-content/edit/main/docs/guides/Integration-Guides/login-integration-guide.md)

[Headless profile management and order history« Previous](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide//docs/guides/headless-profile-management-and-order-history)[Admin (SAML 2.0)Next »](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide//docs/guides/login-integration-guide-admin-saml2)

Contributors

2

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F60782333%3Fv%3D4%26w=64%26q=75)](https://github.com/carolinamenezes)

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F7108339%3Fv%3D4%26w=64%26q=75)](https://github.com/brunoamui)

ON THIS PAGE

[Identity and Access Management (IAM)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/login-integration-guide%23identity-and-access-management-iam)

[Admin](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/login-integration-guide%23admin)[Webstore](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/login-integration-guide%23webstore)

[Comparison chart](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/login-integration-guide%23comparison-chart)

Was this helpful?

 Send feedback

[Suggest edits (GitHub)](https://read.calvincode.net/reader?url=https://github.com/vtexdocs/dev-portal-content/edit/main/docs/guides/Integration-Guides/login-integration-guide.md)

Copy page

On this page

ON THIS PAGE

[Identity and Access Management (IAM)](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/login-integration-guide%23identity-and-access-management-iam)

[Admin](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/login-integration-guide%23admin)[Webstore](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/login-integration-guide%23webstore)

[Comparison chart](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/login-integration-guide/docs/guides/login-integration-guide%23comparison-chart)

On this page

[Github](https://read.calvincode.net/reader?url=https://github.com/vtex-apps)[Help Center](https://read.calvincode.net/reader?url=https://help.vtex.com/)[Community](https://read.calvincode.net/reader?url=https://community.vtex.com/?%5Fga=2.198523433.743584735.1647618303-1974737580.1645714642)[Feedback](https://read.calvincode.net/reader?url=https://docs.google.com/forms/d/e/1FAIpQLSfmnotPvPjw-SjiE7lt2Nt3RQgNUe10ixXZmuO2v9enOJReoQ/viewform?entry.1972292648=developers.vtex.com%26entry.1799503232=)


[System] You are a VTEX documentation expert. You provide accurate, detailed information about VTEX platform, APIs, apps, and Store Framework development.

[User] Explain troubleshooting the price in the shelf or in the search results is different from the product page in VTEX.

[Assistant]
Documentation

[Feedback](https://read.calvincode.net/reader?url=https://docs.google.com/forms/d/e/1FAIpQLSfmnotPvPjw-SjiE7lt2Nt3RQgNUe10ixXZmuO2v9enOJReoQ/viewform?entry.1972292648=developers.vtex.com%26entry.1799503232=)

[GuidesLearn how to use our APIs and extend the VTEX platform.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/guides)

[API ReferenceExplore detailed information about our endpoints.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/api-reference)

[App DevelopmentLearn how to build cloud-based apps and integrations.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/app-development)

[Storefront DevelopmentExpress your brand identity creating unique storefronts.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/storefront-development)

[VTEX IO AppsFind pre-built solutions to grow your business.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/vtex-io-apps)

[TroubleshootingFind practical solutions to common development issues.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting)

[Release NotesStay up to date with our latest releases and bug fixes.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/updates/release-notes)

Troubleshooting

API

---

Development

[I am getting 500 errors in VTEX IO CLI](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/i-am-getting-500-errors-in-vtex-io-cli)

[I am getting errors with my service configuration app](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/i-am-getting-errors-with-my-service-configuration-app)

[Issues during extending the FastStore API schema](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/issues-during-extending-the-faststore-api-schema)

[I can’t access the Headless CMS](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/unable-to-access-headless-cms)

[I can’t install the Headless CMS plugins in my account](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/i-cant-install-the-headless-cms-plugins-in-my-account)

[I can't install VTEX IO CLI](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/i-cant-install-vtex-io-cli)

[I can’t integrate my external Search Provider](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/i-cant-integrate-my-external-search-provider)

[My multi-language store is not functioning in the development workspace](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/my-multi-language-store-is-not-working-in-the-development-workspace)

[My store catalog does not display the price range filter](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/my-store-catalog-does-not-show-the-price-range-filter)

[My pages are taking too long to be published on Headless CMS](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/my-pages-are-taking-too-long-to-be-published-on-headless-cms)

[My store does not reflect the overrides I created](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/my-store-does-not-reflect-the-overrides-i-created)

[Modal Layout closes when I click a SKU](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/modal-layout-closes-when-i-click-a-sku)

[The Price in the shelf or in the search results is different from the product page](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page)

[The promotion highlight flag does not appear on the product](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/the-promotion-highlight-flag-does-not-appear-on-the-product)

[vtex release CLI command returns an EBADF message](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/vtex-release-cli-command-returns-ebadf-message)

[I can't create a new workspace](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/i-cant-create-a-new-workspace)

[I can't install an app with a major other than 0.x](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/i-cant-install-an-app-with-a-major-other-than-0x)

[I don't see my Store Theme changes](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/i-dont-see-my-store-theme-changes)

---

Store performance

---

[Guides](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/guides)

[API Reference](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/api-reference)

[App Development](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/app-development)

[Storefront Development](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/storefront-development)

[VTEX IO Apps](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/vtex-io-apps)

[Troubleshooting](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting)

---

[Release Notes](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/updates/release-notes)

Troubleshooting

API

---

Development

[I am getting 500 errors in VTEX IO CLI](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/i-am-getting-500-errors-in-vtex-io-cli)

[I am getting errors with my service configuration app](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/i-am-getting-errors-with-my-service-configuration-app)

[Issues during extending the FastStore API schema](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/issues-during-extending-the-faststore-api-schema)

[I can’t access the Headless CMS](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/unable-to-access-headless-cms)

[I can’t install the Headless CMS plugins in my account](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/i-cant-install-the-headless-cms-plugins-in-my-account)

[I can't install VTEX IO CLI](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/i-cant-install-vtex-io-cli)

[I can’t integrate my external Search Provider](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/i-cant-integrate-my-external-search-provider)

[My multi-language store is not functioning in the development workspace](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/my-multi-language-store-is-not-working-in-the-development-workspace)

[My store catalog does not display the price range filter](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/my-store-catalog-does-not-show-the-price-range-filter)

[My pages are taking too long to be published on Headless CMS](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/my-pages-are-taking-too-long-to-be-published-on-headless-cms)

[My store does not reflect the overrides I created](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/my-store-does-not-reflect-the-overrides-i-created)

[Modal Layout closes when I click a SKU](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/modal-layout-closes-when-i-click-a-sku)

[The Price in the shelf or in the search results is different from the product page](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page)

[The promotion highlight flag does not appear on the product](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/the-promotion-highlight-flag-does-not-appear-on-the-product)

[vtex release CLI command returns an EBADF message](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/vtex-release-cli-command-returns-ebadf-message)

[I can't create a new workspace](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/i-cant-create-a-new-workspace)

[I can't install an app with a major other than 0.x](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/i-cant-install-an-app-with-a-major-other-than-0x)

[I don't see my Store Theme changes](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/i-dont-see-my-store-theme-changes)

---

Store performance

---

[Troubleshooting](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting)

Development

The Price in the shelf or in the search results is different from the product page

Inconsistent pricing when comparing shelves or search results with product pages in stores using Intelligent Search.

**Keywords:** Price | PDP | Product | SKU | Shelf | Search | Search Result | Promotion

When [updating a SKU price](https://read.calvincode.net/reader?url=https://help.vtex.com/en/tutorial/alteracao-de-preco-de-sku--tutorials%5F95) or applying a [promotion](https://read.calvincode.net/reader?url=https://help.vtex.com/en/tracks/promotion--6asfF1vFYiZgTQtOzwJchR), the price on the shelf or in the search results might differ from the price on the product page. This issue can happen in [Store Framework](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/store-framework) stores using the [Search Result](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.search-result) component in the [store theme](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/vtex-io-documentation-3-settingyourstoretheme). This component receives and renders search results from [Intelligent Search](https://read.calvincode.net/reader?url=https://help.vtex.com/en/tracks/vtex-intelligent-search--19wrbB7nEQcmwzDPl1l4Cb).

The Search Result component's configuration, specifically setting the `simulationBehavior` property to `skip`, can cause outdated prices to display in shelves and search results. This occurs because this configuration makes the component rely on cached data rather than fetching the latest price updates.

> The `skip` setting is only recommended for stores where prices are not updated frequently and promotions are not used often. In these cases, this configuration can increase loading speed by displaying cached information. Learn more in [Displaying asynchronous prices](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/vtex-io-documentation-displaying-asynchronous-prices).

## Solution

To ensure consistent and up-to-date pricing across your store, follow the instructions below:

1. Locate the theme files that define the [Search Result](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/apps/vtex.search-result) component.
2. Locate the `simulationBehavior` property in your theme’s code, as in the example below. You can also find an example in the [store theme boilerplate](https://read.calvincode.net/reader?url=https://github.com/vtex-apps/store-theme/blob/main/store/blocks/search.jsonc) repository.
`1
"store.search": {
2
 "blocks": [
3
 "search-result-layout"
4
 ],
5
 "props": {
6
 "context": {
7
 "simulationBehavior": "skip"
8
 }
9
 }
10
}
`
3. Change the value of `simulationBehavior` from `skip` to `default`, as in the example below. This adjustment instructs the component always to fetch the latest data, eliminating the discrepancy caused by cached information.
`1
"store.search": {
2
 "blocks": [
3
 "search-result-layout"
4
 ],
5
 "props": {
6
 "context": {
7
 "simulationBehavior": "default"
8
 }
9
 }
10
}
`
4. Run `vtex link` to see your changes reflected in the workspace.

Make sure this change is applied consistently across all instances of the Search Result component used throughout your store's theme.

Contributors

2

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F60782333%3Fv%3D4%26w=64%26q=75)](https://github.com/carolinamenezes)

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F77292838%3Fv%3D4%26w=64%26q=75)](https://github.com/julia-rabello)

Was this helpful?

Yes

No

[Suggest Edits (GitHub)](https://read.calvincode.net/reader?url=https://github.com/vtexdocs/dev-portal-content/edit/main/docs/troubleshooting/development/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page.md)

[Modal Layout closes when I click a SKU« Previous](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/modal-layout-closes-when-i-click-a-sku)[The promotion highlight flag does not appear on the productNext »](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/the-promotion-highlight-flag-does-not-appear-on-the-product)

Contributors

2

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F60782333%3Fv%3D4%26w=64%26q=75)](https://github.com/carolinamenezes)

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F77292838%3Fv%3D4%26w=64%26q=75)](https://github.com/julia-rabello)

ON THIS PAGE

[Solution](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page%23solution)

Was this helpful?

 Send feedback

[Suggest edits (GitHub)](https://read.calvincode.net/reader?url=https://github.com/vtexdocs/dev-portal-content/edit/main/docs/troubleshooting/development/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page.md)

Copy page

On this page

ON THIS PAGE

[Solution](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page/docs/troubleshooting/the-price-in-the-shelf-or-in-the-search-results-is-different-from-the-product-page%23solution)

On this page

[Github](https://read.calvincode.net/reader?url=https://github.com/vtex-apps)[Help Center](https://read.calvincode.net/reader?url=https://help.vtex.com/)[Community](https://read.calvincode.net/reader?url=https://community.vtex.com/?%5Fga=2.198523433.743584735.1647618303-1974737580.1645714642)[Feedback](https://read.calvincode.net/reader?url=https://docs.google.com/forms/d/e/1FAIpQLSfmnotPvPjw-SjiE7lt2Nt3RQgNUe10ixXZmuO2v9enOJReoQ/viewform?entry.1972292648=developers.vtex.com%26entry.1799503232=)


[System] You are a VTEX documentation expert. You provide accurate, detailed information about VTEX platform, APIs, apps, and Store Framework development.

[User] Provide a guide on guides faststore building sections creating a new section in VTEX.

[Assistant]
Documentation

[Feedback](https://read.calvincode.net/reader?url=https://docs.google.com/forms/d/e/1FAIpQLSfmnotPvPjw-SjiE7lt2Nt3RQgNUe10ixXZmuO2v9enOJReoQ/viewform?entry.1972292648=developers.vtex.com%26entry.1799503232=)

[GuidesLearn how to use our APIs and extend the VTEX platform.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides)

[API ReferenceExplore detailed information about our endpoints.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/api-reference)

[App DevelopmentLearn how to build cloud-based apps and integrations.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/app-development)

[Storefront DevelopmentExpress your brand identity creating unique storefronts.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/storefront-development)

[VTEX IO AppsFind pre-built solutions to grow your business.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/vtex-io-apps)

[TroubleshootingFind practical solutions to common development issues.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/troubleshooting)

[Release NotesStay up to date with our latest releases and bug fixes.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/updates/release-notes)

Storefront Development

[Getting started with storefront solutions](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/getting-started-with-storefront-solutions)

---

[FastStore](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore)

[FastStore versions and support levels](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/getting-started-faststore-versions-and-support-levels)

[Getting Started](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/getting-started-overview)

[FastStore WebOps](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/webops-dashboard)

[Headless CMS](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/headless-cms-overview)

[Developer tools and references](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developer-tools-overview)

[Styling](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/styling-overview)

[UI components](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/components-index)

[Implementing storefront features](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/storefront-features-overview)

[FastStore API](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/faststore-api-overview)

[FastStore SDK](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/sdk-overview)

[Developing and overriding UI components](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-overview)

[Section override](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/overrides-overview)

[Section override - Use cases](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/override-use-cases-overview)

[Creating a new section](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-creating-a-new-section)

[List of native sections and overridable components](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-list-of-native-sections)

[Experimental exports - Hooks and Components](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-experimental-exports-hooks-and-components)

[Extending the FastStore API](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/api-extensions-overview)

[Managing URLs with redirects and rewrite paths](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/routing-managing-urls-with-redirects-and-rewrite-paths)

[Managing performance](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/managing-performance-overview)

[SEO](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/seo-overview)

[Going live](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/go-live-overview)

[Troubleshooting](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/troubleshooting-overview)

---

[Store Framework](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/store-framework)

---

(Legacy) CMS Portal

---

[Storefront best practices](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/storefront-best-practices)

---

[Guides](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides)

[API Reference](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/api-reference)

[App Development](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/app-development)

[Storefront Development](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/storefront-development)

[VTEX IO Apps](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/vtex-io-apps)

[Troubleshooting](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/troubleshooting)

---

[Release Notes](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/updates/release-notes)

Storefront Development

[Getting started with storefront solutions](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/getting-started-with-storefront-solutions)

---

[FastStore](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore)

[FastStore versions and support levels](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/getting-started-faststore-versions-and-support-levels)

[Getting Started](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/getting-started-overview)

[FastStore WebOps](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/webops-dashboard)

[Headless CMS](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/headless-cms-overview)

[Developer tools and references](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developer-tools-overview)

[Styling](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/styling-overview)

[UI components](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/components-index)

[Implementing storefront features](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/storefront-features-overview)

[FastStore API](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/faststore-api-overview)

[FastStore SDK](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/sdk-overview)

[Developing and overriding UI components](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-overview)

[Section override](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/overrides-overview)

[Section override - Use cases](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/override-use-cases-overview)

[Creating a new section](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-creating-a-new-section)

[List of native sections and overridable components](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-list-of-native-sections)

[Experimental exports - Hooks and Components](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-experimental-exports-hooks-and-components)

[Extending the FastStore API](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/api-extensions-overview)

[Managing URLs with redirects and rewrite paths](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/routing-managing-urls-with-redirects-and-rewrite-paths)

[Managing performance](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/managing-performance-overview)

[SEO](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/seo-overview)

[Going live](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/go-live-overview)

[Troubleshooting](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/troubleshooting-overview)

---

[Store Framework](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/store-framework)

---

(Legacy) CMS Portal

---

[Storefront best practices](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/storefront-best-practices)

---

[Storefront development](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/storefront-development)

[FastStore](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore)

[Developing and overriding UI components](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-overview)

Creating a new section

In this guide, you will learn how to create a new section for your storefront and make it available in the [Headless CMS](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/headless-cms-overview). This solution is useful when your project requires a section not natively available in FastStore.

For this guide, we will create two sections:

* `Call to Action` Gets a specific action from the user.
* `OurStores`: Indicates the closest store for the user.
> Sections are page components that wrap up other components, enabling you to create cohesive and functional content for your store. For example, the Hero section is a native section that includes the following components: `Hero`, `HeroImage`, and `HeroHeader`.

## Before you begin

### 1\. Integrate the store with the Headless CMS

All sections must be available in the Headless CMS so they can be added and managed on your store's pages. To integrate your FastStore project, please refer to the [Headless CMS integration track](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/headless-cms-1-configuring-the-vtex-account).

### 2\. Knowledge of how sections and content types work on Headless CMS

During the creation of a new section, you will create files such as `sections.json` and `content-types.json`, which follow a structure established for the Headless CMS.

### 3\. Install the FastStore CLI

Make sure to install the FastStore CLI to use its commands locally. Refer to the [FastStore CLI](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/getting-started-3-faststore-cli) guide for more information.

## `Call to Action`

### Step 1: Creating folders and files related to the Headless CMS

1. In the FastStore root directory, create a folder named `cms`.
2. Inside `cms`, create the `faststore` folder.
3. Within the `cms/faststore` folder, create `sections.json` file.
4. In the `sections.json` file, add the new section that you want to display in the Headless CMS. The schema below defines how the Headless CMS renders a section:

sections.json

`1

 [

2

 {

3

 "name": "CallToAction",

4

 "schema": {

5

 "title": "Call To Action",

6

 "description": "Get your 20% off on the first purchase!",

7

 "type": "object",

8

 "required": [

9

 "title",

10

 "link"

11

 ],

12

 "properties": {

13

 "title": {

14

 "title": "Title",

15

 "type": "string"

16

 },

17

 "link": {

18

 "title": "Link Path",

19

 "type": "object",

20

 "required": [

21

 "text",

22

 "url"

23

 ],

24

 "properties": {

25

 "text": {

26

 "title": "Text",

27

 "type": "string"

28

 },

29

 "url": {

30

 "title": "URL",

31

 "type": "string"

32

 }

33

 }

34

 }

35

 }

36

 }

37

 }

38

 ]

`

> This new section receives a title and a link pointing to a specific location.

### Step 2: Creating the new section

To render the `CallToAction` section you created in the previous step, you need to create this section component.

1. If you don't already have it, create a folder named `components` inside the `src` directory.
2. Inside the `components` folder, create a file named `CallToAction.tsx` and add the following code:

src/components/CallToAction.tsx

`1

import React from "react";

2

3

export interface CallToActionProps {

4

 title: string;

5

 link: {

6

 text: string;

7

 url: string;

8

 };

9

}

10

11

export default function CallToAction(props: CallToActionProps) {

12

 return (

13

14

{props.title}

15

 {props.link.text}

16

17

 );

18

}

`

This section will receive the `link` and `title` defined previously in the `sections.json` file.

1. Create a file named `index.tsx` inside the components folder.

> The `index.tsx` file provides an entry point for importing and using the `CallToAction` component. It acts as a container for all the components within the components folder and allows for easier organization and reusability of code.

Open the `index.tsx` file and add the following code:

src/components/index.tsx

`1

import CallToAction from './CallToAction'

2

3

export default { CallToAction }

`

### Step 3: Synchronizing the new section with the Headless CMS

1. In the terminal, run `faststore cms-sync`. This command will synchronize the new section you created with the CMS.
2. Go to the VTEX Admin and access **Storefront > Headless CMS**.
3. Click on the `Page` content type.

![{"base64":"  ","img":{"width":3824,"height":1360,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":321106,"url":"https://vtexhelp.vtexassets.com/assets/docs/src/create-new-section-cms___51aed56fb1be8d73c2fee14e54151c3d.png"}}](https://read.calvincode.net/reader?url=https://vtexhelp.vtexassets.com/assets/docs/src/create-new-section-cms___51aed56fb1be8d73c2fee14e54151c3d.png)

1. In the `Sections` tab, click the `+`, search for the new `Call to Action` section, and add it to your page.

![{"base64":"  ","img":{"width":1898,"height":736,"type":"gif","mime":"image/gif","wUnits":"px","hUnits":"px","length":928366,"url":"https://vtexhelp.vtexassets.com/assets/docs/src/create-new-section-cms-component___994587c4fa77d99a04fda72524266d4d.gif"}}](https://read.calvincode.net/reader?url=https://vtexhelp.vtexassets.com/assets/docs/src/create-new-section-cms-component___994587c4fa77d99a04fda72524266d4d.gif)

## `OurStore`

1. After [creating the files and folders](#step-1-creating-folders-and-files-related-to-the-headless-cms), In the `sections.json` file, add the new section that you want to display in the Headless CMS. The schema below defines how the Headless CMS renders the `OurStores` section that we will use in the example:

sections.json

`1

[

2

 {

3

 "name": "OurStores",

4

 "schema": {

5

 "title": "Our Stores",

6

 "description": "Search stores near to the users",

7

 "type": "object",

8

 "required": ["title", "description"],

9

 "properties": {

10

 "title": {

11

 "title": "Title",

12

 "type": "string",

13

 "default": "Explore Nearby Stores"

14

 },

15

 "description": {

16

 "title": "Link Path",

17

 "type": "string",

18

 "default": "Discover the closest store to you and pay us a visit."

19

 }

20

 }

21

 }

22

 }

23

]

`

1. Inside the `components` folder, create a file named `OurStores.tsx` and add the following code:

src/components/OurStores.tsx

`1

import React from 'react'

2

import { Button, Icon, SelectField } from '@faststore/ui'

3

4

export interface OurStoresProps {

5

 title: string

6

 description: string

7

}

8

9

export default function OurStores(props: OurStoresProps) {

10

 return (

11

12

{props.title}

13

{props.description}

14

15

 <SelectField

16

 id="select-state-store"

17

 label="State:"

18

 options={{

19

 newYork: 'New York',

20

 arizona: 'Arizona',

21

 massachusetts: 'Massachusetts',

22

 hawaii: 'Hawaii',

23

 }}

24

 />

25

 <SelectField

26

 id="select-city-store"

27

 label="City:"

28

 options={{

29

 newYorkCity: 'New York City',

30

 phoenix: 'Phoenix',

31

 boston: 'Boston',

32

 honolulu: 'Honolulu',

33

 }}

34

 />

35

 <Button

36

 variant="secondary"

37

 icon={<Icon name="ArrowRight" />}

38

 iconPosition="right"

39

 >

40

 Find Store

41

 </Button>

42

43

44

 )

45

}

`

For this section, we will use the following components from the Faststore UI: [Button](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/atoms-button), [Icon](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/atoms-icon) and [SelectField](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules/select-field).

1. Create a file named `index.tsx` inside the components folder, and add the following code:

src/components/index.tsx

`1

import OurStores from './OurStores'

2

3

export default { OurStores }

`

1. Repeat the steps in [Step 3: Synchronizing the new section with the Headless CMS](#step3-synchronizing-the-new-section-with-the-headless-cms), and you should see the new section but without styles as in the example below:

![{"base64":"  ","img":{"width":1144,"height":175,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":24240,"url":"https://vtexhelp.vtexassets.com/assets/docs/src/section-structure-without-styles___7be40088d6137bdd63cbb4940c2fa599.png"}}](https://read.calvincode.net/reader?url=https://vtexhelp.vtexassets.com/assets/docs/src/section-structure-without-styles___7be40088d6137bdd63cbb4940c2fa599.png)

To add styles to `OurStore`, refer to the following section [Importing styles when creating a new section](#importing-styles-when-creating-a-new-section).

## Adding styles to a new section

After creating a new section, you can style it to match your store's branding. Follow the steps below using the [OurStores](#ourstores) section as an example.

### Instructions

1. In your store code, open the `components` folder and create a `.module.scss` file for your component. For example, if your component is `OurStores`, name the file `ourStores.module.scss`. This file will contain the styles specific to this section.
2. Import the necessary FastStore UI styles into your `.module.scss` file. For example, to style the `OurStores` component, we imported the styles for the [Button](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/atoms-button) and [SelectField](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-select-field) components. The `Select` styles are also imported since `SelectField` inherits them.

`1

.ourStores {

2

 @import '@faststore/ui/src/components/atoms/Button/styles.scss';

3

 @import '@faststore/ui/src/components/atoms/Select/styles.scss';

4

 @import '@faststore/ui/src/components/molecules/SelectField/styles.scss';

5

}

`

1. Open the component's `.tsx` file. For example, `OurStores.tsx`.
2. Import the newly created stylesheet into the component:

```` 1

import React from 'react'

2

import { Button, Icon, SelectField } from '@faststore/ui'

3

4

import styles from './ourStores.module.scss' ```

5

6

5. Apply the styles to your components using `className={styles.<className>}`. Replace `<className>` with the appropriate class name defined in your stylesheet. For example:

7

 ```tsx mark=13

8

 import React from 'react'

9

 import { Button, Icon, SelectField } from '@faststore/ui'

10

11

 import styles from './ourStores.module.scss'

12

13

 export interface OurStoresProps {

14

 title: string

15

 description: string

16

 }

17

18

 export default function OurStores(props: OurStoresProps) {

19

 return (

20

 <section className={styles.ourStores}>

21

 <h2>{props.title}</h2>

22

 <p>{props.description}</p>

23

 <div>

24

 <SelectField

25

 id="select-state-store"

26

 label="State:"

27

 options={{

28

 newYork: 'New York',

29

 arizona: 'Arizona',

30

 massachusetts: 'Massachusetts',

31

 hawaii: 'Hawaii',

32

 }}

33

 />

34

 <SelectField

35

 id="select-city-store"

36

 label="City:"

37

 options={{

38

 newYorkCity: 'New York City',

39

 phoenix: 'Phoenix',

40

 boston: 'Boston',

41

 honolulu: 'Honolulu',

42

 }}

43

 />

44

 <Button

45

 variant="secondary"

46

 icon={<Icon name="ArrowRight" />}

47

 iconPosition="right"

48

 >

49

 Find Store

50

 </Button>

51

 </div>

52

 </section>

53

 )

54

 }

 ````

1. Open the terminal and run `yarn dev` to see your changes.

![{"base64":"  ","img":{"width":2552,"height":946,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":135138,"url":"https://vtexhelp.vtexassets.com/assets/docs/src/without-styles___4680d2a9a67e4175f3b73eff036ca8ac.png"}}](https://read.calvincode.net/reader?url=https://vtexhelp.vtexassets.com/assets/docs/src/without-styles___4680d2a9a67e4175f3b73eff036ca8ac.png)

1. Add more styles to the section by using [design tokens](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/global-tokens-overview%23global-tokens) and [component-specific data attributes](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/atoms-button%23customization) to the `.module.scss` file:

`1

.ourStores {

2

 @import '@faststore/ui/src/components/atoms/Button/styles.scss';

3

 @import '@faststore/ui/src/components/atoms/Select/styles.scss';

4

 @import '@faststore/ui/src/components/molecules/SelectField/styles.scss';

5

6

 width: 100%;

7

 display: flex;

8

 flex-direction: column;

9

 justify-content: center;

10

 align-items: center;

11

 padding: var(--fs-spacing-5);

12

 margin: auto;

13

 background-color: var(--fs-color-neutral-bkg);

14

15

 [data-fs-select-field] {

16

 flex-direction: column;

17

 align-items: flex-start;

18

19

 [data-fs-select] {

20

 border: var(--fs-border-width) solid var(--fs-border-color);

21

 margin-top: var(--fs-spacing-0);

22

 width: 10rem;

23

 height: var(--fs-control-min-height);

24

25

 select {

26

 width: 100%;

27

 }

28

 }

29

 }

30

}

31

32

.ourStores__title {

33

 font-size: var(--fs-text-size-title-section);

34

 margin-bottom: var(--fs-spacing-1);

35

}

36

37

.ourStores__content {

38

 display: flex;

39

 align-items: flex-end;

40

 column-gap: var(--fs-spacing-5);

41

 margin: var(--fs-spacing-5);

42

}

`

1. Update the component's file by adding the appropriate CSS classes to elements, ensuring they align with the newly defined styles in your stylesheet. For example:

`1

import React from 'react'

2

import { Button, Icon, SelectField } from '@faststore/ui'

3

4

import styles from './ourStores.module.scss'

5

6

export interface OurStoresProps {

7

 title: string

8

 description: string

9

}

10

11

export default function OurStores(props: OurStoresProps) {

12

 return (

13

14

{props.title}

15

{props.description}

16

17

 <SelectField

18

 id="select-state-store"

19

 label="State:"

20

 options={{

21

 newYork: 'New York',

22

 arizona: 'Arizona',

23

 massachusetts: 'Massachusetts',

24

 hawaii: 'Hawaii',

25

 }}

26

 />

27

 <SelectField

28

 id="select-city-store"

29

 label="City:"

30

 options={{

31

 newYorkCity: 'New York City',

32

 phoenix: 'Phoenix',

33

 boston: 'Boston',

34

 honolulu: 'Honolulu',

35

 }}

36

 />

37

 <Button

38

 variant="secondary"

39

 icon={<Icon name="ArrowRight" />}

40

 iconPosition="right"

41

 >

42

 Find Store

43

 </Button>

44

45

46

 )

47

}

`

1. Navigate to `http://localhost:3000` in your browser to see the updated component with the applied styles.

![{"base64":"  ","img":{"width":2552,"height":946,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":129326,"url":"https://vtexhelp.vtexassets.com/assets/docs/src/with-styles___4b1cd40d4dcbbba544fd051b1f2dcb36.png"}}](https://read.calvincode.net/reader?url=https://vtexhelp.vtexassets.com/assets/docs/src/with-styles___4b1cd40d4dcbbba544fd051b1f2dcb36.png)

Contributors

1

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F67270558%3Fv%3D4%26w=64%26q=75)](https://github.com/mariana-caetano)

Was this helpful?

Yes

No

[Suggest Edits (GitHub)](https://read.calvincode.net/reader?url=https://github.com/vtexdocs/dev-portal-content/edit/main/docs/faststore/docs/developing-and-overriding-components/creating-a-new-section.mdx)

[Adding an image to the Alert component« Previous](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides//faststore/override-use-cases-adding-an-image-to-the-alert-component)[List of native sections and overridable componentsNext »](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-list-of-native-sections)

Contributors

1

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F67270558%3Fv%3D4%26w=64%26q=75)](https://github.com/mariana-caetano)

ON THIS PAGE

[Before you begin](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-creating-a-new-section%23before-you-begin)

[1\. Integrate the store with the Headless CMS](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-creating-a-new-section%231-integrate-the-store-with-the-headless-cms)[2\. Knowledge of how sections and content types work on Headless CMS](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-creating-a-new-section%232-knowledge-of-how-sections-and-content-types-work-on-headless-cms)[3\. Install the FastStore CLI](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-creating-a-new-section%233-install-the-faststore-cli)

[Call to Action](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-creating-a-new-section%23call-to-action)

[Step 1: Creating folders and files related to the Headless CMS](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-creating-a-new-section%23step-1-creating-folders-and-files-related-to-the-headless-cms)[Step 2: Creating the new section](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-creating-a-new-section%23step-2-creating-the-new-section)[Step 3: Synchronizing the new section with the Headless CMS](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-creating-a-new-section%23step-3-synchronizing-the-new-section-with-the-headless-cms)

[OurStore](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-creating-a-new-section%23ourstore)

[Adding styles to a new section](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-creating-a-new-section%23adding-styles-to-a-new-section)

[Instructions](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-creating-a-new-section%23instructions)

Was this helpful?

 Send feedback

[Suggest edits (GitHub)](https://read.calvincode.net/reader?url=https://github.com/vtexdocs/dev-portal-content/edit/main/docs/faststore/docs/developing-and-overriding-components/creating-a-new-section.mdx)

Copy page

On this page

ON THIS PAGE

[Before you begin](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-creating-a-new-section%23before-you-begin)

[1\. Integrate the store with the Headless CMS](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-creating-a-new-section%231-integrate-the-store-with-the-headless-cms)[2\. Knowledge of how sections and content types work on Headless CMS](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-creating-a-new-section%232-knowledge-of-how-sections-and-content-types-work-on-headless-cms)[3\. Install the FastStore CLI](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-creating-a-new-section%233-install-the-faststore-cli)

[Call to Action](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-creating-a-new-section%23call-to-action)

[Step 1: Creating folders and files related to the Headless CMS](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-creating-a-new-section%23step-1-creating-folders-and-files-related-to-the-headless-cms)[Step 2: Creating the new section](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-creating-a-new-section%23step-2-creating-the-new-section)[Step 3: Synchronizing the new section with the Headless CMS](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-creating-a-new-section%23step-3-synchronizing-the-new-section-with-the-headless-cms)

[OurStore](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-creating-a-new-section%23ourstore)

[Adding styles to a new section](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-creating-a-new-section%23adding-styles-to-a-new-section)

[Instructions](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/building-sections-creating-a-new-section/docs/guides/faststore/developing-and-overriding-components-creating-a-new-section%23instructions)

On this page

[Github](https://read.calvincode.net/reader?url=https://github.com/vtex-apps)[Help Center](https://read.calvincode.net/reader?url=https://help.vtex.com/)[Community](https://read.calvincode.net/reader?url=https://community.vtex.com/?%5Fga=2.198523433.743584735.1647618303-1974737580.1645714642)[Feedback](https://read.calvincode.net/reader?url=https://docs.google.com/forms/d/e/1FAIpQLSfmnotPvPjw-SjiE7lt2Nt3RQgNUe10ixXZmuO2v9enOJReoQ/viewform?entry.1972292648=developers.vtex.com%26entry.1799503232=)