[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 molecules search history 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/molecules-search-history/docs/guides)

[API ReferenceExplore detailed information about our endpoints.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/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/molecules-search-history/docs/app-development)

[Storefront DevelopmentExpress your brand identity creating unique storefronts.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/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/molecules-search-history/docs/vtex-io-apps)

[TroubleshootingFind practical solutions to common development issues.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/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/molecules-search-history/updates/release-notes)

Storefront Development

[Getting started with storefront solutions](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/getting-started-with-storefront-solutions)

---

[FastStore](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore)

[FastStore versions and support levels](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/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/molecules-search-history/docs/guides/faststore/getting-started-overview)

[FastStore WebOps](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/webops-dashboard)

[Headless CMS](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/headless-cms-overview)

[Developer tools and references](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/developer-tools-overview)

[Styling](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/styling-overview)

[UI components](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/components-index)

[Atoms](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/atoms-overview)

[Molecules](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-overview)

[Accordion](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-accordion)

[Alert](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-alert)

[Breadcrumb](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-breadcrumb)

[BuyButton](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-buy-button)

[Card](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-card)

[Carousel](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-carousel)

[CartItem](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-cart-item)

[CheckboxField](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-checkbox-field)

[DiscountBadge](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-discount-badge)

[Dropdown](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-dropdown)

[Gift](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-gift)

[IconButton](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-icon-button)

[InputField](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-input-field)

[LinkButton](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-link-button)

[Modal](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-modal)

[NavbarLinks](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-navbar-links)

[OrderSummary](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-order-summary)

[Popover](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-popover)

[ProductCard](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-product-card)

[ProductPrice](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-product-price)

[ProductTitle](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-product-title)

[QuantitySelector](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-quantity-selector)

[RadioField](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-radio-field)

[RadioGroup](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-radio-group)

[Rating](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-rating)

[RatingField](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-rating-field)

[RegionBar](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-region-bar)

[SearchAutocomplete](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-auto-complete)

[SearchDropdown](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-dropdown)

[SearchHistory](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-history)

[SearchInputField](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-input-field)

[SearchProducts](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-products)

[SearchTop](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-top)

[SelectField](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-select-field)

[SKUSelector](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-sku-selector)

[Table](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-table)

[Tag](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-tag)

[TextareaField](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-textarea-field)

[Toast](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-toast)

[Toggle](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-toggle)

[ToggleField](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-toggle-field)

[Tooltip](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-tooltip)

[Organisms](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/organisms-overview)

[Implementing storefront features](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/storefront-features-overview)

[FastStore API](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/faststore-api-overview)

[FastStore SDK](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/sdk-overview)

[Developing and overriding UI components](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/developing-and-overriding-components-overview)

[Extending the FastStore API](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/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/molecules-search-history/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/molecules-search-history/docs/guides/faststore/managing-performance-overview)

[SEO](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/seo-overview)

[Going live](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/go-live-overview)

[Troubleshooting](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/troubleshooting-overview)

---

[Store Framework](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/store-framework)

---

(Legacy) CMS Portal

---

[Storefront best practices](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/storefront-best-practices)

---

[Guides](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides)

[API Reference](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/api-reference)

[App Development](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/app-development)

[Storefront Development](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/storefront-development)

[VTEX IO Apps](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/vtex-io-apps)

[Troubleshooting](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/troubleshooting)

---

[Release Notes](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/updates/release-notes)

Storefront Development

[Getting started with storefront solutions](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/getting-started-with-storefront-solutions)

---

[FastStore](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore)

[FastStore versions and support levels](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/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/molecules-search-history/docs/guides/faststore/getting-started-overview)

[FastStore WebOps](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/webops-dashboard)

[Headless CMS](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/headless-cms-overview)

[Developer tools and references](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/developer-tools-overview)

[Styling](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/styling-overview)

[UI components](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/components-index)

[Atoms](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/atoms-overview)

[Molecules](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-overview)

[Accordion](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-accordion)

[Alert](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-alert)

[Breadcrumb](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-breadcrumb)

[BuyButton](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-buy-button)

[Card](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-card)

[Carousel](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-carousel)

[CartItem](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-cart-item)

[CheckboxField](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-checkbox-field)

[DiscountBadge](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-discount-badge)

[Dropdown](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-dropdown)

[Gift](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-gift)

[IconButton](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-icon-button)

[InputField](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-input-field)

[LinkButton](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-link-button)

[Modal](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-modal)

[NavbarLinks](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-navbar-links)

[OrderSummary](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-order-summary)

[Popover](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-popover)

[ProductCard](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-product-card)

[ProductPrice](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-product-price)

[ProductTitle](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-product-title)

[QuantitySelector](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-quantity-selector)

[RadioField](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-radio-field)

[RadioGroup](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-radio-group)

[Rating](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-rating)

[RatingField](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-rating-field)

[RegionBar](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-region-bar)

[SearchAutocomplete](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-auto-complete)

[SearchDropdown](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-dropdown)

[SearchHistory](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-history)

[SearchInputField](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-input-field)

[SearchProducts](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-products)

[SearchTop](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-top)

[SelectField](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-select-field)

[SKUSelector](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-sku-selector)

[Table](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-table)

[Tag](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-tag)

[TextareaField](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-textarea-field)

[Toast](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-toast)

[Toggle](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-toggle)

[ToggleField](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-toggle-field)

[Tooltip](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-tooltip)

[Organisms](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/organisms-overview)

[Implementing storefront features](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/storefront-features-overview)

[FastStore API](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/faststore-api-overview)

[FastStore SDK](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/sdk-overview)

[Developing and overriding UI components](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/developing-and-overriding-components-overview)

[Extending the FastStore API](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/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/molecules-search-history/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/molecules-search-history/docs/guides/faststore/managing-performance-overview)

[SEO](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/seo-overview)

[Going live](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/go-live-overview)

[Troubleshooting](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/troubleshooting-overview)

---

[Store Framework](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/store-framework)

---

(Legacy) CMS Portal

---

[Storefront best practices](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/storefront-best-practices)

---

[Storefront development](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/storefront-development)

[FastStore](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore)

[UI components](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/components-index)

