diff --git a/packages/headless-components/stores/src/react/Category.tsx b/packages/headless-components/stores/src/react/Category.tsx
index 2cdb43ad1..c0acff313 100644
--- a/packages/headless-components/stores/src/react/Category.tsx
+++ b/packages/headless-components/stores/src/react/Category.tsx
@@ -3,18 +3,38 @@ import { useService } from "@wix/services-manager-react";
 import React, { type ReactNode } from "react";
 import { CategoryServiceDefinition } from "../services/category-service.js";
 
-// Grid component for displaying filtered products
+/**
+ * Props for the List headless component.
+ */
 export interface CategoryListProps {
+  /** Function that receives category data and selection state. Use this function to render your custom category UI components with the provided category information. */
   children: (data: {
+    /** Array of available product categories. Learn about [managing products and categories](https://support.wix.com/en/managing-products-and-categories). */
     categories: Category[];
+    /** ID of the currently selected category, or null if no category is selected. */
     selectedCategory: string | null;
+    /** Function to change the selected category. Pass null to show all products or a category ID to filter by that category. */
     setSelectedCategory: (categoryId: string | null) => void;
   }) => ReactNode;
 }
 
 /**
- * Headless component for displaying a list of categories
+ * <blockquote class="caution">
+ *
+ * **Developer Preview**
+ *
+ * This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
  *
+ * </blockquote>
+ *
+ * A headless component for displaying and managing product categories.
+ * Manages category data retrieval and maintains selection state for filtering products by category.
+ *
+ * > **Notes:**
+ * > * This component is only relevant for [Wix Vibe](https://support.wix.com/en/article/wix-vibe-an-overview) and [Wix Headless](https://dev.wix.com/docs/go-headless/get-started/about-headless/about-wix-headless) developers.
+ * > * Headless components use the render props pattern. They provide business logic and state management, while giving you full control over the UI so you can build custom experiences faster.
+ *
+
  * @component
  */
 export const List: React.FC<CategoryListProps> = ({ children }) => {
diff --git a/packages/headless-components/stores/src/react/Collection.tsx b/packages/headless-components/stores/src/react/Collection.tsx
index b5cd7e982..ec29d6b79 100644
--- a/packages/headless-components/stores/src/react/Collection.tsx
+++ b/packages/headless-components/stores/src/react/Collection.tsx
@@ -7,34 +7,48 @@ import {
 } from "@wix/auto_sdk_stores_products-v-3";
 
 /**
- * Props for Grid headless component
+ * Props for the Grid headless component.
  */
 export interface GridProps {
-  /** Render prop function that receives product grid data */
-  children: (props: GridRenderProps) => React.ReactNode;
+  /** Function that receives product grid data and loading states. Use this function to render your custom UI components with the provided data. */
+  children: (props: GridRenderProps) => JSX.Element;
 }
 
 /**
- * Render props for Grid component
+ * Render props for the Grid component.
  */
 export interface GridRenderProps {
-  /** Array of products */
+  /** Array of products. Learn about [managing products and categories](https://support.wix.com/en/managing-products-and-categories). */
   products: V3Product[];
-  /** Whether products are loading */
+  /** Whether the collection data is loading. */
   isLoading: boolean;
-  /** Error message if any */
+  /** Error message if loading fails. */
   error: string | null;
-  /** Whether there are no products */
+  /** Whether the collection is empty. */
   isEmpty: boolean;
-  /** Total number of products */
+  /** Total number of products in the collection. */
   totalProducts: number;
-  /** Whether collection has products */
+  /** Whether the collection contains any products. */
   hasProducts: boolean;
 }
 
 /**
- * Headless component for product grid
+ * <blockquote class="caution">
  *
+ * **Developer Preview**
+ *
+ * This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
+ *
+ * </blockquote>
+ *
+ * A headless component for displaying products in a grid layout.
+ * Handles product collection display with loading states and error handling.
+ *
+ * > **Notes:**
+ * > * This component is only relevant for [Wix Vibe](https://support.wix.com/en/article/wix-vibe-an-overview) and [Wix Headless](https://dev.wix.com/docs/go-headless/get-started/about-headless/about-wix-headless) developers.
+ * > * Headless components use the render props pattern. They provide ready-to-use business logic and state management, while giving you complete control over the UI, so you can build custom experiences faster without maintaining the underlying logic yourself.
+ *
+
  * @component
  */
 export const Grid = (props: GridProps) => {
@@ -85,42 +99,56 @@ export const Grid = (props: GridProps) => {
 };
 
 /**
- * Props for Item headless component
+ * Props for the Item headless component.
  */
 export interface ItemProps {
-  /** Product data */
+  /** Product data with all available variants and options. */
   product: V3Product;
-  /** Render prop function that receives product item data */
+  /** Function that receives product item data. Use this function to render your custom UI components with the provided product information. */
   children: (props: ItemRenderProps) => React.ReactNode;
 }
 
 /**
- * Render props for Item component
+ * Render props for the Item component.
  */
 export interface ItemRenderProps {
-  /** Product ID */
+  /** Product ID. */
   id: string;
-  /** Product title */
+  /** Display name of the product. */
   title: string;
-  /** Product slug for URL */
+  /** URL-friendly product identifier used in product page URLs. */
   slug: string;
-  /** Main product image URL */
+  /** Main product image URL. */
   image: string | null;
-  /** Product price */
+  /** Formatted product price that reflects the variant pricing. */
   price: string;
-  /** Compare at price (for strikethrough) */
+  /** Original price for comparison. Indicates a discount when available. */
   compareAtPrice: string | null;
-  /** Product description */
+  /** Product description. */
   description: string;
-  /** Whether product is available */
+  /** Whether the product is available for purchase based on inventory status. */
   available: boolean;
-  /** Product URL */
+  /** Direct link to the product page. */
   href: string;
 }
 
 /**
- * Headless component for individual product item
+ * <blockquote class="caution">
+ *
+ * **Developer Preview**
+ *
+ * This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
  *
+ * </blockquote>
+ *
+ * A headless component for displaying individual product items.
+ * Provides structured product details including pricing, availability, images, and navigation links.
+ *
+ * > **Notes:**
+ * > * This component is only relevant for [Wix Vibe](https://support.wix.com/en/article/wix-vibe-an-overview) and [Wix Headless](https://dev.wix.com/docs/go-headless/get-started/about-headless/about-wix-headless) developers.
+ * > * Headless components use the render props pattern. They provide business logic and state management, while giving you full control over the UI so you can build custom experiences faster.
+ *
+
  * @component
  */
 export const Item = (props: ItemProps) => {
@@ -159,35 +187,48 @@ export const Item = (props: ItemProps) => {
 };
 
 /**
- * Props for LoadMore headless component
+ * Props for the LoadMore headless component.
  */
 export interface LoadMoreProps {
-  /** Render prop function that receives load more data */
+  /** Function that receives pagination and loading state data. Use this function to render your custom loading and pagination UI components. */
   children: (props: LoadMoreRenderProps) => React.ReactNode;
 }
 
 /**
- * Render props for LoadMore component
+ * Render props for the LoadMore component.
  */
 export interface LoadMoreRenderProps {
-  /** Function to load more products */
+  /** Function to load additional products. */
   loadMore: () => Promise<void>;
-  /** Function to refresh products */
+  /** Function to refresh the collection data. */
   refresh: () => Promise<void>;
-  /** Whether load more is currently loading */
+  /** Whether additional products are loading. */
   isLoading: boolean;
-  /** Whether there are products */
+  /** Whether the collection contains any products. */
   hasProducts: boolean;
-  /** Total number of products currently loaded */
+  /** Total number of products in the collection. */
   totalProducts: number;
-  /** Whether there are more products to load */
+  /** Whether there are more products available to load. */
   hasMoreProducts: boolean;
 }
 
 /**
- * Headless component for load more products functionality
- * Note: V3 API uses simplified loading without traditional pagination
+ * <blockquote class="caution">
+ *
+ * **Developer Preview**
+ *
+ * This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
+ *
+ * </blockquote>
  *
+ * A headless component that enables progressive loading of products.
+ * Loads additional products without traditional pagination for infinite scroll functionality.
+ *
+ * > **Notes:**
+ * > * This component is only relevant for [Wix Vibe](https://support.wix.com/en/article/wix-vibe-an-overview) and [Wix Headless](https://dev.wix.com/docs/go-headless/get-started/about-headless/about-wix-headless) developers.
+ * > * Headless components use the render props pattern. They provide business logic and state management, while giving you full control over the UI so you can build custom experiences faster.
+ *
+
  * @component
  */
 export const LoadMore = (props: LoadMoreProps) => {
@@ -236,28 +277,42 @@ export const LoadMore = (props: LoadMoreProps) => {
 };
 
 /**
- * Props for Header headless component
+ * Props for the Header headless component.
  */
 export interface HeaderProps {
-  /** Render prop function that receives collection header data */
+  /** Function that receives collection metadata such as product count and loading state. Use this function to render your custom header UI components. */
   children: (props: HeaderRenderProps) => React.ReactNode;
 }
 
 /**
- * Render props for Header component
+ * Render props for the Header component.
  */
 export interface HeaderRenderProps {
-  /** Total number of products */
+  /** Total number of products in the collection. */
   totalProducts: number;
-  /** Whether collection is loading */
+  /** Whether the collection data is loading. */
   isLoading: boolean;
-  /** Whether collection has products */
+  /** Whether the collection contains any products. */
   hasProducts: boolean;
 }
 
 /**
- * Headless component for collection header with product count
+ * <blockquote class="caution">
+ *
+ * **Developer Preview**
+ *
+ * This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
+ *
+ * </blockquote>
+ *
+ * A headless component for displaying collection metadata.
+ * Provides product count and loading state information for use in collection headers.
+ *
+ * > **Notes:**
+ * > * This component is only relevant for [Wix Vibe](https://support.wix.com/en/article/wix-vibe-an-overview) and [Wix Headless](https://dev.wix.com/docs/go-headless/get-started/about-headless/about-wix-headless) developers.
+ * > * Headless components use the render props pattern. They provide business logic and state management, while giving you full control over the UI so you can build custom experiences faster.
  *
+
  * @component
  */
 export const Header = (props: HeaderProps) => {
@@ -296,31 +351,44 @@ export const Header = (props: HeaderProps) => {
 };
 
 /**
- * Props for Actions headless component
+ * Props for the Actions headless component.
  */
 export interface ActionsProps {
-  /** Render prop function that receives collection actions data */
+  /** Function that receives collection action controls and state. Use this function to render your custom action UI components. */
   children: (props: ActionsRenderProps) => React.ReactNode;
 }
 
 /**
- * Render props for Actions component
+ * Render props for the Actions component.
  */
 export interface ActionsRenderProps {
-  /** Function to refresh the collection */
+  /** Function to refresh the collection data. */
   refresh: () => Promise<void>;
-  /** Function to load more products */
+  /** Function to load additional products. */
   loadMore: () => Promise<void>;
-  /** Whether actions are loading */
+  /** Whether an action is loading. */
   isLoading: boolean;
-  /** Error message if any */
+  /** Error message if an action fails. */
   error: string | null;
 }
 
 /**
- * Headless component for collection actions (refresh, load more)
- * Replaces traditional pagination for V3 API
+ * <blockquote class="caution">
+ *
+ * **Developer Preview**
+ *
+ * This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
+ *
+ * </blockquote>
  *
+ * A headless component that provides collection action controls.
+ * Manages refresh and load more functionality, and replaces the need for traditional pagination.
+ *
+ * > **Notes:**
+ * > * This component is only relevant for [Wix Vibe](https://support.wix.com/en/article/wix-vibe-an-overview) and [Wix Headless](https://dev.wix.com/docs/go-headless/get-started/about-headless/about-wix-headless) developers.
+ * > * Headless components use the render props pattern. They provide business logic and state management, while giving you full control over the UI so you can build custom experiences faster.
+ *
+
  * @component
  */
 export const Actions = (props: ActionsProps) => {
diff --git a/packages/headless-components/stores/src/react/FilteredCollection.tsx b/packages/headless-components/stores/src/react/FilteredCollection.tsx
index 501643940..87efa3254 100644
--- a/packages/headless-components/stores/src/react/FilteredCollection.tsx
+++ b/packages/headless-components/stores/src/react/FilteredCollection.tsx
@@ -14,14 +14,34 @@ import {
 
 export type { AvailableOptions, Filter, FilterServiceAPI };
 
-// Filters Loading component with pulse animation
+/**
+ * Props for the FiltersLoading headless component.
+ */
 export interface FiltersLoadingProps {
-  children: (data: { isFullyLoaded: boolean }) => ReactNode;
+  /** Function that receives loading state data. Use this function to render your custom loading UI components while filters are being prepared. */
+  children: (data: {
+    /** Whether all filter options have been fully loaded and are ready to display. */
+    isFullyLoaded: boolean;
+  }) => ReactNode;
 }
 
 /**
- * Headless component for displaying a loading state for filters
+ * <blockquote class="caution">
+ *
+ * **Developer Preview**
+ *
+ * This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
  *
+ * </blockquote>
+ *
+ * A headless component that provides filter initialization status.
+ * Tracks whether all filter options have been fully loaded and are ready for user interaction.
+ *
+ * > **Notes:**
+ * > * This component is only relevant for [Wix Vibe](https://support.wix.com/en/article/wix-vibe-an-overview) and [Wix Headless](https://dev.wix.com/docs/go-headless/get-started/about-headless/about-wix-headless) developers.
+ * > * Headless components use the render props pattern. They provide business logic and state management, while giving you full control over the UI so you can build custom experiences faster.
+ *
+
  * @component
  */
 export const FiltersLoading: React.FC<FiltersLoadingProps> = ({ children }) => {
@@ -32,21 +52,44 @@ export const FiltersLoading: React.FC<FiltersLoadingProps> = ({ children }) => {
   return <>{children({ isFullyLoaded })}</>;
 };
 
-// Grid component for displaying filtered products
+/**
+ * Props for the Grid headless component.
+ */
 export interface FilteredGridProps {
+  /** Function that receives filtered product grid data and loading states. Use this function to render your custom UI components with the provided filtered product data. */
   children: (data: {
+    /** Array of filtered products. Learn about [managing products and categories](https://support.wix.com/en/managing-products-and-categories). */
     products: V3Product[];
+    /** Total number of products matching the current filters. */
     totalProducts: number;
+    /** Whether the filtered collection data is loading. */
     isLoading: boolean;
+    /** Error message if loading fails. */
     error: string | null;
+    /** Whether the filtered collection is empty. */
     isEmpty: boolean;
+    /** Whether there are more filtered products available to load. */
     hasMoreProducts: boolean;
   }) => ReactNode;
 }
 
 /**
- * Headless component for displaying a grid of filtered products
+ * <blockquote class="caution">
+ *
+ * **Developer Preview**
+ *
+ * This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
+ *
+ * </blockquote>
+ *
+ * A headless component for displaying filtered products in a grid layout.
+ * Handles product collection display with applied filters and automatically updates when filters change.
  *
+ * > **Notes:**
+ * > * This component is only relevant for [Wix Vibe](https://support.wix.com/en/article/wix-vibe-an-overview) and [Wix Headless](https://dev.wix.com/docs/go-headless/get-started/about-headless/about-wix-headless) developers.
+ * > * Headless components use the render props pattern. They provide business logic and state management, while giving you full control over the UI so you can build custom experiences faster.
+ *
+
  * @component
  */
 export const Grid: React.FC<FilteredGridProps> = ({ children }) => {
@@ -73,24 +116,50 @@ export const Grid: React.FC<FilteredGridProps> = ({ children }) => {
   );
 };
 
-// Item component for individual product rendering
+/**
+ * Props for the Item headless component.
+ */
 export interface FilteredItemProps {
+  /** Product data with all available variants and options. */
   product: V3Product;
+  /** Function that receives filtered product item data. Use this function to render your custom UI components with the provided product information. */
   children: (data: {
+    /** Display name of the product. */
     title: string;
+    /** Main product image URL. */
     image: string | null;
+    /** Alternative text for the product image for accessibility. */
     imageAltText: string | null;
+    /** Formatted product price that reflects the variant pricing. */
     price: string;
+    /** Original price for comparison. Indicates a discount when available. */
     compareAtPrice: string | null;
+    /** Whether the product is available for purchase based on inventory status. */
     available: boolean;
+    /** URL-friendly product identifier used in product page URLs. */
     slug: string;
+    /** Product description. */
     description?: string;
   }) => ReactNode;
 }
 
 /**
- * Headless component for displaying a filtered product item
+ * <blockquote class="caution">
+ *
+ * **Developer Preview**
  *
+ * This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
+ *
+ * </blockquote>
+ *
+ * A headless component for displaying individual filtered product items.
+ * Provides structured product details including pricing, availability, images, and navigation links for filtered results.
+ *
+ * > **Notes:**
+ * > * This component is only relevant for [Wix Vibe](https://support.wix.com/en/article/wix-vibe-an-overview) and [Wix Headless](https://dev.wix.com/docs/go-headless/get-started/about-headless/about-wix-headless) developers.
+ * > * Headless components use the render props pattern. They provide business logic and state management, while giving you full control over the UI so you can build custom experiences faster.
+ *
+
  * @component
  */
 export const Item: React.FC<FilteredItemProps> = ({ product, children }) => {
@@ -137,21 +206,44 @@ export const Item: React.FC<FilteredItemProps> = ({ product, children }) => {
   );
 };
 
-// Load More component for pagination
+/**
+ * Props for the LoadMore headless component.
+ */
 export interface FilteredLoadMoreProps {
+  /** Function that receives pagination and loading state data for filtered products. Use this function to render your custom loading and pagination UI components. */
   children: (data: {
+    /** Function to load additional filtered products. */
     loadMore: () => Promise<void>;
+    /** Function to refresh the filtered collection data. */
     refresh: () => Promise<void>;
+    /** Whether additional filtered products are loading. */
     isLoading: boolean;
+    /** Whether the filtered collection contains any products. */
     hasProducts: boolean;
+    /** Total number of products matching the current filters. */
     totalProducts: number;
+    /** Whether there are more filtered products available to load. */
     hasMoreProducts: boolean;
   }) => ReactNode;
 }
 
 /**
- * Headless component for load more filtered products functionality
+ * <blockquote class="caution">
+ *
+ * **Developer Preview**
+ *
+ * This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
+ *
+ * </blockquote>
+ *
+ * A headless component that enables progressive loading of filtered products.
+ * Loads additional products that match applied filters without traditional pagination.
  *
+ * > **Notes:**
+ * > * This component is only relevant for [Wix Vibe](https://support.wix.com/en/article/wix-vibe-an-overview) and [Wix Headless](https://dev.wix.com/docs/go-headless/get-started/about-headless/about-wix-headless) developers.
+ * > * Headless components use the render props pattern. They provide business logic and state management, while giving you full control over the UI so you can build custom experiences faster.
+ *
+
  * @component
  */
 export const LoadMore: React.FC<FilteredLoadMoreProps> = ({ children }) => {
@@ -178,21 +270,44 @@ export const LoadMore: React.FC<FilteredLoadMoreProps> = ({ children }) => {
   );
 };
 
-// Filters component for managing filters
+/**
+ * Props for the Filters headless component.
+ */
 export interface FilteredFiltersProps {
+  /** Function that receives filter management data and state. Use this function to render your custom filter UI components with the provided filter options and controls. */
   children: (data: {
+    /** Function to apply selected filters to the product collection. */
     applyFilters: (filters: Filter) => void;
+    /** Function to clear all applied filters and show all products. */
     clearFilters: () => void;
+    /** Currently applied filter settings including price ranges and selected options. */
     currentFilters: Filter;
+    /** Array of all products available for filtering. Learn about [managing products and categories](https://support.wix.com/en/managing-products-and-categories). */
     allProducts: V3Product[];
+    /** Available filter options including price ranges and product attributes. */
     availableOptions: AvailableOptions;
+    /** Whether any filters are currently applied to the collection. */
     isFiltered: boolean;
   }) => ReactNode;
 }
 
 /**
- * Headless component for product filters with available options
+ * <blockquote class="caution">
+ *
+ * **Developer Preview**
  *
+ * This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
+ *
+ * </blockquote>
+ *
+ * A headless component for managing product filters with available options.
+ * Provides comprehensive filter functionality including price ranges, product attributes, and custom options, and automatically updates the product collection when filters are applied.
+ *
+ * > **Notes:**
+ * > * This component is only relevant for [Wix Vibe](https://support.wix.com/en/article/wix-vibe-an-overview) and [Wix Headless](https://dev.wix.com/docs/go-headless/get-started/about-headless/about-wix-headless) developers.
+ * > * Headless components use the render props pattern. They provide business logic and state management, while giving you full control over the UI so you can build custom experiences faster.
+ *
+
  * @component
  */
 export const Filters: React.FC<FilteredFiltersProps> = ({ children }) => {