Pre-release documentation 0.1.0 development Orveta by Jayne
OrvetaHELP CENTER · BY JAYNE

Section tutorials

Product and Featured product

Configure the main product experience or feature a selected product on another compatible page.

Where to find it

In Online Store → Themes, open the unpublished theme editor, choose a compatible template, then Add section → Featured product. Availability follows the selected template and section group.

This section is not available in the Header group, the Footer group.

Set it up

  1. For a product page, select the Products template and a real preview product. For an addable Featured product, choose Featured product in the section settings.
  2. Arrange information blocks in the intended order: Title, Price, Variant picker, Quantity and add to cart or Buy buttons, followed by supporting details.
  3. Choose Gallery style, Image aspect ratio and Default image fit. Theme default inherits the corresponding Theme settings value.
  4. Add Description, Collapsible row, More information, Line item property or other supported blocks only where they have useful content. Connect dynamic content where the editor supports it.
  5. Configure sticky add-to-cart behavior if needed. Review the separate multi-variant option rather than assuming a single-variant purchase flow suits every product.
  6. Preview variant changes, quantity rules, sold-out/unavailable combinations, cart updates and product media before using the template for multiple products.
Product section media and sticky add-to-cart settings in the actual theme editor
Product controls in the default product template. Featured product is selected only when using this section outside the main product template; Theme default inherits the shared media settings. Open the image for a larger view.

Main settings to review

SettingChoices or control
Featured productChoose a product
Gallery styleTheme default · Slideshow · Scroll one column · Scroll two columns
Image aspect ratioTheme default · Adapt to image · Square (1:1) · Portrait (4:5) · Landscape (3:2)
Default image fitTheme default · Cover · Contain
Enable sticky add to cartOn / Off
Enable add to cart for multi-variant productsOn / Off

Blocks and content

  • Vendor — up to 1: configure this inside the section. This block has no independent content settings.
  • Title — up to 1: configure this inside the section. This block has no independent content settings.
  • Price — up to 1: configure this inside the section. Its available controls are listed below.
  • SKU — up to 1: configure this inside the section. This block has no independent content settings.
  • Inventory status — up to 1: configure this inside the section. Its available controls are listed below.
  • Variant picker — up to 1: configure this inside the section. Its available controls are listed below.
  • Quantity and add to cart — up to 1: configure this inside the section. Its available controls are listed below.
  • Buy buttons — up to 1: configure this inside the section. This block has no independent content settings.
  • Description — up to 1: configure this inside the section. This block has no independent content settings.
  • Badges: configure this inside the section. Its available controls are listed below.
  • Rating — up to 1: configure this inside the section. This block has no independent content settings.
  • Separator: configure this inside the section. This block has no independent content settings.
  • Line item property: configure this inside the section. Its available controls are listed below.
  • Volume pricing table — up to 1: configure this inside the section. Its available controls are listed below.
  • Pickup availability — up to 1: configure this inside the section. This block has no independent content settings.
  • Offers: configure this inside the section. Its available controls are listed below.
  • Text: configure this inside the section. Its available controls are listed below.
  • Image: configure this inside the section. Its available controls are listed below.
  • Button: configure this inside the section. Its available controls are listed below.
  • More information: configure this inside the section. Its available controls are listed below.
  • Modal: configure this inside the section. Its available controls are listed below.
  • Custom Liquid: configure this inside the section. Its available controls are listed below.
  • Icon with text: configure this inside the section. Its available controls are listed below.
  • Social share: configure this inside the section. Its available controls are listed below.
  • Collapsible row: configure this inside the section. Its available controls are listed below.

App content requires a compatible installed app. Its setup and support come from that app; the theme does not supply the app service.

Content and media

  • Product media belongs to the product in Shopify. Use consistent, sharp originals; square 1600–2000 px images are a useful starting point when using a square gallery.
  • Choose Contain to preserve a full object silhouette or Cover for an intentionally filled crop. Video and 3D output also depends on media actually assigned to the product.
  • Rating and volume-pricing blocks need corresponding real product data or eligibility; adding a display block does not create reviews, inventory or pricing rules.
  • For 3D and AR, assign a model in Shopify and wait for processing to finish. Select its 3D thumbnail to display the web viewer and the available View in your space control.
  • Supported iPhone and iPad use a native Apple Quick Look link when the browser supports AR and the model has a processed USDZ source. Otherwise, the theme retains the ShopifyXR path used on other eligible devices; its control still depends on device and model eligibility.
  • Before launch, test web rotation and pinch zoom, opening the system viewer, placing the model in your surroundings, and returning to switch media and scroll the page on a real supported phone or tablet. A desktop preview does not verify AR.
  • Unit pricing comes from the product variant measurement configured in Shopify. Check the selected variant, its unit price and the corresponding cart line together.
  • Optional hosted-video captions: create the Orveta video captions metaobject definition and a product Video captions list reference using orveta.video_captions. Select the exact video already used in the product gallery, add up to two direct HTTPS WebVTT URLs with matching language codes and optional labels, then select that entry on the product. Use one entry per video and at most 50 entries per product. Product, Featured product and Quick view share these entries; section/block Video captions are configured in their own editor controls.
  • The complete one-time field table and entry setup are in Build product pages and product sections → Optional hosted video captions.