[Molecules](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-overview)

SearchHistory

Shows the latest terms searched by a user.

[ Source code](https://read.calvincode.net/reader?url=https://github.com/vtex/faststore/tree/main/packages/components/src/molecules/SearchHistory)

Responsible for showing the latest terms searched by a user. This component is part of the [Search](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/feature-search) feature.

Example

Code

History

Clear History

1. [Headphone](#)
2. [Audio & Video](#)
3. [mh-7000](#)

## Usage

### Import the component

`1

import { SearchHistory, SearchHistoryTerm } from "@faststore/ui";

`

### Import styles

To apply styles, include the following in your stylesheet:

`1

@import "@faststore/ui/src/components/molecules/SearchHistory/styles.scss";

`

For details, see [Importing FastStore UI component styles](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/using-themes-importing-ui-components-styles).

---

## Examples

## Other Icons

Example

Code

History

Clear History

1. [Headphone](#)
2. [Audio & Video](#)

---

## Design tokens

| Local token                              | Default value/Global token linked      |
| ---------------------------------------- | -------------------------------------- |
| \--fs-search-history-padding-top         | var(--fs-spacing-2)                    |
| \--fs-search-history-padding-right       | var(--fs-spacing-3)                    |
| \--fs-search-history-padding-bottom      | var(--fs-search-history-padding-top)   |
| \--fs-search-history-padding-left        | var(--fs-search-history-padding-right) |
| \--fs-search-history-transition-property | var(--fs-transition-property)          |
| \--fs-search-history-transition-function | var(--fs-transition-function)          |
| \--fs-search-history-transition-timing   | var(--fs-transition-timing)            |

### Design tokens: Header

| Local token                                | Default value/Global token linked           |
| ------------------------------------------ | ------------------------------------------- |
| \--fs-search-history-header-padding-top    | var(--fs-spacing-1)                         |
| \--fs-search-history-header-padding-bottom | var(--fs-search-history-header-padding-top) |

### Design tokens: Title

| Local token                            | Default value/Global token linked |
| -------------------------------------- | --------------------------------- |
| \--fs-search-history-title-size        | var(--fs-text-size-lead)          |
| \--fs-search-history-title-line-height | 1.5                               |

### Design tokens: Item

| Local token                               | Default value/Global token linked  |
| ----------------------------------------- | ---------------------------------- |
| \--fs-search-history-item-column-gap      | var(--fs-spacing-1)                |
| \--fs-search-history-item-text-size       | var(--fs-text-size-2)              |
| \--fs-search-history-item-line-height     | 1.25                               |
| \--fs-search-history-item-bkg-color-hover | var(--fs-color-tertiary-bkg-hover) |

### Design tokens: Icon

| Local token                          | Default value/Global token linked |
| ------------------------------------ | --------------------------------- |
| \--fs-search-history-item-icon-color | var(--fs-color-neutral-4)         |
| \--fs-search-history-item-icon-size  | 1.125rem                          |

---

## Data attributes

You can target and override `SearchHistory` styles using the following data attributes:

`data-fs-search-history`

`data-fs-search-history-header`

`data-fs-search-history-title`

`data-fs-search-history-item`

`data-fs-search-history-item-link`

`data-fs-search-history-item-icon`

---

## Props

### SearchHistory

| Name           | Type       | Description                                                                            | Default           |
| -------------- | ---------- | -------------------------------------------------------------------------------------- | ----------------- |
| **testId**     | string     | ID to find this component in testing tools (e.g.: cypress, testing library, and jest). | fs-search-history |
| **title**      | string     | Title attribute for the <section> tag rendered by this component.                      | History           |
| **clearLabel** | string     | Defines the text displayed in clear history button.                                    | Clear History     |
| **onClear**    | () => void | Event handler for click on clear history button.                                       |                   |

### SearchHistoryTerm

| Name          | Type                                | Description                                                                            | Default                |    |                          |                             |                     |             |                                                     |                                                       |
| ------------- | ----------------------------------- | -------------------------------------------------------------------------------------- | ---------------------- | -- | ------------------------ | --------------------------- | ------------------- | ----------- | --------------------------------------------------- | ----------------------------------------------------- |
| **testId**    | string                              | ID to find this component in testing tools (e.g.: cypress, testing library, and jest). | fs-search-history-term |    |                          |                             |                     |             |                                                     |                                                       |
| **value\***   | string                              | Defines the text displayed in history term item.                                       |                        |    |                          |                             |                     |             |                                                     |                                                       |
| **linkProps** | Partial<LinkProps<LinkElementType>> | Props for the link from term component.                                                |                        |    |                          |                             |                     |             |                                                     |                                                       |
| **icon**      | string \| number                    | false                                                                                | true                   | {} | ReactElement<any, string | JSXElementConstructor<any>> | Iterable<ReactNode> | ReactPortal | A React component that will be rendered as an icon. | <Icon name="ClockClockwise" width={18} height={18} /> |

Contributors

3

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

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/_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/faststore/molecules-search-history/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F62757720%3Fv%3D4%26w=64%26q=75)](https://github.com/aliceoq)

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/components/molecules/search-history.mdx)

[SearchDropdown« Previous](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-dropdown)[SearchInputFieldNext »](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-input-field)

Contributors

3

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

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/_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/faststore/molecules-search-history/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F62757720%3Fv%3D4%26w=64%26q=75)](https://github.com/aliceoq)

ON THIS PAGE

[Usage](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-history%23usage)

[Import the component](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-history%23import-the-component)[Import styles](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-history%23import-styles)

[Examples](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-history%23examples)

[Other Icons](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-history%23other-icons)

[Design tokens](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-history%23design-tokens)

[Design tokens: Header](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-history%23design-tokens-header)[Design tokens: Title](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-history%23design-tokens-title)[Design tokens: Item](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-history%23design-tokens-item)[Design tokens: Icon](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-history%23design-tokens-icon)

[Data attributes](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-history%23data-attributes)

[Props](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-history%23props)

[SearchHistory](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-history%23searchhistory)[SearchHistoryTerm](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-history%23searchhistoryterm)

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/components/molecules/search-history.mdx)

Copy page

On this page

ON THIS PAGE

[Usage](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-history%23usage)

[Import the component](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-history%23import-the-component)[Import styles](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-history%23import-styles)

[Examples](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-history%23examples)

[Other Icons](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-history%23other-icons)

[Design tokens](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-history%23design-tokens)

[Design tokens: Header](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-history%23design-tokens-header)[Design tokens: Title](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-history%23design-tokens-title)[Design tokens: Item](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-history%23design-tokens-item)[Design tokens: Icon](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-history%23design-tokens-icon)

[Data attributes](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-history%23data-attributes)

[Props](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-history%23props)

[SearchHistory](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-history%23searchhistory)[SearchHistoryTerm](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/faststore/molecules-search-history/docs/guides/faststore/molecules-search-history%23searchhistoryterm)

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 orderform fields 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/orderform-fields/docs/guides)

[API ReferenceExplore detailed information about our endpoints.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/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/orderform-fields/docs/app-development)

[Storefront DevelopmentExpress your brand identity creating unique storefronts.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/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/orderform-fields/docs/vtex-io-apps)

[TroubleshootingFind practical solutions to common development issues.](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/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/orderform-fields/updates/release-notes)

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

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

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

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

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

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

---

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

orderForm

The `orderForm` is the main object processed by VTEX checkout, and one of the most important data structures in the architecture of every VTEX store.

It stores a lot of contextual information about the order which is important to the processing of the order: order items, client's personal data, delivery address, freight information, etc.

Using VTEX APIs this information can be accessed, processed, and even changed on certain occasions.

VTEX's Checkout API is one of the main interfaces interacting with the `orderForm` object. Most of its operations will return the `orderForm` or part of it.

The object's basic structure is:

`1

{

2

 "allowManualPrice": boolean,

3

 "canEditData": boolean,

4

 "clientPreferencesData": {},

5

 "clientProfileData": {},

6

 "commercialConditionData": {},

7

 "customData": {},

8

 "giftRegistryData": {},

9

 "hooksData": {},

10

 "ignoreProfileData": boolean,

11

 "isCheckedIn": boolean,

12

 "itemMetadata": {},

13

 "items": {},

14

 "itemsOrdination": {},

15

 "loggedIn": boolean,

16

 "marketingData": {},

17

 "messages": [],

18

 "openTextField": {},

19

 "orderFormId": string,

20

 "paymentData": {},

21

 "ratesAndBenefitsData": {},

22

 "salesChannel": "1",

23

 "selectableGifts": {},

24

 "sellers": {},

25

 "shippingData": {},

26

 "storeId": {},

27

 "storePreferencesData": {},

28

 "totalizers": {},

29

 "userProfileId": {},

30

 "userType": {},

31

 "value": number

32

}

`

This structure is made of many **sections**.

> Any properties representing monetary values will have **cents** as their units. (e.g. `10390` means **R$103,90** in Brazilian stores). In the following menu, you can find details regarding these sections.

## `OrderForm` Sections

* [clientPreferencesData](#clientpreferencesdata)
* [clientProfileData](#clientprofiledata)
* [commercialConditionData](#commercialconditiondata)
* [customData](#customdata)
* [giftRegistryData](#giftregistrydata)
* [hooksData](#hooksdata)
* [items](#items)
   * [items\[\].priceDefinition](#itemspricedefinition)
* [invoiceData](#invoicedata)
* [itemsOrdination](#itemsordination)
* [marketingData](#marketingdata)
* [messages](#messages)
* [openTextField](#opentextfield)
* [paymentData](#paymentdata)
* [ratesAndBenefitsData](#ratesandbenefitsdata)
* [selectableGifts](#selectablegifts)
* [sellers](#sellers)
* [shippingData](#shippingdata)
* [storeId](#storeid)
* [storePreferencesData](#storepreferencesdata)
* [subscriptionData](#subscriptiondata)
* [totalizers](#totalizers)

### clientPreferencesData

Object containing preferences from the client who placed the order.

**Example:**

`1

{

2

 "locale": "pt-BR",

3

 "optinNewsLetter": true

4

}

`

| Field           | Type    | Description                                                                                |
| --------------- | ------- | ----------------------------------------------------------------------------------------------------------------------- |
| locale          | String  | Client's locale. Examples: "pt-BR" and "en-US". The method sendLocale(), from vtex.js, changes the value of this field. |
| optinNewsLetter | Boolean | true if the client opted to receive newsletters from the store.                                                         |

### clientProfileData

Object containing the data of the customer who placed the order.

If the customer has not yet informed her or his email, much of the data may be empty (`null`).

If the customer's email has not yet been confirmed, several personal data will be censored, that is, some of its parts will be hidden by asterisks to avoid identification.

**Example:**

`1

{

2

 "email": "customer@mailprovider.com",

3

 "firstName": "Bre******",

4

 "lastName": "Bar******",

5

 "document": "*1*2*5*5*3*",

6

 "documentType": "cpf",

7

 "phone": "******0879",

8

 "corporateName": null,

9

 "tradeName": null,

10

 "corporateDocument": null,

11

 "stateInscription": null,

12

 "corporatePhone": null,

13

 "isCorporate": false

14

}

`

| Field             | Type    | Description                                         |
| ----------------- | ------- | --------------------------------------------------- |
| email             | String  | Customer's email.                                   |
| firstName         | String  | Customer's first name.                              |
| lastName          | String  | Customer's last name.                               |
| document          | String  | Document number informed by the customer.           |
| documentType      | String  | Type of the document informed by the customer.      |
| phone             | String  | Customer's phone number.                            |
| corporateName     | String  | If it's a legal entity, here goes the company name. |
| tradeName         | String  | If legal entity, here goes the trade name.          |
| corporateDocument | String  | If legal entity, here goes the corporate document.  |
| stateInscription  | String  | If legal entity, here goes the state inscription.   |
| corporatePhone    | String  | If legal entity, here goes the company phone.       |
| isCorporate       | Boolean | It has the value true if it's a legal entity.       |

### commercialConditionData

> This guide is currently being written and published as content becomes available.

### customData

During the checkout process, some stores need to include data gathered from the client that is not part of our standard `orderForm` format (e.g. gender, cell phone number, age).

To do that you will need to create extra fields in the `orderForm` and those will be located inside the `customData` parameter.

**Example:**

`1

"customData": {

2

 "attachmentId": "customData",

3

 "customApps": [

4

 {

5

 "fields": {

6

 "number": "78550693",

7

 "street": "Rua Voluntários da Pátria",

8

 "complement": "Em frente à Torre Citi",

9

 "name": "101 - Delco Autopista",

10

 "neighborhood": "Botafogo",

11

 "city": "Rio de Janeiro",

12

 "state": "RJ"

13

 },

14

 "id": "pickupinfo",

15

 "major": 1

16

 },

17

 {

18

 "fields": {

19

 "deliveryEstimate": "30"

20

 },

21

 "id": "deliveryinfo",

22

 "major": 1

23

 }

24

 ]

25

}

`

| Field      | Type    | Description                                                        |
| ---------- | ------- | ------------------------------------------------------------------ |
| customApps | Array   | Array containing the apps created by the store.                    |
| fields     | Object  | Object that contains the fields created by the store for each app. |
| id         | String  | App ID.                                                            |
| major      | Integer | App major version.                                                 |

### giftRegistryData

Object containing the gift registration list data.

**Example:**

`1

{

2

 "giftRegistryId": "22222",

3

 "giftRegistryType": null,

4

 "giftRegistryTypeName": null,

5

 "addressId": null,

6

 "description": "gift1"

7

}

`

| Field                | Type   | Description                   |
| -------------------- | ------ | ----------------------------- |
| giftRegistryId       | String | Gift registry ID.             |
| giftRegistryType     | String | Gift registry type.           |
| giftRegistryTypeName | String | Gift registration typen name. |
| addressId            | String | Address ID.                   |
| description          | String | Gift registry description.    |

### hooksData

> This guide is currently being written and published as content becomes available.

### items

it is an array containing an object describing every item in the buyer's cart.

**Example:**

`1

"items": [

2

 {

3

 "uniqueId": "3B31329E5DDA4A1A81449DD7466D9575",

4

 "id": "4",

5

 "productId": "3",

6

 "productRefId": "",

7

 "refId": null,

8

 "ean": "978073487962",

9

 "name": "Mild Hair Cleanser 50 ml",

10

 "skuName": "50 ml",

11

 "modalType": null,

12

 "parentItemIndex": null,

13

 "parentAssemblyBinding": null,

14

 "priceValidUntil": "2022-04-07T18:31:11Z",

15

 "tax": 0,

16

 "taxCode":"54WC8ZN6K8",

17

 "price": 3190,

18

 "listPrice": 3190,

19

 "manualPrice": 1700,

20

 "manualPriceAppliedBy": "in542e51-5863-4c34-8i86-ed8fcf597a09",

21

 "sellingPrice": 1700,

22

 "rewardValue": 0,

23

 "isGift": false,

24

 "additionalInfo": {

25

 "dimension": null,

26

 "brandName": "VALCOSMETICS",

27

 "brandId": "2000000",

28

 "offeringInfo": null,

29

 "offeringType": null,

30

 "offeringTypeId": null

31

 },

32

 "preSaleDate": null,

33

 "productCategoryIds": "/2/",

34

 "productCategories": {

35

 "2": "Computers"

36

 },

37

 "quantity": 3,

38

 "seller": "seller1",

39

 "sellerChain": [

40

 "seller1"

41

 ],

42

 "imageUrl": "http://cosmeticsstore.vteximg.com.br/arquivos/ids/155401-55-55/ID-001-MAIN.jpg?v=637109313796670000",

43

 "detailUrl": "/mild-hair-cleanser/p",

44

 "bundleItems": [],

45

 "attachments": [],

46

 "attachmentOfferings": [],

47

 "offerings": [],

48

 "priceTags": [

49

 {

50

 "name": "DISCOUNT@MANUALPRICE",

51

 "value": -4470,

52

 "rawValue": -44.7,

53

 "isPercentual": false,

54

 "identifier": null

55

 }

56

 ],

57

 "availability": "available",

58

 "measurementUnit": "un",

59

 "unitMultiplier": 1.0000,

60

 "manufacturerCode": null,

61

 "priceDefinition": {

62

 "sellingPrice": [

63

 {

64

 "quantity": 1,

65

 "value": 1700

66

 }

67

 ],

68

 "total": 5100

69

 }

70

 }

71

 ]

`

| Field                  | Type             | Description                                                                                |
| ---------------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| uniqueId               | String           | Obsolete field. This string is the unique identifier for each occurrence of a SKU in an order. Two units of the same SKU in an order will have different uniqueIds.                                                          |
| id                     | String           | ID of the item.                                                                                |
| productId              | String           | Product ID.                                                                                |
| productRefId           | String           | Product Ref ID.                                                                                |
| refId                  | String           | Ref ID.                                                                                |
| ean                    | String           | EAN (codebar) field from [SKU registry](https://read.calvincode.net/reader?url=https://help.vtex.com/pt/tutorial/cadastrar-o-codigo-de-barra-dos-skus-para-o-instore--2jkOdRB4XSMG2ke0uUQIKS%23cadastrar-o-campo-ean).                                                |
| name                   | String           | Product name.                                                                                |
| skuName                | String           | SKU name.                                                                                |
| modalType              | String           | Modal type.                                                                                |
| parentItemIndex        | Integer          | Parent item index.                                                                                |
| parentAssemblyBinding  | String           | Parent assembly binding.                                                                                |
| priceValidUntil        | String           | Price expiration date and time.                                                                                |
| tax                    | Integer          | Tax value in cents.                                                                                |
| taxCode                | String           | A unique identifier code assigned to a tax within the VTEX Admin.                                                                                |
| price                  | Integer          | Price in cents.                                                                                |
| listPrice              | Integer          | List price in cents.                                                                                |
| manualPrice            | Integer          | Manual price in cents.                                                                                |
| manualPriceAppliedBy   | String           | User that applied the manual price, if that is the case.                                                                                |
| sellingPrice           | Integer          | Selling price in cents. Note that this field may be subject to rounding discrepancies. We recommend retrieving data from the priceDefinition data structure instead.                                                         |
| rewardValue            | Integer          | Reward value in cents.                                                                                |
| isGift                 | Boolean          | Indicates whether item is a gift.                                                                                |
| additionalInfo         | Object           | Additional information.                                                                                |
| dimension              | String           | Dimension.                                                                                |
| brandName              | String           | Brand name.                                                                                |
| brandId                | String           | Brand ID.                                                                                |
| offeringInfo           | String           | Offering information.                                                                                |
| offeringType           | String           | Offering type.                                                                                |
| offeringTypeId         | String           | Offering type ID.                                                                                |
| preSaleDate            | String           | Presale date.                                                                                |
| productCategoryIds     | String           | Product category IDs.                                                                                |
| productCategories      | Object           | Object, where each field is an ID from productCategoryIds.                                                                                |
| {ID}                   | String           | Product category corresponding to the ID in the field key.                                                                                |
| quantity               | Integer          | Quantity.                                                                                |
| seller                 | String           | Seller information.                                                                                |
| sellerChain            | Array of strings | Sellers involved in the chain. The list should contain only one seller, unless it is a [Multilevel Omnichannel Inventory](https://read.calvincode.net/reader?url=https://help.vtex.com/en/tutorial/multilevel-omnichannel-inventory--7M1xyCZWUyCB7PcjNtOyw4) order. |
| imageUrl               | String           | Image URL.                                                                                |
| detailUrl              | String           | Detail URL.                                                                                |
| bundleItems            | Array of objects | Information on services sold along with the SKU. Example: a gift package.                                                                                |
| type                   | String           | Service type.                                                                                |
| id                     | Integer          | Service identifier.                                                                                |
| name                   | String           | Service name.                                                                                |
| price                  | Integer          | Service price in cents.                                                                                |
| attachments            | Array of strings | Array containing information on attachments.                                                                                |
| priceTags              | Array of objects | Array of price tags, each of which, modifies the price in some way, like discounts or rates that apply to the item in the context of the order.                                                                              |
| name                   | String           | Price tag name.                                                                                |
| value                  | Integer          | Price tag value.                                                                                |
| rawValue               | Integer          | Price tag raw value.                                                                                |
| isPercentual           | Boolean          | Indicates whether price tag value is applied through a percentage.                                                                                |
| identifier             | String           | Price tag identifier.                                                                                |
| owner                  | String           | Identification of the responsible for the price tag.                                                                                |
| availability           | String           | SKU availability. The values are: available, withoutStockand cannotBeDelivered. Only SKUs with available value can be sold and delivered.                                                                                |
| measurementUnit        | String           | Measurement unit.                                                                                |
| unitMultiplier         | String           | Unit multiplier.                                                                                |
| manufacturerCode       | String           | Manufacturer code.                                                                                |
| priceDefinition        | Object           | Price information for all units of a specific item.                                                                                |
| calculatedSellingPrice | Integer          | Item's calculated unitary selling price in cents.                                                                                |
| total                  | Integer          | Total value for all units of the item in cents.                                                                                |
| sellingPrices          | Array of objects | Array of objects, each containing value (in cents) and quantity for the different rounding instances that can be combined to form the correctly rounded total.                                                               |
| value                  | Integer          | Value in cents for that specific rounding.                                                                                |
| quantity               | Integer          | Rounding quantity, meaning how many items are rounded to this value.                                                                                |

> If you use integrations that consume price data, such as checkout or order integrations, note that the field `sellingPrice` may be subject to rounding discrepancies. We recommend retrieving data from the `priceDefinition` data structure instead.

#### items\[\].priceDefinition

`1

{

2

 "items": [

3

 {

4

 "id": "1001669",

5

 "price": 199,

6

 "quantity": 3,

7

 "unitMultiplier": 0.3,

8

 "measurementUnit": "kg",

9

 "sellingPrice": 59,

10

 "priceDefinition": {

11

 "calculatedSellingPrice": 59,

12

 "total": 179,

13

 "sellingPrices": [

14

 {

15

 "value": 60,

16

 "quantity": 2

17

 },

18

 {

19

 "value": 59,

20

 "quantity": 1

21

 }

22

 ]

23

 }

24

 }

25

 ]

26

}

`

| **Atribute**                                     | **Type** | **Description**                                                                                |
| ------------------------------------------------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| items\[\].priceDefinition                        | Object   | Price information for all units of a specific item.                                                                                |
| items\[\].priceDefinition.total                  | Integer  | Total value for all units of the item in cents.                                                                                |
| items\[\].priceDefinition.calculatedSellingPrice | Integer  | Item's calculated unitary selling price in cents.                                                                                |
| items\[\].priceDefinition.sellingPrices          | Array    | Array of objects, each containing value (in cents) and quantity for the different rounding instances that can be combined to form the correctly rounded total. |

### invoiceData

This is an object containing information pertinent to the order's invoice.

`1

{

2

 "address": {

3

 "postalCode": "******000",

4

 "city": "Rio ** *******",

5

 "state": "RJ",

6

 "country": "BRA",

7

 "street": "Rua *** *****nte",

8

 "number": "***",

9

 "neighborhood": "Bot*****",

10

 "complement": "*** ** *",

11

 "reference": null

12

 },

13

 "settleInvoices":[]

14

}

`

| Field          | Type   | Description                                       |
| -------------- | ------ | ------------------------------------------------- |
| address        | Object | Address information.                              |
| settleInvoices | String | List of strings corresponding to invoice numbers. |

### itemsOrdination

This is an object containing information about the ordering of items within the orderForm.

**Example:**

`1

{

2

 "criteria": "NAME",

3

 "ascending": true

4

}

`

| Field     | Type   | Description                                                                                |
| --------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| criteria  | String | Criteria adopted to order the items in the list. The values are: NAME, ADD\_TIME (date information), and GIFT (non-gift items are mentioned before gift items). |
| ascending | String | Indicates whether the ordering is ascending.                                                                                |

### marketingData

This object contains promotion data such as coupon tracking information and internal or external UTMs.

**Example:**

`1

{

2

 "attachmentId": "marketingData",

3

 "coupon": null,

4

 "marketingTags": [],

5

 "utmCampaign": "christmas",

6

 "utmMedium": null,

7

 "utmSource": "fb",

8

 "utmiCampaign": "",

9

 "utmiPart": "",

10

 "utmipage": ""

11

}

`

| Field         | Type   | Description                                                                                |
| ------------- | ------ | ---------------------------------------------------------------------------------------------------------------------- |
| attachmentId  | String | Attachment ID.                                                                                |
| coupon        | String | Coupon code information.                                                                                |
| marketingTags | Array  | Marketing tags information. This field can be used to register campaign data or informative tags regarding promotions. |
| utmCampaign   | String | Value of the utm\_campaign parameter of the URL that led to the request.                                               |
| utmMedium     | String | Value of the utm\_medium parameter of the URL that led to the request.                                                 |
| utmSource     | String | Value of the utm\_source parameter of the URL that led to the request.                                                 |
| utmiCampaign  | String | Internal UTM value utmi\_cp.                                                                                |
| utmiPart      | String | Internal UTM value utmi\_pc.                                                                                |
| utmipage      | String | Internal UTM value utmi\_p.                                                                                |

### messages

This array contains an object for each message generated by our servers while processing the request.

**Example:**

`1

[

2

 {

3

 "code": null,

4

 "status": "error",

5

 "text": "Voucher code AAAA-BBBB-CCCC-DDDD was not found in the system"

6

 }

7

]

`

### openTextField

Optional field meant to hold additional information about the order. We recommend using this field for text, not data formats such as `JSON` even if escaped. For that purpose, see [Add and handle custom information in the order](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/add-and-handle-custom-information-in-the-order).

`1

{

2

 "value": "{\"Phones\":[\"55555555\"]}"

3

}

`

| Field | Type   | Description                             |
| ----- | ------ | --------------------------------------- |
| value | String | Additional information about the order. |

### paymentData

This object contains all payment information inserted for this purchase.

**Example:**

`1

{

2

 "giftCards": [

3

 {

4

 "redemptionCode": "HYUO-TEZZ-QFFT-HTFR",

5

 "value": 500,

6

 "balance": 500,

7

 "name": null,

8

 "id": "-1390324156495k195pmab4rall3di",

9

 "inUse": true,

10

 "isSpecialCard": false

11

 }, {

12

 "redemptionCode": "MTHU-WNTD-VXJW-TIDC",

13

 "value": 0,

14

 "balance": 700000,

15

 "name": "loyalty-program",

16

 "id": "122",

17

 "inUse": false,

18

 "isSpecialCard": true

19

 }

20

 ],

21

 "giftCardMessages": [],

22

 "availableAccounts": [

23

 {

24

 "accountId": "71F2775D46BF44B1BF217F828F4E6131",

25

 "paymentSystem": "2",

26

 "paymentSystemName": "Visa",

27

 "cardNumber": "************1111",

28

 "availableAddresses": ["-1363804954758", "-1366200971560"]

29

 }

30

 ],

31

 "availableTokens": [],

32

 "installmentOptions": [

33

 {

34

 "paymentSystem": "2",

35

 "value": 16175,

36

 "installments": [

37

 {

38

 "count": 1,

39

 "hasInterestRate": false,

40

 "interestRate": 0,

41

 "value": 16175,

42

 "total": 16175

43

 }, {

44

 "count": 2,

45

 "hasInterestRate": false,

46

 "interestRate": 132,

47

 "value": 4178,

48

 "total": 16712

49

 }

50

 ]

51

 }

52

 ],

53

 "paymentSystems": [

54

 {

55

 "id": 2,

56

 "name": "Visa",

57

 "groupName": "creditCardPaymentGroup",

58

 "validator": {

59

 "regex": "^4",

60

 "mask": "9999 9999 9999 9999",

61

 "cardCodeRegex": "[^0-9]",

62

 "cardCodeMask": "999",

63

 "weights": [2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2]

64

 },

65

 "stringId": null,

66

 "template": "creditCardPaymentGroup-template",

67

 "requiresDocument": false,

68

 "selected": false,

69

 "isCustom": false,

70

 "description": null

71

 }

72

 ],

73

 "payments": [

74

 {

75

 "accountId": null,

76

 "bin": null,

77

 "installments": 2,

78

 "paymentSystem": "12",

79

 "referenceValue": 16175,

80

 "value": 16175

81

 }

82

 ]

83

}

`

| Field              | Type   | Description                                                                                |
| ------------------ | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| giftCards          | Array  | Gift cards information.                                                                                |
| giftCardMessages   | Array  | Gift cards message information.                                                                                |
| availableAccounts  | Array  | Available accounts information.                                                                                |
| availableTokens    | Array  | Available tokes information.                                                                                |
| installmentOptions | Array  | For accurate information on installment options and values, we recommend using the [Cart installments endpoint](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/api-reference/checkout-api%23get-/api/checkout/pub/orderForm/-orderFormId-/installments), instead of this field's data. |
| paymentSystems     | Array  | Payment systems information.                                                                                |
| payments           | Array  | Payments information.                                                                                |
| updateStatus       | String | Checkout can not be concluded if value is "outdated".                                                                                |

> This guide is currently being written and published as content becomes available.

### ratesAndBenefitsData

Information on rates and benefits that apply to the order.

**Example:**

`1

{

2

 "rateAndBenefitsIdentifiers": [

3

 {

4

 "items": {}

5

 }

6

 ],

7

 "teaser":[

8

 {

9

 "items": {}

10

 }

11

 ]

12

}

`

| Field                      | Type   | Description                                   |
| -------------------------- | ------ | --------------------------------------------- |
| rateAndBenefitsIdentifiers | Array  | List with rates and benefits identifiers.     |
| items                      | Object | Object that contains identifiers information. |
| teaser                     | Array  | List with rates and benefits teasers.         |
| items                      | Object | Object that contains teasers information.     |

### selectableGifts

Array containing the data of the item selected as a gift.

`1

 [

2

 {

3

 "id": null,

4

 "availableQuantity": "3",

5

 "availableGifts": {

6

 "items": [

7

 {},

8

 "isSelected": true

9

 ]

10

 }

11

 }

12

 ]

`

| Field             | Type    | Description                                                                     |
| ----------------- | ------- | ------------------------------------------------------------------------------- |
| id                | String  | Identification of the selectable gifts list.                                    |
| availableQuantity | Integer | Number of items available.                                                      |
| items             | Integer | Array containing an object describing each item that can be selected as a gift. |
| isSelected        | Boolean | Indication if the item was selected as a gift.                                  |

### sellers

An array containing an object for each seller being used in the order.

**Example:**

`1

[

2

 {

3

 "id": "1",

4

 "name": "meuamigopet",

5

 "logo": "http://portal.vtexcommerce.com.br/arquivos/logo.jpg"

6

 }

7

]

`

| Field | Type   | Description                                |
| ----- | ------ | ------------------------------------------ |
| id    | String | ID of the seller.                          |
| name  | String | Name of the seller.                        |
| logo  | String | URL pointing to where the image is hosted. |

### shippingData

This object contains shipping information for the order.

**Example:**

`1

{

2

 "attachmentId": "shippingData",

3

 "address": {

4

 "addressType": "residential",

5

 "receiverName": "Gui***rme",

6

 "addressId": "-1368194386810",

7

 "postalCode": "******000",

8

 "city": "Rio ** *******",

9

 "state": "RJ",

10

 "country": "BRA",

11

 "street": "Rua *** *****nte",

12

 "number": "***",

13

 "neighborhood": "Bot*****",

14

 "complement": "*** ** *",

15

 "reference": null

16

 },

17

 "availableAddresses": [

18

 {

19

 "addressType": "residential",

20

 "receiverName": "Gui***rme",

21

 "addressId": "-1368194386810",

22

 "postalCode": "******000",

23

 "city": "Rio ** *******",

24

 "state": "RJ",

25

 "country": "BRA",

26

 "street": "Rua *** *****nte",

27

 "number": "***",

28

 "neighborhood": "Bot*****",

29

 "complement": "*** ** *",

30

 "reference": null

31

 }

32

 ],

33

 "logisticsInfo": [

34

 {

35

 "itemIndex": 0,

36

 "selectedSla": ".Transportadora",

37

 "selectedDeliveryChannel": "delivery",

38

 "addressId": "teste",

39

 "slas": [

40

 {

41

 "id": ".Transportadora",

42

 "deliveryChannel": "delivery",

43

 "name": ".Transportadora",

44

 "deliveryIds": [

45

 {

46

 "courierId": "67",

47

 "warehouseId": "1_1",

48

 "dockId": "1_1_1",

49

 "courierName": "Transportadora",

50

 "quantity": 1

51

 }

52

 ],

53

 "shippingEstimate": "3d",

54

 "shippingEstimateDate": null,

55

 "lockTTL": null,

56

 "availableDeliveryWindows": [],

57

 "deliveryWindow": null,

58

 "price": 956,

59

 "tax": 0

60

 }, {

61

 "id": "Agendada",

62

 "name": "Agendada",

63

 "deliveryIds": [

64

 {

65

 "courierId": "FA02F72F-FEBD-41A0-AF70-83A77E8C77A0",

66

 "warehouseId": "1_1",

67

 "dockId": "1_1_1",

68

 "courierName": "Entrega agendada",

69

 "quantity": 1

70

 }

71

 ],

72

 "shippingEstimate": "90d",

73

 "shippingEstimateDate": null,

74

 "lockTTL": null,

75

 "availableDeliveryWindows": [

76

 {

77

 "startDateUtc": "2014-04-21T09:00:00+00:00",

78

 "endDateUtc": "2014-04-21T12:00:00+00:00",

79

 "listprice": 1000,

80

 "tax": 0

81

 }, {

82

 "startDateUtc": "2014-04-21T13:00:00+00:00",

83

 "endDateUtc": "2014-04-21T17:00:00+00:00",

84

 "listprice": 1000,

85

 "tax": 0

86

 }

87

 ],

88

 "deliveryWindow ": [

89

 {

90

 "startDateUtc": "2014-04-21T09:00:00+00:00",

91

 "endDateUtc": "2014-04-21T12:00:00+00:00",

92

 "listprice": 1000,

93

 "tax": 0

94

 }, {

95

 "startDateUtc": "2014-04-21T13:00:00+00:00",

96

 "endDateUtc": "2014-04-21T17:00:00+00:00",

97

 "listprice": 1000,

98

 "tax": 0

99

 }

100

 ],

101

 "price": 1220,

102

 "tax": 0,

103

 "pickupStoreInfo": {

104

 "isPickupStore": false,

105

 "friendlyName": null,

106

 "address": null,

107

 "additionalInfo": null,

108

 "dockId": null

109

 },

110

 "pickupPointId": null,

111

 "pickupDistance": 0,

112

 "polygonName": null,

113

 "transitTime": "3bd"

114

 }

115

 ],

116

 "shipsTo": [

117

 "BRA",

118

 "COL",

119

 "USA"

120

 ],

121

 "itemId": "2",

122

 "deliveryChannels": [

123

 {

124

 "id": "delivery"

125

 },

126

 {

127

 "id": "pickup-in-point"

128

 }

129

 ]

130

 }

131

 ],

132

 "selectedAddresses": []

133

}

`

| Field                    | Type    | Description                                                                                |
| ------------------------ | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| attachmentId             | String  | Attachment ID.                                                                                |
| address                  | Object  | Address information.                                                                                |
| availableAddresses       | Array   | Information about available shipping addresses.                                                                                |
| logisticsInfo            | Array   | Logistics information.                                                                                |
| itemIndex                | Integer | Index corresponding to the position of the object in the items array.                                                                                |
| selectedSla              | String  | SLA selected by the customer.                                                                                |
| selectedDeliveryChannel  | String  | Delivery channel selected by the customer.                                                                                |
| addressId                | String  | Address ID.                                                                                |
| slas                     | Array   | Information on available SLAs.                                                                                |
| id                       | String  | SLA ID.                                                                                |
| deliveryChannel          | String  | Delivery channel.                                                                                |
| name                     | String  | SLA name.                                                                                |
| deliveryIds              | Array   | Information on each delivery ID.                                                                                |
| courierId                | String  | Courier ID.                                                                                |
| warehouseId              | String  | Warehouse ID.                                                                                |
| dockId                   | String  | Dock ID.                                                                                |
| courierName              | String  | Courier name.                                                                                |
| quantity                 | Integer | Quantity.                                                                                |
| shippingEstimate         | String  | Total shipping estimate time, represented by a number followed by a time unit. For instance, three business days is represented as 3bd. The time unit can be one of the following: m (minutes)h (hours)bd (business days)d (days) |
| shippingEstimateDate     | String  | Shipping estimate date.                                                                                |
| lockTTL                  | String  | Estimate date of delivery.                                                                                |
| availableDeliveryWindows | String  | Available shipping date.                                                                                |
| startDateUtc             | String  | Available delivery window start date in UTC.                                                                                |
| endDateUtc               | String  | Available delivery window end date in UTC.                                                                                |
| deliveryWindow           | Object  | Scheduled delivery window information, in case it applies to the item.                                                                                |
| startDateUtc             | String  | Scheduled delivery window start date in UTC.                                                                                |
| endDateUtc               | String  | Scheduled delivery window end date in UTC.                                                                                |
| listPrice                | Integer | Scheduled delivery window list price.                                                                                |
| price                    | Integer | Price in cents.                                                                                |
| tax                      | Integer | Tax in cents.                                                                                |
| pickupStoreInfo          | Object  | Information on the pickup store.                                                                                |
| isPickupStore            | Boolean | Indicates whether it is the pickup store.                                                                                |
| friendlyName             | String  | Friendly name.                                                                                |
| address                  | Object  | Address information.                                                                                |
| additionalInfo           | String  | Additional information.                                                                                |
| dockId                   | String  | Corresponding dock ID.                                                                                |
| pickupPointId            | String  | Pickup point ID.                                                                                |
| pickupDistance           | Integer | Pickup point distance.                                                                                |
| polygonName              | String  | Polygon name.                                                                                |
| transitTime              | String  | Transit time. For instance, "three business days" is represented 3bd.                                                                                |
| shipsTo                  | Array   | List of countries that the item may be shipped to.                                                                                |
| itemId                   | String  | Item ID.                                                                                |
| deliveryChannels         | String  | List of available delivery channels.                                                                                |
| id                       | String  | elivery channel ID.                                                                                |
| selectedAddresses        | Array   | Selected addresses information.                                                                                |

### storeId

It is a string containing the store ID.

**Example:**

`1

{

2

 "storeId": "2"

3

}

`

| Field   | Type    | Description                  |
| ------- | ------- | ---------------------------- |
| storeId | integer | Identification of the store. |

### storePreferencesData

This object contains data from the store's configuration.

**Example:**

`1

{

2

 "countryCode": "BRA",

3

 "saveUserData": true,

4

 "templateOptions": {

5

 "toggleCorporate": false

6

 },

7

 "timeZone": "E. South America Standard Time",

8

 "currencyCode": "BRL",

9

 "currencyLocale": 0,

10

 "currencySymbol": "R$",

11

 "currencyFormatInfo": {

12

 "currencyDecimalDigits": 2,

13

 "currencyDecimalSeparator": ",",

14

 "currencyGroupSeparator": ".",

15

 "currencyGroupSize": 3,

16

 "startsWithCurrencySymbol": true

17

 }

18

}

`

### totalizers

This array contains an object for each totalizer for the purchase. Totalizers contain the sum of values for a specific part of the order (e.g. Total item value, Total shipping value).

**Example:**

`1

[

2

 {

3

 "id": "Items",

4

 "name": "Total items",

5

 "value": 35620

6

 },

7

 {

8

 "id": "Shipping",

9

 "name": "Total freight",

10

 "value": 399

11

 }

12

]

`

Contributors

4

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/_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/orderform-fields/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F136460310%3Fv%3D4%26w=64%26q=75)](https://github.com/geisecosta)

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

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

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/Checkout/orderform-fields.md)

Contributors

4

[![Photo of the contributor](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/_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/orderform-fields/_next/image?url=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F136460310%3Fv%3D4%26w=64%26q=75)](https://github.com/geisecosta)

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

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

ON THIS PAGE

[OrderForm Sections](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23orderform-sections)

[clientPreferencesData](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23clientpreferencesdata)[clientProfileData](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23clientprofiledata)[commercialConditionData](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23commercialconditiondata)[customData](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23customdata)[giftRegistryData](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23giftregistrydata)[hooksData](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23hooksdata)[items](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23items)[invoiceData](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23invoicedata)[itemsOrdination](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23itemsordination)[marketingData](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23marketingdata)[messages](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23messages)[openTextField](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23opentextfield)[paymentData](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23paymentdata)[ratesAndBenefitsData](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23ratesandbenefitsdata)[selectableGifts](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23selectablegifts)[sellers](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23sellers)[shippingData](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23shippingdata)[storeId](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23storeid)[storePreferencesData](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23storepreferencesdata)[totalizers](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23totalizers)

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/Checkout/orderform-fields.md)

Copy page

On this page

ON THIS PAGE

[OrderForm Sections](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23orderform-sections)

[clientPreferencesData](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23clientpreferencesdata)[clientProfileData](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23clientprofiledata)[commercialConditionData](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23commercialconditiondata)[customData](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23customdata)[giftRegistryData](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23giftregistrydata)[hooksData](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23hooksdata)[items](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23items)[invoiceData](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23invoicedata)[itemsOrdination](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23itemsordination)[marketingData](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23marketingdata)[messages](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23messages)[openTextField](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23opentextfield)[paymentData](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23paymentdata)[ratesAndBenefitsData](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23ratesandbenefitsdata)[selectableGifts](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23selectablegifts)[sellers](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23sellers)[shippingData](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23shippingdata)[storeId](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23storeid)[storePreferencesData](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23storepreferencesdata)[totalizers](https://read.calvincode.net/reader?url=https://developers.vtex.com/docs/guides/orderform-fields/docs/guides/orderform-fields%23totalizers)

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=)