# Docs - 3.x: Release candidate - Documentation: Install Shopper, configure it and work with its models, from the catalog to orders. - **Prologue** - [Introduction](/3.x/getting-started): Shopper is an open-source headless e-commerce package for Laravel, with an admin panel, a Store API and the commerce logic your store needs. - [What's New in 3.0](/3.x/whats-new): Shopper 3.0 adds a Store API with a JavaScript SDK, promotions, carrier tracking, outbound webhooks, a CSV import and a new admin shell, on Filament 5 and Livewire 4. - [Contribution Guide](/3.x/contributing): Report a bug, propose a feature or send a pull request to Shopper, and run the checks a pull request must pass. - [Version Support Policy](/3.x/version-support-policy): How Shopper numbers its versions, and how long each major version receives new features, bug fixes and security fixes. - **Getting Started** - [Requirements](/3.x/requirements): The PHP version, PHP extensions, databases and Laravel versions Shopper 3 needs, and the local environments that provide them. - [Installation](/3.x/installation): Install Shopper 3 in a Laravel 12 or 13 application, create the first admin user, and run the scheduler and queue worker it relies on. - [Configuration](/3.x/configuration): The configuration files Shopper publishes, and the settings to decide before your store goes live, from the admin prefix to feature flags. - [Dashboard](/3.x/dashboard): The widgets on the admin dashboard, the setup guide for new stores, who can see what, and how to change the page. - [Using Shopper with AI Tools](/3.x/ai-tools): Give Claude Code, Cursor or any coding agent the Shopper conventions through Laravel Boost, and read this documentation as Markdown. - **Core Concepts** - [Architecture and Packages](/3.x/architecture): The Composer and npm packages that make up Shopper 3, how they depend on each other, and the two ways a storefront reads store data. - [Models and Contracts](/3.x/models): The Eloquent models Shopper ships, how to replace one with your own class, and the morph aliases, public IDs and table names they share. - [Money](/3.x/money): How Shopper stores amounts as integers in cents, handles zero-decimal currencies, and formats prices in PHP, the admin panel and the Store API. - [Channels](/3.x/channels): Sales channels in Shopper, from the Channel model and its drivers to products per channel and the X-Shopper-Channel header of the Store API. - [Permissions](/3.x/acl): The roles and dot notation permissions of the admin panel, what each section checks, the team safeguards, and how to check permissions in code. - [Events](/3.x/events): The events Shopper dispatches for orders, payments, shipments, products, customers and carts, when each one fires, and how to listen to them. - [Settings](/3.x/settings): The key-value table behind the store settings, the helpers that read and write it, its cache, and every setting key Shopper uses. - **Catalog** - [Products](/3.x/products): The Product model of Shopper 3.x, its four types, relationships, scopes, stock ledger and media, and how to query products for a storefront. - [Product Variants](/3.x/product-variants): The ProductVariant model in Shopper, options from attributes, variant generation, SKU, stock and media per variant, and variants in carts and orders. - [Pricing](/3.x/pricing): Prices per currency on products and variants, the Price model, the HasPrices trait, the price resolver, and the prices the Store API returns. - [Product Tags](/3.x/product-tags): Flat labels on products, from the ProductTag model and its pivot table to the tag scope and the tag filter of the Store API. - [Brands](/3.x/brands): The Brand model in Shopper, its columns, logo and SEO fields, enabling a brand, and querying products by brand in code and through the Store API. - [Categories](/3.x/categories): The Category model in Shopper, the category tree and its visibility rules, media and SEO, and querying a category with its products and descendants. - [Collections](/3.x/collections): The Collection model in Shopper, manual and automatic collections, collection rules, and how automatic collections stay in sync with the catalog. - [Attributes](/3.x/attributes): The Attribute model in Shopper, field types, attribute values, product attributes and variant options, and the searchable and filterable flags. - [Reviews](/3.x/reviews): Product reviews in Shopper, from the Review model and its ratings to approval, the admin moderation page and the Store API review endpoints. - [Suppliers](/3.x/suppliers): The Supplier model in Shopper, its columns and feature flag, linking products to a supplier, and forwarding order items for dropshipping. - [Search](/3.x/search): How Shopper indexes products, brands, categories, collections, orders and customers with Laravel Scout, and how to choose a search engine per model. - **Sales** - [Customers](/3.x/customers): Customers in Shopper are your User model with an address book, roles and orders. Columns, addresses, anonymization and the Store API account. - [Cart](/3.x/cart): The Shopper cart package, from the cart models and session to the calculation pipeline, stock checks, order conversion and abandoned carts. - [Orders](/3.x/orders): The Order model of Shopper 3.x, its items and addresses, the order, payment and shipping statuses, order numbers and the reclaim of unpaid orders. - [Payments](/3.x/payments): Take payments through Stripe or your own provider with payment drivers, payment sessions, provider webhooks, reconciliation and refunds. - [Stripe](/3.x/payments/stripe): Accept card payments in Shopper with Stripe PaymentIntents, 3D Secure, manual or automatic capture, refunds and signed webhooks. - [Fulfillment](/3.x/fulfillment): Shipments in Shopper, their statuses and transitions, packages split across carriers, carrier tracking events, returns and the fulfillment status of items. - [Taxes](/3.x/taxes): Tax zones, rates and override rules in Shopper, how the cart computes tax per line, tax-inclusive prices, order tax lines and custom providers. - [Discounts](/3.x/discounts): The Discount model in Shopper, discount types and rules, eligibility, usage limits, automatic discounts, and how promotions stack on a cart. - **Marketing** - [Campaigns](/3.x/campaigns): The Campaign model in Shopper, campaign status, shared spend and usage budgets, budget movements, and how a campaign caps its discounts. - **Store Setup** - [Setup Store](/3.x/setup-store): The setup wizard a merchant completes on the first login, the General settings page, and the setting key that stores each store detail. - [Zones](/3.x/zones): The Zone model in Shopper, the countries, currency, carriers and payment methods of a zone, and how the Store API resolves the zone of a request. - [Locations](/3.x/locations): Inventory locations in Shopper, stock levels per location, the default location, how orders draw stock from several locations, and reconciling stock. - [Currencies](/3.x/currencies): The Currency model in Shopper, enabled currencies, the store currencies and default currency, and how a store sells in several currencies. - [Carriers](/3.x/carriers): Carriers and their shipping options per zone, shipping drivers and live carrier rates, failing carriers and custom shipping drivers in Shopper. - [FedEx](/3.x/carriers/fedex): Quote live FedEx rates at checkout and track FedEx packages with the shopper/fedex driver, its credentials, sandbox mode and services. - [UPS](/3.x/carriers/ups): Quote live UPS rates at checkout and track UPS packages with the shopper/ups driver, its credentials, sandbox mode and services. - [USPS](/3.x/carriers/usps): Quote live USPS retail rates in US dollars at checkout with the shopper/usps driver, its credentials, sandbox mode and services. - [Payment Methods](/3.x/payment-methods): The PaymentMethod model in Shopper, the zones where a method is offered, and how each method maps to a payment driver. - [Legal](/3.x/legal): The Legal model behind a store's refund, privacy, terms and shipping pages, enabling them, and reading them in Blade or through the Store API. - **System** - [Team](/3.x/team): Team members of the admin panel, adding a member, the welcome email, roles, the Team screen and removing a member. - [Webhooks](/3.x/webhooks): Signed HTTP requests Shopper sends to external systems on order, shipment, product, customer and checkout events, with retries. - [Notifications](/3.x/notifications): The notifications Shopper sends to administrators and customers, the events behind them, and how to enable, change, replace or turn them off. - [Themes](/3.x/themes): The color themes of the admin panel, the CSS tokens a theme sets, and how to register a theme of your own from your application or a package. - [Import](/3.x/import): Import products, variants, prices, stock and images from a CSV file, from the admin panel or from your code, in queued batches. - [Media](/3.x/media): Store catalog images with Spatie Media Library, and configure the disk, collections, accepted types, upload sizes and conversions. - [Two-Factor Authentication](/3.x/two-factor): Authenticator app codes, recovery codes and passkeys for admin users, what the User model needs, and the events Shopper dispatches. - **Releases** - [Upgrade Guide](/3.x/upgrade): Upgrade a Shopper 2.x store to 3.0 with the shopper:upgrade command, then update the code and config files it does not change. - Storefront: Starter kits, the Store API and the JavaScript SDK for the customer side. - [Storefront](/3.x/storefront): Sell from a starter kit, or build your own front end on the Store API. - **Starter Kits** - [Starter Kits](/3.x/starter-kits): Complete storefronts that the installer copies into your Laravel application, and how to build and publish your own. - [Livewire Starter Kit](/3.x/livewire-starter-kit): A Shopper storefront built with Livewire 4, Flux UI and Tailwind CSS v4, installed into your Laravel application with one command. - [React Starter Kit](/3.x/react-starter-kit): A Shopper storefront built with Inertia, React 19, shadcn/ui and Tailwind CSS v4, installed into your Laravel application with one command. - [Vue Starter Kit](/3.x/vue-starter-kit): A Shopper storefront built with Inertia, Vue 3, shadcn-vue and Tailwind CSS v4, installed into your Laravel application with one command. - [Creating a Starter Kit](/3.x/starter-kits/creating): Build a starter kit from a working Shopper storefront with shopper:kit:init and shopper:kit:export, then publish it and list it on the Shopper website. - **Store API** - [Store API](/3.x/store-api): The HTTP API a headless storefront calls to browse the catalog, run the cart and checkout, and manage customer accounts and orders. - [Authentication](/3.x/store-api/authentication): Register and log in customers, send their bearer token, reset passwords, and know what a guest can do without a token. - [JSON:API Conventions](/3.x/store-api/json-api): The shape of Store API documents, and the include, fields, filter, sort and page parameters that every endpoint reads the same way. - [Errors](/3.x/store-api/errors): The error object of the Store API, validation and rate limit errors, and every error code with its HTTP status and what the storefront should do. - [Catalog](/3.x/store-api/catalog): List and filter products, read a product with its variants and prices, and browse categories, collections, brands, tags, attributes and reviews. - [Store and Regions](/3.x/store-api/store): Read the store settings, legal pages, countries, zones and currencies, and pick the zone and the currency a storefront prices in. - [Cart](/3.x/store-api/cart): Create a cart, add products and variants, set addresses and promotion codes, and read the totals the Store API computes. - [Checkout](/3.x/store-api/checkout): Choose shipping and payment for a cart, open a payment session, and turn the cart into an order with the Store API. - [Customers](/3.x/store-api/customers): Read and update the signed-in customer's profile, profile picture and addresses, and attach a guest cart to their account. - [Orders](/3.x/store-api/orders): Show the order confirmation, list a customer's orders, track shipments and download the files of a paid order. - **JavaScript SDK** - [JavaScript SDK](/3.x/sdk): The typed JavaScript client of the Store API, for browsers, Node.js, React Native and edge runtimes. - [Authentication](/3.x/sdk/authentication): Register and log in customers with the JavaScript SDK, keep their token across page loads and handle its expiration. - [Errors](/3.x/sdk/errors): Catch ShopperApiError in the JavaScript SDK, show validation messages next to their fields and react to the error codes of the Store API. - [Catalog](/3.x/sdk/catalog): List and filter products, show a product page, and read categories, collections, brands, tags, attributes and reviews with the JavaScript SDK. - [Store and Regions](/3.x/sdk/store): Read the store settings, the legal pages, and the countries, zones and currencies of the shop with the JavaScript SDK. - [Cart](/3.x/sdk/cart): Create a cart with the JavaScript SDK, add and change lines, set addresses, apply promotion codes and transfer a guest cart to a customer. - [Checkout](/3.x/sdk/checkout): Choose the shipping option and the payment method of a cart, pay with Stripe and place the order with the JavaScript SDK. - [Customers](/3.x/sdk/customers): Read and update the profile of the logged-in customer, upload a profile picture and manage saved addresses with the JavaScript SDK. - [Orders](/3.x/sdk/orders): Show the order confirmation, list the orders of a customer, track a shipment and download purchased files with the JavaScript SDK. - [Custom Endpoints](/3.x/sdk/custom-endpoints): Call your own Store API routes, the routes of an add-on and the options the SDK does not wrap with store.fetch(), buildQuery() and flatten(). - User Guide: Run the store from the admin panel, screen by screen, without writing code. - [User Guide](/3.x/user-guide): Run your store from the Shopper admin panel, without writing code. - Extending: Add pages and features to the admin panel and swap the parts Shopper ships. - **Admin Panel** - [Extending Shopper](/3.x/extending/overview): Learn how to extend Shopper with custom features and functionalities - [Control Panel](/3.x/extending/control-panel): Customize the Shopper control panel with your own assets, routes, and branding - [Navigation](/3.x/extending/navigation): Customize and extend the Shopper control panel navigation - [Controllers](/3.x/extending/controllers): Add custom pages to the admin panel using controllers or Livewire components. - [Forms](/3.x/extending/forms): Build Filament forms in your own admin pages, with the fields and layout of Shopper forms. - [Slide-overs](/3.x/extending/slideover): Open forms in a side panel of the admin panel, like the brand and attribute forms of Shopper. - [Render Hooks](/3.x/render-hooks): Inject custom HTML, Livewire components, or Blade views into specific positions across the admin panel without modifying Shopper's core views. - **Sidebar** - [Sidebar Package](/3.x/sidebar/overview): The shopper/sidebar package builds the Shopper admin sidebar and any Laravel sidebar, with Blade views, a Livewire component and an Alpine.js store. - [Extending Shopper](/3.x/sidebar/shopper-extension): Add groups, entries, badges and quick actions to the Shopper admin sidebar from your application with a SidebarBuilder listener. - [Standalone Installation](/3.x/sidebar/standalone): Install shopper/sidebar in a Laravel application without Shopper, then build, render and style a sidebar with breadcrumbs. - [Configuration](/3.x/sidebar/configuration): Configure the sidebar cache, dimensions, breakpoint, collapsing and breadcrumb view, then customize the views and clear the cache. - **Components** - [Overview](/3.x/extending/components/overview): The Blade and Filament components Shopper ships for the admin panel, and how to style and override them. - [Card](/3.x/extending/components/card): A container that groups related content, with an optional title, description and footer. - [Alert](/3.x/extending/components/alert): Display contextual feedback messages in four colors, with an optional title and icon. - [Heading](/3.x/extending/components/heading): Page-level heading with a title and an optional action slot for buttons. - [Section Heading](/3.x/extending/components/section-heading): Section title with an optional description, used to introduce the content of a card or a form. - [Empty State](/3.x/extending/components/empty-state): Illustration, message and call to action shown when a list or table has no records yet. - [Empty Card](/3.x/extending/components/empty-card): Compact empty state for a card or a panel, with an optional icon, description and action. - [Stock Badge](/3.x/extending/components/stock-badge): Colored badge that shows a stock quantity, red below 10 units and green from 10. - [Loader](/3.x/extending/components/loader): Animated spinner for loading states, sized and colored with classes. - [Label](/3.x/extending/components/label): Form field label with an optional required marker. - [Filament Components](/3.x/extending/components/filament): Filament fields, columns and schema components that Shopper adds for its admin forms and tables, and how to use them in yours. - [Utility Components](/3.x/extending/components/utilities): Layout and form helpers of the admin panel: container, link, separator, breadcrumb, errors, dropdown link and form slide-over. - Add-ons: Build, register and publish add-ons that extend the Shopper admin panel and the Store API. - [Add-ons](/3.x/addons): Install, register, disable and customize Shopper add-ons, the Composer packages that add pages and features to the admin panel. - [Creating an Add-on](/3.x/addons/creating): Start a Shopper add-on from the official skeleton, configure it, develop it against a local application and test it. - [Extending the Admin Panel](/3.x/addons/admin-panel): Register routes, Livewire pages, sidebar entries, settings pages, product sections, permissions, render hooks and assets from a Shopper add-on. - [Extending the Store API](/3.x/addons/store-api): Add attributes to the products of the Store API and register Store API routes from a Shopper add-on, so a storefront can read its data. - [Publishing an Add-on](/3.x/addons/publishing): Version a Shopper add-on, tag releases, keep its changelog, publish it on Packagist and list a free or paid add-on on the Shopper website. - Reference: Configuration keys, commands, events, permissions and types, one table per kind. - [Reference](/3.x/reference): Configuration keys, Artisan commands, events, permissions, render hooks, Store API endpoints and TypeScript types. - 2.x: Stable - [2.x](/2.x) - Documentation - **Prologue** - [Introduction](/2.x/getting-started): Shopper is an open-source headless e-commerce package for Laravel that gives you composable building blocks to add commerce to your application. - [Demo Store](/2.x/demo-store): A fully functional e-commerce store built with Shopper to showcase real-world usage patterns. - [Contribution Guide](/2.x/contributing): Guidelines for contributing to Shopper - [Version Support Policy](/2.x/version-support-policy): Learn about Shopper's versioning scheme, support windows, and release cadence. - **Getting Started** - [Requirements](/2.x/requirements): Server and package requirements for running Shopper. - [Installation](/2.x/installation): Install Shopper into your existing Laravel application in a few steps. - [Configuration](/2.x/configuration): Configure the admin panel, models, features, and settings in your Shopper installation. - [Dashboard](/2.x/dashboard): Overview of the admin dashboard components, caching, access requirements, and customization options. - **Core Concepts** - [Channels](/2.x/channels): Complete reference for the Channel model, sales channels, and multi-channel management in Shopper. - [Roles & Permissions](/2.x/acl): Manage user access control programmatically with Spatie Laravel Permission. - [Events](/2.x/events): Reference for all events dispatched by Shopper during order, product, and cart lifecycle operations. - **Catalog** - [Products](/2.x/products): Complete reference for the Product model, types, relationships, stock, pricing, and media. - [Product Variants](/2.x/product-variants): Manage product variants with per-option pricing, stock, and media in Shopper. - [Pricing](/2.x/pricing): Multi-currency pricing for products and variants with cents-based storage. - [Product Tags](/2.x/product-tags): Organize products with flat, flexible labels for filtering and marketing campaigns. - [Brands](/2.x/brands): Manage product brands with logos, SEO metadata, and storefront filtering. - [Categories](/2.x/categories): Complete reference for the Category model, hierarchical relationships, and usage in Shopper. - [Collections](/2.x/collections): Complete reference for the Collection model, automatic rules, and usage in Shopper. - [Attributes](/2.x/attributes): Complete reference for the Attribute model, field types, values, and usage in Shopper. - [Reviews](/2.x/reviews): Complete reference for the Review model, ratings, and product review management in Shopper. - [Suppliers](/2.x/suppliers): Complete reference for the Supplier model, product sourcing, and dropshipping integration in Shopper. - **Sales** - [Customers](/2.x/customers): Complete reference for the User model, addresses, and customer management in Shopper. - [Cart](/2.x/cart): Manage shopping carts with pipeline-based calculation, discount validation, tax integration, and order conversion. - [Orders](/2.x/orders): Complete reference for the Order model, items, addresses, shipping, refunds, and order management in Shopper. - [Payments](/2.x/payments): Process payments through Stripe, PayPal, or any provider using the driver-based payment system. - [Stripe](/2.x/addons/stripe): Accept payments with Stripe using PaymentIntents, 3D Secure, and webhooks. - [Fulfillment](/2.x/fulfillment): Complete guide to order fulfillment, multi-shipment management, and dropshipping workflows in Shopper. - [Taxes](/2.x/taxes): Configure tax zones, rates, and override rules to calculate taxes accurately per region, VAT-inclusive or sales-tax-exclusive. - [Discounts](/2.x/discounts): Complete reference for the Discount model, types, conditions, and usage in Shopper. - **Store Setup** - [Setup Store](/2.x/setup-store): Configure your store's initial settings, address, currencies, and social links. - [Zones](/2.x/zones): Define geographic zones for shipping, currencies, and payment methods. - [Locations](/2.x/locations): Manage inventory locations, warehouses, and fulfillment origins for multi-location stock tracking. - [Currencies](/2.x/currencies): Configure and manage multiple currencies for your global store - [Carriers](/2.x/carriers): Complete reference for the Carrier model, shipping options, and delivery management in Shopper. - [Payment Methods](/2.x/payment-methods): Complete reference for the PaymentMethod model, configuration, and payment management in Shopper. - [Legal](/2.x/legal): Manage legal pages like privacy policy, terms of service, and shipping policies - **System** - [Media](/2.x/media): Manage product images and media files with Spatie Media Library - [Two Factor Authentication](/2.x/two-factor): Secure administrator accounts with two-factor authentication - **Releases** - Upgrade Guide - [Upgrade Guide](/2.x/upgrade): Guides for upgrading your Shopper installation between versions. - [From v2.9 to v2.10](/2.x/upgrade/v2-9-to-v2-10): How to upgrade your Shopper installation from v2.9 to v2.10, a security and cart correctness release that changes three contracts. - [From v2.8 to v2.9](/2.x/upgrade/v2-8-to-v2-9): How to upgrade your Shopper installation from v2.8 to v2.9, with Laravel 13 support and the rebuilt onboarding wizard. - [From v2.7 to v2.8](/2.x/upgrade/v2-7-to-v2-8): How to upgrade your Shopper installation from v2.7 to v2.8 (security release). - [From v2.6 to v2.7](/2.x/upgrade/v2-6-to-v2-7): How to upgrade your Shopper installation from v2.6 to v2.7. - [From v2.5 to v2.6](/2.x/upgrade/v2-5-to-v2-6): How to upgrade your Shopper installation from v2.5 to v2.6. - [From v2.4 to v2.5](/2.x/upgrade/v2-4-to-v2-5): How to upgrade your Shopper installation from v2.4 to v2.5. - [From v2.2 to v2.3](/2.x/upgrade/v2-2-to-v2-3): How to upgrade your Shopper installation from v2.2 to v2.3. - [From v2.1 to v2.2](/2.x/upgrade/v2-1-to-v2-2): How to upgrade your Shopper installation from v2.1 to v2.2. - Storefront - **Starter Kits** - [Starter Kits](/2.x/starter-kits): Pre-built storefronts that give you a working starting point for your Shopper store. - [Livewire Starter Kit](/2.x/livewire-starter-kit): A complete storefront built with Livewire 3, Flux UI and Tailwind CSS v4. - [React Starter Kit](/2.x/react-starter-kit): A Shopper storefront built with Inertia, React 19, shadcn/ui and Tailwind CSS v4. - [Vue Starter Kit](/2.x/vue-starter-kit): A Shopper storefront built with Inertia, Vue 3, shadcn-vue and Tailwind CSS v4. - User Guide - **Getting Started** - [Introduction](/2.x/user-guide/getting-started/introduction): Welcome to Shopper, your e-commerce administration panel for managing products, orders, customers, and more. - [Logging In](/2.x/user-guide/getting-started/login): Learn how to access your Shopper administration panel. - [Discovering Dashboard](/2.x/user-guide/getting-started/dashboard): Get familiar with the Shopper dashboard and navigation. - **Store Setup** - [General Settings](/2.x/user-guide/store-setup/general-settings): Configure your store's basic information and settings. - [Inventory Locations](/2.x/user-guide/store-setup/locations): Manage your store's inventory locations for stock management. - [Currencies](/2.x/user-guide/store-setup/currencies): Configure the currencies accepted by your store. - [Shipping Zones](/2.x/user-guide/store-setup/zones): Define where you ship, which currencies you accept, and which payment and delivery methods are available. - [Shipping Carriers](/2.x/user-guide/store-setup/carriers): Add shipping carriers and delivery options for your store. - [Payment Methods](/2.x/user-guide/store-setup/payment-methods): Configure how customers can pay for their orders. - [Taxes](/2.x/user-guide/store-setup/taxes): Configure tax zones and rates for your store. - [Legal Pages](/2.x/user-guide/store-setup/legal): Configure your store's legal pages including terms of service and privacy policy. - **Catalog** - [Managing Brands](/2.x/user-guide/catalog/brands): Learn how to create and manage product brands in your store. - [Managing Categories](/2.x/user-guide/catalog/categories): Organize your products with categories for better navigation. - [Managing Collections](/2.x/user-guide/catalog/collections): Create curated product collections to highlight specific products. - [Managing Attributes](/2.x/user-guide/catalog/attributes): Create product attributes for variations like size, color, and material. - [Managing Tags](/2.x/user-guide/catalog/tags): Organize products with simple labels for filtering and marketing campaigns. - [Managing Suppliers](/2.x/user-guide/catalog/suppliers): Add and manage product suppliers for dropshipping and external sourcing. - Products - [Overview](/2.x/user-guide/catalog/products/overview): Understand the different product types available and how to manage your catalog. - [Creating a Product](/2.x/user-guide/catalog/products/creating-product): Step-by-step guide to creating a product using the creation wizard. - [Standard Product](/2.x/user-guide/catalog/products/standard-product): Physical products that require shipping and inventory management. - [Virtual Product](/2.x/user-guide/catalog/products/virtual-product): Digital products that don't require shipping, including downloads, subscriptions, and online services. - [External Product (Dropshipping)](/2.x/user-guide/catalog/products/external-product): Products fulfilled by a third-party supplier, ideal for dropshipping and marketplace models. - [Variant Product](/2.x/user-guide/catalog/products/variant-product): Products with multiple options like size, color, or material, where each combination becomes a unique variant. - [Managing Products](/2.x/user-guide/catalog/products/managing-products): Edit pricing, SEO, media, and other settings after product creation. - **Sales** - [Managing Orders](/2.x/user-guide/sales/orders): View, process, and fulfill customer orders from your admin panel. - [Managing Customers](/2.x/user-guide/sales/customers): View and manage your customer accounts and information. - [Managing Reviews](/2.x/user-guide/sales/reviews): Moderate and manage customer product reviews. - **Marketing** - [Managing Discounts](/2.x/user-guide/marketing/discounts): Create and manage discount codes and promotional offers. - [Advanced Pricing](/2.x/user-guide/marketing/pricing): Configure advanced pricing options for your products. - **Administration** - [Managing Staff Users](/2.x/user-guide/administration/users): Add and manage administrator accounts for your store. - [Roles & Permissions](/2.x/user-guide/administration/roles): Configure access control with roles and permissions. - [Two-Factor Authentication](/2.x/user-guide/administration/two-factor): Secure your account with two-factor authentication (2FA). - Extending - **Admin Panel** - [Extending Shopper](/2.x/extending/overview): Learn how to extend Shopper with custom features and functionalities - [Control Panel](/2.x/extending/control-panel): Customize the Shopper control panel with your own assets, routes, and branding - [Navigation](/2.x/extending/navigation): Customize and extend the Shopper control panel navigation - [Controllers](/2.x/extending/controllers): Add custom pages to the admin panel using controllers or Livewire components. - [Render Hooks](/2.x/render-hooks): Inject custom HTML, Livewire components, or Blade views into specific positions across the admin panel without modifying Shopper's core views. - **Sidebar** - [Sidebar Package](/2.x/sidebar/overview): A headless sidebar package for Laravel with Alpine.js integration - [Extending Shopper](/2.x/sidebar/shopper-extension): How to extend the Shopper admin panel sidebar - [Standalone Installation](/2.x/sidebar/standalone): How to use the sidebar package in any Laravel application - [Configuration](/2.x/sidebar/configuration): Configure the sidebar package settings - **Components** - [Overview](/2.x/extending/components/overview): Discover the UI components available in Shopper admin panel - [Card](/2.x/extending/components/card): A container component for grouping related content with optional title and description - [Alert](/2.x/extending/components/alert): Display contextual feedback messages with different severity levels - [Heading](/2.x/extending/components/heading): Page-level heading component with optional action slot - [Section Heading](/2.x/extending/components/section-heading): Section titles with optional descriptions for organizing content - [Empty State](/2.x/extending/components/empty-state): Placeholder component for displaying when no data exists - [Empty Card](/2.x/extending/components/empty-card): Centered empty state for card content areas - [Stock Badge](/2.x/extending/components/stock-badge): Visual indicator for product stock levels - [Loader](/2.x/extending/components/loader): Animated loading spinner - [Label](/2.x/extending/components/label): Form field label with optional required indicator - [User Avatar](/2.x/extending/components/user-avatar): Display user profile picture with optional name - [Utility Components](/2.x/extending/components/utilities): Structural and utility components for layouts - Add-ons - [Add-ons](/2.x/addons): Extend the Shopper admin panel with self-contained addons, register routes, sidebar items, Livewire components, views, and settings without modifying core files. - Reference - **TypeScript** - [Overview](/2.x/reference/typescript-types): Official TypeScript type definitions for Shopper models and entities. - [Product Types](/2.x/reference/types/product): TypeScript type definitions for Product, ProductVariant, and ProductTag models. - [Order Types](/2.x/reference/types/order): TypeScript type definitions for Order, OrderItem, and related models. - [Customer Types](/2.x/reference/types/customer): TypeScript type definitions for Customer and Address models. - [Catalog Types](/2.x/reference/types/catalog): TypeScript type definitions for Category, Brand, Collection, and Attribute models. - 1.x: Archived - **Prologue** - [Contribution Guide](/1.x/contributing): Contributions are accepted via Pull Requests on [Github](https://github.com/shopperlabs/shopper). - **Getting Started** - [Requirements](/1.x/requirements) - [Installation](/1.x/installation): Quick start guide for installing and configuring Shopper on your existing Laravel App - [Configuration](/1.x/configuration): Shopper uses standard Laravel config files and environment variables for application-level settings - **Concepts** - [Customization](/1.x/customization) - [Locations](/1.x/locations) - [Roles & Permissions](/1.x/roles-permissions): Manage access and permissions of your users and members in your store. - [Two Factor Authenticator](/1.x/two-factor): Secure your account with two-step authentication - [Legal](/1.x/legal): As with any e-commerce site, it is important for users to know the terms and conditions and privacy policy that your site offers. This is for their own safety and yours as well. - [Media](/1.x/media) - **Control Panel** - [Dashboard](/1.x/dashboard): The dashboard is a user-customizable screen. One of Shopper's main goals is to enable stores to easily customize the modules. - [Brands](/1.x/brands): Most e-commerce sites sell products from several manufacturers. And each supplier can be represented by a brand. - [Categories](/1.x/categories): Categories are the primary way to group products with similar features. You can also add subcategories if desired. - [Collections](/1.x/collections): Collections, although not strictly the same, are akin to Categories. They serve to allow you to add products ,either explicitly or via certain criteria, for use on your store. - [Customers](/1.x/customers): In e-commerce stores, customers are one if not the fundamental point for the functioning of your store. - [Products](/1.x/products) - [Attributes](/1.x/attributes) - [Reviews](/1.x/reviews) - [Discounts](/1.x/discounts) - [Orders](/1.x/orders) - **Extending** - [Control Panel](/1.x/extending/control-panel): Learn how to customize the Shopper control panel by adding CSS, JS assets, customizing the theme, branding logo, and adding custom routes. - [Controllers](/1.x/extending/controllers): Learn how to create and configure custom controllers for the Shopper admin panel. - [Navigation](/1.x/extending/navigation): Learn how to customize and extend the Shopper control panel navigation by adding your own sections, pages, and menu items.