Check the mobile layout

  • Review the main image, thumbnail strip and variant controls together. Test the longest product title and option names, including names without spaces, for wrapping inside the page. Test vertical page scrolling over media as well as horizontal media navigation, and check sticky controls do not cover purchasing details.

Common questions and fixes

  • Featured product is blank: select an available product; the main product template instead receives its product from the current product page.
  • Collapsible content is empty: select its page/content source, or use Hide block if no dynamic content where appropriate.
  • A purchase cannot proceed: check required line-item properties, the chosen variant, quantity rules and availability.
  • The same layout changes several products: they share this template; create and assign a separate template for a different layout.
  • View in your space is absent: select the 3D thumbnail, confirm the model has finished processing in Shopify, and test a supported device. The native iPhone/iPad entry also needs a USDZ source. The control remains hidden when the device or required source is unsupported.
  • An AR control appears but does not open the system viewer: open the storefront directly in a supported browser, reload, and tap once without swiping. Use Safari for iPhone/iPad testing rather than an in-app browser. If it still fails, contact support with the device, OS and browser versions and product URL. Web rotation and zoom alone do not confirm AR launch.
  • Subscription choices require a compatible purchase-option app and an app block inside the product section. The theme does not create selling plans.
  • Captions attach to the selected video file, not its position or title. Replacing a video requires updating its caption entry. Ensure metaobject storefront access and product-metafield storefront access are enabled; incomplete tracks are omitted and the first matching entry wins. YouTube/Vimeo keep their provider captions.

Full control reference

Names, choices, ranges and defaults below are read from this version of the theme. Defaults are starting examples, not promises about your business. Some controls appear only for the matching layout. Block contents and preset starting values can differ from the base defaults.

