Custom Shop Styles
Ask your AI assistant to style your shop and review the result in the familiar AI Mode editor.
AI Mode → Custom Shop Styles appears when WooCommerce is active. It uses the same cards, General and Design & Code tabs, code editor and responsive preview as Custom Header Styles.
Shop Areas
Choose Global Shop UI, Product Thumbnails & Grids, Single Product Page, Cart Page, Checkout, Order Received or My Account. Side Cart appears when Lay Theme's native Side Cart is enabled. Each area has its own switch and Desktop, Tablet and Phone CSS.
The existing Use Custom Style switch works like Custom Header Styles: your custom CSS takes over the native appearance of the enabled shop area. Native layout settings, purchasing controls and shop behavior remain available. Your saved CSS remains available when you turn the switch off.
Preview Your Design
Choose a published preview product and switch between Desktop, Tablet and Phone. Cart and Side Cart offer filled and empty states. Checkout offers its normal and validation-error states. Order Received previews both native layouts. My Account includes dashboard, orders, address and account forms, and login.
The preview uses the existing Lay Theme and WooCommerce templates with sample cart and order data. It does not create an order or change your real cart. Payment controls are examples and cannot process payments. Preview URLs require an authenticated administrator and are marked noindex.
From Figma to Custom Shop Styles
You can use the Figma → Claude → Lay workflow to style your shop too. Design a product page, Side Cart, checkout or another shop area in Figma, copy its Dev Mode link and share it with Claude after connecting Claude to your website through AI Mode.
Follow the Figma and connection steps in the AI Mode tutorial. For shop styling, ask Claude to use Custom Shop Styles and adapt the existing Lay Theme and WooCommerce controls to your design. The tutorial's Custom Element example shows the general workflow; Shop Styles applies CSS to the existing shop areas.
You can use Claude, or another connected coding assistant with access to the Figma design. Review the result under AI Mode → Custom Shop Styles. New shop functionality can be added separately through a plugin, as described below.
Example Prompt
The assistant reads the Shop Styles resource before making changes, validates the plan, applies it and reads it back. Review the preview and the real shop. AI changes appear in Change History and can be undone while they are the newest change and have not been edited afterwards.
Design & Code
Selectors are automatically limited to the chosen shop area. Use :scope to style its root. CSS uses the page Phone breakpoint and the Tablet breakpoint, independently of the Phone Menu breakpoint. Desktop and Phone provide separate base styles; Tablet CSS overrides Desktop within the tablet range.
/* Single Product Page */
:scope .single_add_to_cart_button {
border-radius: 999px;
padding: 1em 1.5em;
}
Styles are stored in the WordPress database, remain intact during Lay Theme updates, and can be transferred under Tools → Export / Import → Custom Shop Styles.
Lay uses its own searchable dropdowns for checkout Country/Region and State/County fields. In the Checkout target, style .lay-select-search-input, .lay-select-search-options and .lay-select-option, including :hover, .selected and .disabled. Select2 selectors alone do not cover these controls. Keep the options list scrollable; its native scrolling is excluded from page smooth scrolling.
Inside enabled areas, Lay excludes its native visual rules, including Customizer visuals and native thumbnail Text Formats, so ordinary scoped CSS can style fonts, colors, buttons and fields without fighting those rules. Structural layout and icon glyphs stay available. Plugin CSS and CSS you have written yourself keep their own priorities. Use Global Shop UI variables for shared colors, fonts and corner radii. Global styles provide defaults in a lower CSS layer; ordinary area-specific styles take priority, even with simpler selectors. Avoid !important in Global defaults, because it reverses CSS layer priority. Global Shop UI also takes over native appearance in its shared areas. To return an area fully to native styling, turn off both its own switch and any overlapping Global Shop UI style.
Native Components and Interaction Checks
The Browser Bridge includes a component reference for every shop area, with native selectors, states and interaction checks. The assistant should inspect the real markup too, because settings and plugins can change it.
| Area | Components and checks |
|---|---|
| Global Shop UI | Buttons, fields, prices and notices. Keep hover, keyboard focus, disabled, loading and validation states visible. |
| Product Thumbnails & Grids | Images, titles, prices, brands, descriptions and stock labels. Review sale and out-of-stock products and linked navigation. |
| Single Product Page | Gallery, variations, quantity, purchase button, tabs and related products. Select and reset variations, add products and check loading and error recovery. |
| Cart Page | Items, quantities, coupons, shipping and totals. Update quantities, remove and undo, review coupon feedback and the empty cart. |
| Side Cart | Overlay, panel, items, quantity controls, notices and footer. Check fragment updates, independent list scrolling, X, overlay and Escape; keep keyboard focus inside the open dialog and restore it on close. |
| Checkout | Address fields, searchable country/state lists, shipping, payment containers, terms and order review. Check search, selection, outside click, Tab, Escape, nested scrolling and country-dependent state options. |
| Order Received | Both confirmation layouts, order details, downloads and customer details. Keep status, totals and payment instructions readable. |
| My Account | Navigation, login, registration when enabled, orders, addresses, account details and password reset. Review keyboard navigation and validation. |
Product variation dropdowns and swatches also use Lay controls: .lay-woocommerce-variations-select, .lay-woocommerce-variations-select-selected-field and .lay-woocommerce-variations-select-selected-list. Style .lay-dropdown-active, [selected] and .lvs-disabled states. Native product tabs use .lay-woocommerce-tab-title and .lay-woocommerce-tab-content.
Review these interactions on the real shop and at Desktop, Tablet and Phone widths. The isolated preview lets you review sample states; it cannot prove that a real purchase or account update works. Test orders only with an authorized sandbox payment setup.
When to Use a Plugin
Use native Customizer settings for existing layout options, Shop Styles for CSS, and Product Custom Views for product content composition. New checkout fields, validation, integrations or other server-side features belong in a separate WordPress plugin. The assistant can build that plugin when its coding environment has authorized filesystem access; the Browser Bridge itself cannot install PHP.
Keep native purchasing controls, validation messages, terms and totals accessible. Shop Styles supports Lay's classic WooCommerce templates and native Side Cart. Block Cart/Checkout, third-party side carts and payment fields inside external iframes use their own styling APIs.
See Plugin Extensions, Shop Hooks & Filters, and the official WooCommerce template and hook documentation.
For Coding Assistants
Read GET /wp-json/laytheme/v1/ai/shop-styles for available targets, selectors, breakpoints, current styles, preview states and the versioned componentReference. It describes native controls and their open, selected, disabled, loading, error and empty states, plus interaction checks. Submit shop_styles.update through the normal validate → apply workflow. The resource is available only while WooCommerce is active. Styling access does not grant access to edit orders, customers, inventory or payments.
{
"changes": [{
"action": "shop_styles.update",
"definition": {
"styles": {
"product": {
"enabled": true,
"css_desktop": ":scope .single_add_to_cart_button { border-radius: 999px; }",
"css_tablet": "",
"css_phone": ":scope .single_add_to_cart_button { width: 100%; }"
}
}
}
}]
}