All section controls (19)
SettingControl or choicesDefault and guidance
Width / Section widthPage width · Full width · Custom widthDefault: Page width.
Width / Custom width50–100 %; step 5Default: 80. Percentage of screen width. This control appears only when the relevant layout or related option is selected.
Content / Featured productChoose a productDefault: Not set. Used when this section is added outside a product template.
Media / Section background imageChoose an imageDefault: Not set.
Media / Section background positionImage focal point · Top · Center · BottomDefault: Image focal point. This control appears only when the relevant layout or related option is selected.
Media / Section background behaviorScroll with section · Fixed to viewportDefault: Scroll with section. This control appears only when the relevant layout or related option is selected.
Media / Section background overlay0–80 %; step 5Default: 0. This control appears only when the relevant layout or related option is selected.
Media / Gallery styleTheme default · Slideshow · Scroll one column · Scroll two columnsDefault: Theme default.
Media / Image aspect ratioTheme default · Adapt to image · Square (1:1) · Portrait (4:5) · Landscape (3:2)Default: Theme default. Videos and other media keep their original aspect ratio.
Media / Default image fitTheme default · Cover · ContainDefault: Theme default.
Sticky add to cart / Enable sticky add to cartOn / OffDefault: Off.
Sticky add to cart / Enable add to cart for multi-variant productsOn / OffDefault: Off. When enabled, the button adds the selected variant. When disabled, it shows a Choose options button.
Sticky add to cart / StyleWide · FloatingDefault: Wide.
Sticky add to cart / Background colorChoose a colorDefault: #FFFFFF.
Sticky add to cart / Text colorChoose a colorDefault: #111111.
Sticky add to cart / Blur backgroundOn / OffDefault: Off.
Advanced / Hide on desktopOn / OffDefault: Off. This control appears only when the relevant layout or related option is selected.
Advanced / Hide on mobileOn / OffDefault: Off. This control appears only when the relevant layout or related option is selected.
Advanced / Section anchorTextDefault: Not set. Optional. Use a unique name for links that jump to this section.
Price block controls (1)
SettingControl or choicesDefault and guidance
Price size16–36 px; step 1Default: 32.
Inventory status block controls (2)
SettingControl or choicesDefault and guidance
Low stock threshold1–20; step 1Default: 5.
Show inventory quantityOn / OffDefault: Off.
Variant picker block controls (1)
SettingControl or choicesDefault and guidance
Picker styleTheme default · Buttons · DropdownsDefault: Theme default.
Quantity and add to cart block controls (1)
SettingControl or choicesDefault and guidance
Add to cart background colorChoose a colorDefault: Not set.
Badges block controls (4)
SettingControl or choicesDefault and guidance
Badge textTextDefault: Not set.
Show sale badgeOn / OffDefault: On.
Background colorChoose a colorDefault: #111111.
Text colorChoose a colorDefault: #FFFFFF.
Line item property block controls (6)
SettingControl or choicesDefault and guidance
LabelTextDefault: Personalization.
Input typeSingle-line text · Multi-line text · Select · CheckboxDefault: Single-line text.
PlaceholderTextDefault: Not set.
OptionsMultiline textDefault: Not set. Enter one option per line. Used when input type is Select.
Checkbox valueTextDefault: Not set.
RequiredOn / OffDefault: Off.
Volume pricing table block controls (1)
SettingControl or choicesDefault and guidance
HeadingTextDefault: Volume pricing.
Offers block controls (1)
SettingControl or choicesDefault and guidance
ContentFormatted textDefault: Free shipping on orders over $100..
Text block controls (4)
SettingControl or choicesDefault and guidance
TextFormatted textDefault: Text.
Text sizeSmall · Normal · LargeDefault: Normal.
Text colorChoose a colorDefault: Not set.
Text transform (uppercase)On / OffDefault: Off.
Image block controls (3)
SettingControl or choicesDefault and guidance
ImageChoose an imageDefault: Not set.
Image alt textTextDefault: Not set.
LinkChoose or enter a linkDefault: Not set.
Button block controls (3)
SettingControl or choicesDefault and guidance
Button labelTextDefault: Learn more.
Button linkChoose or enter a linkDefault: Not set.
StylePrimary · SecondaryDefault: Primary.
More information block controls (2)
SettingControl or choicesDefault and guidance
HeadingTextDefault: More information.
Page contentChoose a pageDefault: Not set.
Modal block controls (3)
SettingControl or choicesDefault and guidance
Button labelTextDefault: Size guide.
HeadingTextDefault: Not set.
ContentFormatted textDefault: Not set.
Custom Liquid block controls (1)
SettingControl or choicesDefault and guidance
Custom LiquidCustom LiquidDefault: Not set. Add supported Liquid or HTML.
Icon with text block controls (9)
SettingControl or choicesDefault and guidance
Icon sourceIcon · ImageDefault: Icon.
IconSupport · Box · Gift · Heart · Leaf · Ruler · Shield · Shirt · Shoe · Star · Tag · Tags · Time · Trophy · Truck · Users · Wallet · Wash · Watch · WrenchDefault: Support.
Custom SVG iconMultiline textDefault: Not set. Optional. Paste trusted SVG markup to replace the selected icon.
ImageChoose an imageDefault: Not set.
Image alt textTextDefault: Not set.
HeadingFormatted inline textDefault: Not set.
Heading size16–48 px; step 1Default: 22.
DescriptionFormatted textDefault: Not set.
Icon and text layoutIcon beside text, left aligned · Icon above text, left aligned · Icon above text, centered · Icon above text, right alignedDefault: Icon beside text, left aligned.
Social share block controls (13)
SettingControl or choicesDefault and guidance
TitleTextDefault: Not set.
SubheadingTextDefault: Not set.
Prompt textTextDefault: Not set.
IconChoose an imageDefault: Not set.
Show FacebookOn / OffDefault: On.
Show X (Twitter)On / OffDefault: On.
Show PinterestOn / OffDefault: On.
Show WhatsAppOn / OffDefault: Off.
Show emailOn / OffDefault: Off.
Show share linkOn / OffDefault: On. Uses the native sharing options supported by the visitor's browser.
CollapsibleOn / OffDefault: Off.
LayoutBoxed · CompactDefault: Compact.
Text colorChoose a colorDefault: Not set.
Collapsible row block controls (12)
SettingControl or choicesDefault and guidance
Block heading / HeadingTextDefault: Product information.
Block heading / SubheadingTextDefault: Not set.
Block heading / Prompt textTextDefault: Not set.
Block heading / IconChoose an imageDefault: Not set.
Block content / ContentFormatted textDefault: Not set.
Block content / Page contentChoose a pageDefault: Not set.
Block content / Content imageChoose an imageDefault: Not set.
Dynamic content / Hide block if no dynamic contentOn / OffDefault: Off. Hides this block when no Page content or content image is available.
Block style / CollapsibleOn / OffDefault: On.
Block style / Open by defaultOn / OffDefault: Off.
Block style / LayoutBoxed · CompactDefault: Compact.
Block style / Text colorChoose a colorDefault: Not set.

Need help with a setting?

Check the troubleshooting guide or prepare a support request.

Contact support