rebly-sections 1.0.1 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (161) hide show
  1. package/assets/data/block-patterns.csv +160 -0
  2. package/assets/data/component-library/GDPR-modal.liquid +183 -0
  3. package/assets/data/component-library/Ishi_parallaxblockstyle1.liquid +331 -0
  4. package/assets/data/component-library/_index.csv +157 -19
  5. package/assets/data/component-library/about.liquid +1557 -0
  6. package/assets/data/component-library/adv-header.liquid +344 -0
  7. package/assets/data/component-library/adv-navigation.liquid +542 -0
  8. package/assets/data/component-library/announcement-bar.liquid +42 -60
  9. package/assets/data/component-library/article.liquid +242 -0
  10. package/assets/data/component-library/axeo-perfume-cosmetics-store-shopify-theme-about.liquid +1557 -0
  11. package/assets/data/component-library/basel-gl_newsletter_pets.liquid +612 -0
  12. package/assets/data/component-library/bixbang-fullpackage-collection-template.liquid +990 -0
  13. package/assets/data/component-library/blog-sidebar-article.liquid +51 -0
  14. package/assets/data/component-library/blog-sidebar-deals.liquid +189 -0
  15. package/assets/data/component-library/blog-sidebar-instagram.liquid +126 -0
  16. package/assets/data/component-library/blog-sidebar-tags.liquid +30 -0
  17. package/assets/data/component-library/blog.liquid +371 -0
  18. package/assets/data/component-library/brands-page.liquid +114 -0
  19. package/assets/data/component-library/cake-shop-shopify-theme-for-bakery-and-cafe-home-support-blo.liquid +780 -0
  20. package/assets/data/component-library/collection-template-promotion.liquid +1139 -0
  21. package/assets/data/component-library/collection-template.liquid +146 -0
  22. package/assets/data/component-library/contact-us.liquid +663 -0
  23. package/assets/data/component-library/contact.liquid +256 -0
  24. package/assets/data/component-library/copyright_payment.liquid +95 -0
  25. package/assets/data/component-library/custom-content.liquid +832 -0
  26. package/assets/data/component-library/faq-template-3.liquid +1014 -0
  27. package/assets/data/component-library/footer-model-1.liquid +503 -0
  28. package/assets/data/component-library/footer-model-10.liquid +210 -0
  29. package/assets/data/component-library/footer-model-2.liquid +460 -0
  30. package/assets/data/component-library/footer-model-3.liquid +548 -0
  31. package/assets/data/component-library/footer-model-4.liquid +455 -0
  32. package/assets/data/component-library/footer-model-5.liquid +407 -0
  33. package/assets/data/component-library/footer-model-6.liquid +543 -0
  34. package/assets/data/component-library/footer-model-7.liquid +345 -0
  35. package/assets/data/component-library/footer-model-8.liquid +279 -0
  36. package/assets/data/component-library/footer-model-9.liquid +376 -0
  37. package/assets/data/component-library/gallery.liquid +236 -0
  38. package/assets/data/component-library/gecko-shopify-v5-7-6-nulled-manual_blog.liquid +720 -0
  39. package/assets/data/component-library/gl_newsletter_pets.liquid +612 -0
  40. package/assets/data/component-library/gp-logo-list.liquid +362 -0
  41. package/assets/data/component-library/grid-banner-type-3-b.liquid +655 -0
  42. package/assets/data/component-library/header-model-1.liquid +427 -0
  43. package/assets/data/component-library/header-model-10.liquid +599 -0
  44. package/assets/data/component-library/header-model-2.liquid +633 -0
  45. package/assets/data/component-library/header-model-3.liquid +415 -0
  46. package/assets/data/component-library/header-model-4.liquid +754 -0
  47. package/assets/data/component-library/header-model-5.liquid +562 -0
  48. package/assets/data/component-library/header-model-6.liquid +713 -0
  49. package/assets/data/component-library/header-model-7.liquid +743 -0
  50. package/assets/data/component-library/header-model-8.liquid +500 -0
  51. package/assets/data/component-library/header-model-9.liquid +506 -0
  52. package/assets/data/component-library/home-blog-posts-1.liquid +399 -0
  53. package/assets/data/component-library/home-blog-posts-2.liquid +393 -0
  54. package/assets/data/component-library/home-blog-posts-3.liquid +545 -0
  55. package/assets/data/component-library/home-brand-slider.liquid +224 -0
  56. package/assets/data/component-library/home-circled-block.liquid +332 -0
  57. package/assets/data/component-library/home-contact-block-1.liquid +395 -0
  58. package/assets/data/component-library/home-contact-block-2.liquid +372 -0
  59. package/assets/data/component-library/home-content-block-1.liquid +320 -0
  60. package/assets/data/component-library/home-donut-chart.liquid +335 -0
  61. package/assets/data/component-library/home-fade-in-banner.liquid +277 -0
  62. package/assets/data/component-library/home-faq-model.liquid +323 -0
  63. package/assets/data/component-library/home-featured-blog.liquid +1462 -0
  64. package/assets/data/component-library/home-featured-collections.liquid +484 -0
  65. package/assets/data/component-library/home-gallery-block1.liquid +276 -0
  66. package/assets/data/component-library/home-gallery-block2.liquid +396 -0
  67. package/assets/data/component-library/home-grid-banner-type-1.liquid +371 -0
  68. package/assets/data/component-library/home-grid-banner-type-2.liquid +362 -0
  69. package/assets/data/component-library/home-grid-banner-type-3.liquid +374 -0
  70. package/assets/data/component-library/home-grid-banner-type-4.liquid +900 -0
  71. package/assets/data/component-library/home-grid-banner-type-5.liquid +368 -0
  72. package/assets/data/component-library/home-grid-banner-type-6.liquid +382 -0
  73. package/assets/data/component-library/home-grid-banner-type-7.liquid +371 -0
  74. package/assets/data/component-library/home-hotspot-with-product-carousel.liquid +1425 -0
  75. package/assets/data/component-library/home-image-gallery.liquid +1087 -0
  76. package/assets/data/component-library/home-instagram.liquid +356 -0
  77. package/assets/data/component-library/home-newsletter.liquid +246 -0
  78. package/assets/data/component-library/home-number-counter.liquid +790 -0
  79. package/assets/data/component-library/home-price-table.liquid +416 -0
  80. package/assets/data/component-library/home-pricing-table.liquid +1076 -0
  81. package/assets/data/component-library/home-product-grid.liquid +413 -0
  82. package/assets/data/component-library/home-product-tab-1.liquid +528 -0
  83. package/assets/data/component-library/home-product-tab-2.liquid +342 -0
  84. package/assets/data/component-library/home-product-tab-3.liquid +357 -0
  85. package/assets/data/component-library/home-product-vertical-carousel.liquid +477 -0
  86. package/assets/data/component-library/home-quotes-1.liquid +274 -0
  87. package/assets/data/component-library/home-quotes-2.liquid +239 -0
  88. package/assets/data/component-library/home-quotes-3.liquid +244 -0
  89. package/assets/data/component-library/home-quotes-4.liquid +258 -0
  90. package/assets/data/component-library/home-slider-width-promo-images.liquid +1377 -0
  91. package/assets/data/component-library/home-slideshow-type-1.liquid +656 -0
  92. package/assets/data/component-library/home-slideshow-type-2.liquid +570 -0
  93. package/assets/data/component-library/home-specification-block-1.liquid +468 -0
  94. package/assets/data/component-library/home-specification-block-2.liquid +291 -0
  95. package/assets/data/component-library/home-specification-block-3.liquid +429 -0
  96. package/assets/data/component-library/home-support-block.liquid +392 -0
  97. package/assets/data/component-library/home-testimonial.liquid +1348 -0
  98. package/assets/data/component-library/home-video-banner.liquid +317 -0
  99. package/assets/data/component-library/home-wide-banner.liquid +327 -0
  100. package/assets/data/component-library/icon-with-content.liquid +478 -0
  101. package/assets/data/component-library/instafeed.liquid +1 -0
  102. package/assets/data/component-library/kea-ecommerce-interior-furniture-shopify-theme-about.liquid +1300 -0
  103. package/assets/data/component-library/kidslife-responsive-shopify-theme-home-number-counter.liquid +729 -0
  104. package/assets/data/component-library/logo-bar.liquid +314 -0
  105. package/assets/data/component-library/lookbook.liquid +367 -0
  106. package/assets/data/component-library/manual_blog.liquid +724 -0
  107. package/assets/data/component-library/navigation-etc.liquid +642 -0
  108. package/assets/data/component-library/newsletter.liquid +246 -0
  109. package/assets/data/component-library/order-form.liquid +96 -0
  110. package/assets/data/component-library/page-catev1-template.liquid +344 -0
  111. package/assets/data/component-library/popup_video.liquid +396 -0
  112. package/assets/data/component-library/product-sidebar-bestsellers.liquid +99 -0
  113. package/assets/data/component-library/product-sidebar-deals.liquid +158 -0
  114. package/assets/data/component-library/product-template-2.liquid +629 -0
  115. package/assets/data/component-library/product-template-3.liquid +670 -0
  116. package/assets/data/component-library/product-template-4.liquid +627 -0
  117. package/assets/data/component-library/product-template-5.liquid +652 -0
  118. package/assets/data/component-library/product-template.liquid +698 -0
  119. package/assets/data/component-library/rich-text.liquid +541 -0
  120. package/assets/data/component-library/section-countdown-v2.liquid +215 -0
  121. package/assets/data/component-library/services.liquid +596 -0
  122. package/assets/data/component-library/shipping_info.liquid +327 -0
  123. package/assets/data/component-library/sidebar-bestsellers.liquid +109 -0
  124. package/assets/data/component-library/sidebar-category.liquid +105 -0
  125. package/assets/data/component-library/sidebar-colors.liquid +104 -0
  126. package/assets/data/component-library/single_product_feature.liquid +1892 -0
  127. package/assets/data/component-library/social-links-menu.liquid +244 -0
  128. package/assets/data/component-library/someone-purchased.liquid +190 -0
  129. package/assets/data/component-library/special-offer-area.liquid +530 -0
  130. package/assets/data/component-library/theno-minimal-clean-watch-store-shopify-theme-page-catev1-te.liquid +344 -0
  131. package/assets/data/component-library/top-bar-type-1.liquid +200 -0
  132. package/assets/data/component-library/top-bar-type-10.liquid +395 -0
  133. package/assets/data/component-library/top-bar-type-11.liquid +395 -0
  134. package/assets/data/component-library/top-bar-type-2.liquid +106 -0
  135. package/assets/data/component-library/top-bar-type-3.liquid +205 -0
  136. package/assets/data/component-library/top-countdown-bar.liquid +116 -0
  137. package/assets/data/component-library/trixe-solar-responsive-shopify-template-home-image-gallery.liquid +783 -0
  138. package/assets/data/component-library/trixe-solar-responsive-shopify-template-home-pricing-table.liquid +1043 -0
  139. package/assets/data/component-library/trixe-solar-responsive-shopify-template-home-testimonial.liquid +1338 -0
  140. package/assets/data/component-library/video.liquid +511 -0
  141. package/assets/data/component-library/waffy-spices-dry-fruits-store-shopify-theme-v-1-1-contact-us.liquid +523 -0
  142. package/assets/data/design-tokens.csv +93 -57
  143. package/assets/data/schema-library.csv +48 -46
  144. package/assets/data/settings-profiles.csv +235 -0
  145. package/assets/data/shopify-best-practices.csv +58 -36
  146. package/assets/scripts/backfill-component-index.py +102 -0
  147. package/assets/scripts/core.py +30 -8
  148. package/assets/scripts/fix-schema-library.py +42 -0
  149. package/assets/scripts/kb-analyzer-helpers.py +136 -0
  150. package/assets/scripts/kb-analyzer.py +186 -0
  151. package/assets/scripts/kb-builder.py +32 -63
  152. package/assets/scripts/kb-constants.py +62 -0
  153. package/assets/scripts/kb-extractor-helpers.py +178 -0
  154. package/assets/scripts/kb-extractor.py +106 -170
  155. package/assets/scripts/kb-synthesizer.py +251 -0
  156. package/assets/scripts/quality-gate-checks.py +55 -0
  157. package/assets/scripts/quality-gate.py +56 -2
  158. package/assets/scripts/section-generator-helpers.py +74 -0
  159. package/assets/scripts/section-generator.py +59 -49
  160. package/assets/templates/generation-prompt.md +78 -14
  161. package/package.json +1 -1
@@ -1,57 +1,93 @@
1
- No,Token Name,Category,Value,CSS Variable,Keywords,Usage,Notes
2
- 1,spacing-0,spacing,0px,--spacing-0,"spacing, gap, margin, padding, none, zero","margin: var(--spacing-0); padding: var(--spacing-0)","Zero spacing; removes all margin/padding"
3
- 2,spacing-1,spacing,4px,--spacing-1,"spacing, gap, margin, padding, xs, extra small","margin: var(--spacing-1); gap: var(--spacing-1)","4px = 0.25rem; smallest practical spacing unit"
4
- 3,spacing-2,spacing,8px,--spacing-2,"spacing, gap, margin, padding, small, sm","padding: var(--spacing-2); margin-bottom: var(--spacing-2)","8px = 0.5rem; tight spacing for compact elements"
5
- 4,spacing-3,spacing,12px,--spacing-3,"spacing, gap, margin, padding, small medium","gap: var(--spacing-3); padding: var(--spacing-3)","12px = 0.75rem; between small and base spacing"
6
- 5,spacing-4,spacing,16px,--spacing-4,"spacing, gap, margin, padding, base, default, medium","padding: var(--spacing-4); margin: var(--spacing-4)","16px = 1rem; base spacing unit; most common"
7
- 6,spacing-5,spacing,20px,--spacing-5,"spacing, gap, margin, padding, medium","margin-bottom: var(--spacing-5); gap: var(--spacing-5)","20px = 1.25rem; slightly above base"
8
- 7,spacing-6,spacing,24px,--spacing-6,"spacing, gap, margin, padding, large, section","padding: var(--spacing-6); margin-bottom: var(--spacing-6)","24px = 1.5rem; comfortable section spacing"
9
- 8,spacing-8,spacing,32px,--spacing-8,"spacing, gap, margin, padding, large, component","padding: var(--spacing-8); gap: var(--spacing-8)","32px = 2rem; component-level spacing"
10
- 9,spacing-10,spacing,40px,--spacing-10,"spacing, gap, margin, padding, extra large, xl","margin-bottom: var(--spacing-10); padding: var(--spacing-10)","40px = 2.5rem; large section gaps"
11
- 10,spacing-12,spacing,48px,--spacing-12,"spacing, gap, margin, padding, 2xl, section gap","padding: var(--spacing-12); margin-top: var(--spacing-12)","48px = 3rem; section vertical rhythm"
12
- 11,spacing-16,spacing,64px,--spacing-16,"spacing, gap, margin, padding, 3xl, large section","section padding: var(--spacing-16)","64px = 4rem; large section vertical padding"
13
- 12,spacing-20,spacing,80px,--spacing-20,"spacing, gap, margin, padding, 4xl, hero","hero section padding: var(--spacing-20)","80px = 5rem; hero and feature section padding"
14
- 13,spacing-24,spacing,96px,--spacing-24,"spacing, gap, margin, padding, 5xl, page section","page-level section spacing: var(--spacing-24)","96px = 6rem; generous page-level spacing"
15
- 14,color-primary,color,#3B82F6,--color-primary,"primary, brand, main, blue, cta, action, button","background: var(--color-primary); color: var(--color-primary)","Main brand/action color; used for CTAs and highlights"
16
- 15,color-secondary,color,#6B7280,--color-secondary,"secondary, gray, muted, support, complement","color: var(--color-secondary); border: var(--color-secondary)","Supporting color for secondary actions and content"
17
- 16,color-accent,color,#F59E0B,--color-accent,"accent, highlight, pop, warm, amber, feature","background: var(--color-accent)","Accent color for highlights and decorative elements"
18
- 17,color-background,color,#FFFFFF,--color-background,"background, page background, white, base, canvas","background: var(--color-background)","Default page/section background color"
19
- 18,color-surface,color,#F9FAFB,--color-surface,"surface, card, panel, light gray, container","background: var(--color-surface)","Card and panel background; slightly off-white"
20
- 19,color-text-primary,color,#111827,--color-text-primary,"text, body, primary text, dark, readable, heading","color: var(--color-text-primary)","Primary body and heading text color; near black"
21
- 20,color-text-secondary,color,#374151,--color-text-secondary,"text, secondary, subheading, dark gray","color: var(--color-text-secondary)","Secondary text; slightly lighter than primary"
22
- 21,color-text-muted,color,#6B7280,--color-text-muted,"text, muted, caption, hint, placeholder, meta","color: var(--color-text-muted)","Muted text for captions, hints and metadata"
23
- 22,color-border,color,#E5E7EB,--color-border,"border, divider, line, separator, outline","border-color: var(--color-border)","Default border and divider color; light gray"
24
- 23,color-success,color,#10B981,--color-success,"success, green, positive, check, complete, valid","color: var(--color-success); background: var(--color-success)","Success state color; green"
25
- 24,color-warning,color,#F59E0B,--color-warning,"warning, amber, caution, alert, attention","color: var(--color-warning); background: var(--color-warning)","Warning state color; amber/yellow"
26
- 25,color-error,color,#EF4444,--color-error,"error, red, danger, invalid, fail, negative","color: var(--color-error); border-color: var(--color-error)","Error/danger state color; red"
27
- 26,color-info,color,#3B82F6,--color-info,"info, blue, informational, notice, tip","color: var(--color-info); background: var(--color-info)","Informational state color; blue"
28
- 27,color-link,color,#2563EB,--color-link,"link, anchor, href, blue, clickable","color: var(--color-link)","Hyperlink color; darker blue for accessibility"
29
- 28,color-focus-ring,color,#93C5FD,--color-focus-ring,"focus, ring, outline, accessibility, keyboard nav","outline-color: var(--color-focus-ring)","Focus ring color for keyboard navigation accessibility"
30
- 29,font-size-xs,typography,12px,--font-size-xs,"font size, small, tiny, caption, label, xs","font-size: var(--font-size-xs)","12px = 0.75rem; extra small text for fine print"
31
- 30,font-size-sm,typography,14px,--font-size-sm,"font size, small, secondary, caption, sm","font-size: var(--font-size-sm)","14px = 0.875rem; small text for metadata and captions"
32
- 31,font-size-base,typography,16px,--font-size-base,"font size, body, base, normal, default, readable","font-size: var(--font-size-base)","16px = 1rem; base body text size; browser default"
33
- 32,font-size-lg,typography,18px,--font-size-lg,"font size, large, lead, intro, lg","font-size: var(--font-size-lg)","18px = 1.125rem; lead/intro paragraph size"
34
- 33,font-size-xl,typography,20px,--font-size-xl,"font size, xl, subheading, large, headline","font-size: var(--font-size-xl)","20px = 1.25rem; subheadings and large body text"
35
- 34,font-size-2xl,typography,24px,--font-size-2xl,"font size, 2xl, heading, h3, section title","font-size: var(--font-size-2xl)","24px = 1.5rem; section headings (h3 level)"
36
- 35,font-size-3xl,typography,30px,--font-size-3xl,"font size, 3xl, heading, h2, large heading","font-size: var(--font-size-3xl)","30px = 1.875rem; major section headings (h2 level)"
37
- 36,font-size-4xl,typography,36px,--font-size-4xl,"font size, 4xl, heading, h1, page title","font-size: var(--font-size-4xl)","36px = 2.25rem; page-level headings (h1 level)"
38
- 37,font-size-5xl,typography,48px,--font-size-5xl,"font size, 5xl, hero, display, large, banner","font-size: var(--font-size-5xl)","48px = 3rem; hero display text and large banners"
39
- 38,font-weight-normal,typography,400,--font-weight-normal,"font weight, normal, regular, body, 400","font-weight: var(--font-weight-normal)","400; regular/normal font weight for body text"
40
- 39,font-weight-medium,typography,500,--font-weight-medium,"font weight, medium, 500, semi, label","font-weight: var(--font-weight-medium)","500; medium weight for labels and UI elements"
41
- 40,font-weight-semibold,typography,600,--font-weight-semibold,"font weight, semibold, 600, heading, subheading","font-weight: var(--font-weight-semibold)","600; semibold for subheadings and emphasis"
42
- 41,font-weight-bold,typography,700,--font-weight-bold,"font weight, bold, 700, heading, strong, emphasis","font-weight: var(--font-weight-bold)","700; bold for headings and strong emphasis"
43
- 42,breakpoint-sm,breakpoint,640px,--breakpoint-sm,"breakpoint, sm, small, mobile landscape, tablet","@media (min-width: 640px) { }","Small breakpoint; mobile landscape and small tablets"
44
- 43,breakpoint-md,breakpoint,768px,--breakpoint-md,"breakpoint, md, medium, tablet, ipad","@media (min-width: 768px) { }","Medium breakpoint; tablet portrait"
45
- 44,breakpoint-lg,breakpoint,1024px,--breakpoint-lg,"breakpoint, lg, large, laptop, desktop, tablet landscape","@media (min-width: 1024px) { }","Large breakpoint; laptop and tablet landscape"
46
- 45,breakpoint-xl,breakpoint,1280px,--breakpoint-xl,"breakpoint, xl, extra large, desktop, wide","@media (min-width: 1280px) { }","Extra large breakpoint; standard desktop"
47
- 46,breakpoint-2xl,breakpoint,1536px,--breakpoint-2xl,"breakpoint, 2xl, wide desktop, large monitor, hd","@media (min-width: 1536px) { }","2XL breakpoint; wide desktop and large monitors"
48
- 47,shadow-sm,shadow,0 1px 2px 0 rgb(0 0 0 / 0.05),--shadow-sm,"shadow, box shadow, subtle, small, card, elevation","box-shadow: var(--shadow-sm)","Subtle shadow for slight elevation; cards and inputs"
49
- 48,shadow-base,shadow,"0 1px 3px 0 rgb(0 0 0 / 0.1), 0 1px 2px -1px rgb(0 0 0 / 0.1)",--shadow-base,"shadow, box shadow, default, card, panel, elevation","box-shadow: var(--shadow-base)","Default shadow for cards and panels"
50
- 49,shadow-md,shadow,"0 4px 6px -1px rgb(0 0 0 / 0.1), 0 2px 4px -2px rgb(0 0 0 / 0.1)",--shadow-md,"shadow, medium, dropdown, popover, elevated","box-shadow: var(--shadow-md)","Medium shadow for dropdowns and popovers"
51
- 50,shadow-lg,shadow,"0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1)",--shadow-lg,"shadow, large, modal, overlay, floating","box-shadow: var(--shadow-lg)","Large shadow for modals and floating elements"
52
- 51,shadow-xl,shadow,"0 20px 25px -5px rgb(0 0 0 / 0.1), 0 8px 10px -6px rgb(0 0 0 / 0.1)",--shadow-xl,"shadow, extra large, hero, dramatic, high elevation","box-shadow: var(--shadow-xl)","Extra large shadow for high-elevation hero elements"
53
- 52,border-radius-sm,border-radius,4px,--border-radius-sm,"border radius, rounded, corner, small, slight","border-radius: var(--border-radius-sm)","4px; slight rounding for buttons and inputs"
54
- 53,border-radius-base,border-radius,6px,--border-radius-base,"border radius, rounded, default, corner, normal","border-radius: var(--border-radius-base)","6px; default rounding for most elements"
55
- 54,border-radius-md,border-radius,8px,--border-radius-md,"border radius, rounded, card, panel, medium","border-radius: var(--border-radius-md)","8px; card and panel corner rounding"
56
- 55,border-radius-lg,border-radius,12px,--border-radius-lg,"border radius, rounded, large, prominent, section","border-radius: var(--border-radius-lg)","12px; prominent rounding for featured elements"
57
- 56,border-radius-full,border-radius,9999px,--border-radius-full,"border radius, full, pill, circle, round, badge","border-radius: var(--border-radius-full)","9999px; pill/circle shape for badges and avatars"
1
+ No,Token Name,Category,Value,CSS Variable,Keywords,Usage,Notes
2
+ 1,spacing-0,spacing,0px,--spacing-0,"spacing, gap, margin, padding, none, zero",margin: var(--spacing-0); padding: var(--spacing-0),Zero spacing; removes all margin/padding
3
+ 2,spacing-1,spacing,4px,--spacing-1,"spacing, gap, margin, padding, xs, extra small",margin: var(--spacing-1); gap: var(--spacing-1),4px = 0.25rem; smallest practical spacing unit
4
+ 3,spacing-2,spacing,8px,--spacing-2,"spacing, gap, margin, padding, small, sm",padding: var(--spacing-2); margin-bottom: var(--spacing-2),8px = 0.5rem; tight spacing for compact elements
5
+ 4,spacing-3,spacing,12px,--spacing-3,"spacing, gap, margin, padding, small medium",gap: var(--spacing-3); padding: var(--spacing-3),12px = 0.75rem; between small and base spacing
6
+ 5,spacing-4,spacing,16px,--spacing-4,"spacing, gap, margin, padding, base, default, medium",padding: var(--spacing-4); margin: var(--spacing-4),16px = 1rem; base spacing unit; most common
7
+ 6,spacing-5,spacing,20px,--spacing-5,"spacing, gap, margin, padding, medium",margin-bottom: var(--spacing-5); gap: var(--spacing-5),20px = 1.25rem; slightly above base
8
+ 7,spacing-6,spacing,24px,--spacing-6,"spacing, gap, margin, padding, large, section",padding: var(--spacing-6); margin-bottom: var(--spacing-6),24px = 1.5rem; comfortable section spacing
9
+ 8,spacing-8,spacing,32px,--spacing-8,"spacing, gap, margin, padding, large, component",padding: var(--spacing-8); gap: var(--spacing-8),32px = 2rem; component-level spacing
10
+ 9,spacing-10,spacing,40px,--spacing-10,"spacing, gap, margin, padding, extra large, xl",margin-bottom: var(--spacing-10); padding: var(--spacing-10),40px = 2.5rem; large section gaps
11
+ 10,spacing-12,spacing,48px,--spacing-12,"spacing, gap, margin, padding, 2xl, section gap",padding: var(--spacing-12); margin-top: var(--spacing-12),48px = 3rem; section vertical rhythm
12
+ 11,spacing-16,spacing,64px,--spacing-16,"spacing, gap, margin, padding, 3xl, large section",section padding: var(--spacing-16),64px = 4rem; large section vertical padding
13
+ 12,spacing-20,spacing,80px,--spacing-20,"spacing, gap, margin, padding, 4xl, hero",hero section padding: var(--spacing-20),80px = 5rem; hero and feature section padding
14
+ 13,spacing-24,spacing,96px,--spacing-24,"spacing, gap, margin, padding, 5xl, page section",page-level section spacing: var(--spacing-24),96px = 6rem; generous page-level spacing
15
+ 14,color-primary,color,#3B82F6,--color-primary,"primary, brand, main, blue, cta, action, button",background: var(--color-primary); color: var(--color-primary),Main brand/action color; used for CTAs and highlights
16
+ 15,color-secondary,color,#6B7280,--color-secondary,"secondary, gray, muted, support, complement",color: var(--color-secondary); border: var(--color-secondary),Supporting color for secondary actions and content
17
+ 16,color-accent,color,#F59E0B,--color-accent,"accent, highlight, pop, warm, amber, feature",background: var(--color-accent),Accent color for highlights and decorative elements
18
+ 17,color-background,color,#FFFFFF,--color-background,"background, page background, white, base, canvas",background: var(--color-background),Default page/section background color
19
+ 18,color-surface,color,#F9FAFB,--color-surface,"surface, card, panel, light gray, container",background: var(--color-surface),Card and panel background; slightly off-white
20
+ 19,color-text-primary,color,#111827,--color-text-primary,"text, body, primary text, dark, readable, heading",color: var(--color-text-primary),Primary body and heading text color; near black
21
+ 20,color-text-secondary,color,#374151,--color-text-secondary,"text, secondary, subheading, dark gray",color: var(--color-text-secondary),Secondary text; slightly lighter than primary
22
+ 21,color-text-muted,color,#6B7280,--color-text-muted,"text, muted, caption, hint, placeholder, meta",color: var(--color-text-muted),"Muted text for captions, hints and metadata"
23
+ 22,color-border,color,#E5E7EB,--color-border,"border, divider, line, separator, outline",border-color: var(--color-border),Default border and divider color; light gray
24
+ 23,color-success,color,#10B981,--color-success,"success, green, positive, check, complete, valid",color: var(--color-success); background: var(--color-success),Success state color; green
25
+ 24,color-warning,color,#F59E0B,--color-warning,"warning, amber, caution, alert, attention",color: var(--color-warning); background: var(--color-warning),Warning state color; amber/yellow
26
+ 25,color-error,color,#EF4444,--color-error,"error, red, danger, invalid, fail, negative",color: var(--color-error); border-color: var(--color-error),Error/danger state color; red
27
+ 26,color-info,color,#3B82F6,--color-info,"info, blue, informational, notice, tip",color: var(--color-info); background: var(--color-info),Informational state color; blue
28
+ 27,color-link,color,#2563EB,--color-link,"link, anchor, href, blue, clickable",color: var(--color-link),Hyperlink color; darker blue for accessibility
29
+ 28,color-focus-ring,color,#93C5FD,--color-focus-ring,"focus, ring, outline, accessibility, keyboard nav",outline-color: var(--color-focus-ring),Focus ring color for keyboard navigation accessibility
30
+ 29,font-size-xs,typography,12px,--font-size-xs,"font size, small, tiny, caption, label, xs",font-size: var(--font-size-xs),12px = 0.75rem; extra small text for fine print
31
+ 30,font-size-sm,typography,14px,--font-size-sm,"font size, small, secondary, caption, sm",font-size: var(--font-size-sm),14px = 0.875rem; small text for metadata and captions
32
+ 31,font-size-base,typography,16px,--font-size-base,"font size, body, base, normal, default, readable",font-size: var(--font-size-base),16px = 1rem; base body text size; browser default
33
+ 32,font-size-lg,typography,18px,--font-size-lg,"font size, large, lead, intro, lg",font-size: var(--font-size-lg),18px = 1.125rem; lead/intro paragraph size
34
+ 33,font-size-xl,typography,20px,--font-size-xl,"font size, xl, subheading, large, headline",font-size: var(--font-size-xl),20px = 1.25rem; subheadings and large body text
35
+ 34,font-size-2xl,typography,24px,--font-size-2xl,"font size, 2xl, heading, h3, section title",font-size: var(--font-size-2xl),24px = 1.5rem; section headings (h3 level)
36
+ 35,font-size-3xl,typography,30px,--font-size-3xl,"font size, 3xl, heading, h2, large heading",font-size: var(--font-size-3xl),30px = 1.875rem; major section headings (h2 level)
37
+ 36,font-size-4xl,typography,36px,--font-size-4xl,"font size, 4xl, heading, h1, page title",font-size: var(--font-size-4xl),36px = 2.25rem; page-level headings (h1 level)
38
+ 37,font-size-5xl,typography,48px,--font-size-5xl,"font size, 5xl, hero, display, large, banner",font-size: var(--font-size-5xl),48px = 3rem; hero display text and large banners
39
+ 38,font-weight-normal,typography,400,--font-weight-normal,"font weight, normal, regular, body, 400",font-weight: var(--font-weight-normal),400; regular/normal font weight for body text
40
+ 39,font-weight-medium,typography,500,--font-weight-medium,"font weight, medium, 500, semi, label",font-weight: var(--font-weight-medium),500; medium weight for labels and UI elements
41
+ 40,font-weight-semibold,typography,600,--font-weight-semibold,"font weight, semibold, 600, heading, subheading",font-weight: var(--font-weight-semibold),600; semibold for subheadings and emphasis
42
+ 41,font-weight-bold,typography,700,--font-weight-bold,"font weight, bold, 700, heading, strong, emphasis",font-weight: var(--font-weight-bold),700; bold for headings and strong emphasis
43
+ 42,breakpoint-sm,breakpoint,640px,--breakpoint-sm,"breakpoint, sm, small, mobile landscape, tablet",@media (min-width: 640px) { },Small breakpoint; mobile landscape and small tablets
44
+ 43,breakpoint-md,breakpoint,768px,--breakpoint-md,"breakpoint, md, medium, tablet, ipad",@media (min-width: 768px) { },Medium breakpoint; tablet portrait
45
+ 44,breakpoint-lg,breakpoint,1024px,--breakpoint-lg,"breakpoint, lg, large, laptop, desktop, tablet landscape",@media (min-width: 1024px) { },Large breakpoint; laptop and tablet landscape
46
+ 45,breakpoint-xl,breakpoint,1280px,--breakpoint-xl,"breakpoint, xl, extra large, desktop, wide",@media (min-width: 1280px) { },Extra large breakpoint; standard desktop
47
+ 46,breakpoint-2xl,breakpoint,1536px,--breakpoint-2xl,"breakpoint, 2xl, wide desktop, large monitor, hd",@media (min-width: 1536px) { },2XL breakpoint; wide desktop and large monitors
48
+ 47,shadow-sm,shadow,0 1px 2px 0 rgb(0 0 0 / 0.05),--shadow-sm,"shadow, box shadow, subtle, small, card, elevation",box-shadow: var(--shadow-sm),Subtle shadow for slight elevation; cards and inputs
49
+ 48,shadow-base,shadow,"0 1px 3px 0 rgb(0 0 0 / 0.1), 0 1px 2px -1px rgb(0 0 0 / 0.1)",--shadow-base,"shadow, box shadow, default, card, panel, elevation",box-shadow: var(--shadow-base),Default shadow for cards and panels
50
+ 49,shadow-md,shadow,"0 4px 6px -1px rgb(0 0 0 / 0.1), 0 2px 4px -2px rgb(0 0 0 / 0.1)",--shadow-md,"shadow, medium, dropdown, popover, elevated",box-shadow: var(--shadow-md),Medium shadow for dropdowns and popovers
51
+ 50,shadow-lg,shadow,"0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1)",--shadow-lg,"shadow, large, modal, overlay, floating",box-shadow: var(--shadow-lg),Large shadow for modals and floating elements
52
+ 51,shadow-xl,shadow,"0 20px 25px -5px rgb(0 0 0 / 0.1), 0 8px 10px -6px rgb(0 0 0 / 0.1)",--shadow-xl,"shadow, extra large, hero, dramatic, high elevation",box-shadow: var(--shadow-xl),Extra large shadow for high-elevation hero elements
53
+ 52,border-radius-sm,border-radius,4px,--border-radius-sm,"border radius, rounded, corner, small, slight",border-radius: var(--border-radius-sm),4px; slight rounding for buttons and inputs
54
+ 53,border-radius-base,border-radius,6px,--border-radius-base,"border radius, rounded, default, corner, normal",border-radius: var(--border-radius-base),6px; default rounding for most elements
55
+ 54,border-radius-md,border-radius,8px,--border-radius-md,"border radius, rounded, card, panel, medium",border-radius: var(--border-radius-md),8px; card and panel corner rounding
56
+ 55,border-radius-lg,border-radius,12px,--border-radius-lg,"border radius, rounded, large, prominent, section",border-radius: var(--border-radius-lg),12px; prominent rounding for featured elements
57
+ 56,border-radius-full,border-radius,9999px,--border-radius-full,"border radius, full, pill, circle, round, badge",border-radius: var(--border-radius-full),9999px; pill/circle shape for badges and avatars
58
+ 57,font-size-xs,typography,0.75rem,--font-size-xs,font size extra small xs caption fine print,font-size: var(--font-size-xs),Part of type scale
59
+ 58,font-size-sm,typography,0.875rem,--font-size-sm,font size small sm body secondary,font-size: var(--font-size-sm),Part of type scale
60
+ 59,font-size-base,typography,1rem,--font-size-base,font size base default body text,font-size: var(--font-size-base),Part of type scale
61
+ 60,font-size-md,typography,1.125rem,--font-size-md,font size medium md lead,font-size: var(--font-size-md),Part of type scale
62
+ 61,font-size-lg,typography,1.25rem,--font-size-lg,font size large lg h4,font-size: var(--font-size-lg),Part of type scale
63
+ 62,font-size-xl,typography,1.5rem,--font-size-xl,font size extra large xl h3,font-size: var(--font-size-xl),Part of type scale
64
+ 63,font-size-2xl,typography,1.875rem,--font-size-2xl,font size 2xl h2 heading,font-size: var(--font-size-2xl),Part of type scale
65
+ 64,font-size-3xl,typography,2.25rem,--font-size-3xl,font size 3xl h1 display,font-size: var(--font-size-3xl),Part of type scale
66
+ 65,font-size-4xl,typography,3rem,--font-size-4xl,font size 4xl hero jumbo,font-size: var(--font-size-4xl),Part of type scale
67
+ 66,line-height-tight,typography,1.2,--line-height-tight,line height tight heading compact,line-height: var(--line-height-tight),Line height scale
68
+ 67,line-height-normal,typography,1.5,--line-height-normal,line height normal base body,line-height: var(--line-height-normal),Line height scale
69
+ 68,line-height-relaxed,typography,1.75,--line-height-relaxed,line height relaxed readable,line-height: var(--line-height-relaxed),Line height scale
70
+ 69,line-height-loose,typography,2.0,--line-height-loose,line height loose spacious,line-height: var(--line-height-loose),Line height scale
71
+ 70,font-weight-light,typography,300,--font-weight-light,font weight light thin,font-weight: var(--font-weight-light),Weight scale
72
+ 71,font-weight-normal,typography,400,--font-weight-normal,font weight normal regular,font-weight: var(--font-weight-normal),Weight scale
73
+ 72,font-weight-medium,typography,500,--font-weight-medium,font weight medium,font-weight: var(--font-weight-medium),Weight scale
74
+ 73,font-weight-semibold,typography,600,--font-weight-semibold,font weight semibold demi,font-weight: var(--font-weight-semibold),Weight scale
75
+ 74,font-weight-bold,typography,700,--font-weight-bold,font weight bold strong,font-weight: var(--font-weight-bold),Weight scale
76
+ 75,radius-none,border-radius,0,--radius-none,border radius none square sharp,border-radius: var(--radius-none),Radius scale
77
+ 76,radius-sm,border-radius,0.25rem,--radius-sm,border radius small subtle,border-radius: var(--radius-sm),Radius scale
78
+ 77,radius-md,border-radius,0.5rem,--radius-md,border radius medium default,border-radius: var(--radius-md),Radius scale
79
+ 78,radius-lg,border-radius,1rem,--radius-lg,border radius large rounded,border-radius: var(--radius-lg),Radius scale
80
+ 79,radius-full,border-radius,9999px,--radius-full,border radius full circle pill,border-radius: var(--radius-full),Radius scale
81
+ 80,shadow-sm,shadow,"0 1px 2px rgba(0,0,0,0.05)",--shadow-sm,box shadow small subtle,box-shadow: var(--shadow-sm),Shadow elevation scale
82
+ 81,shadow-md,shadow,"0 4px 6px rgba(0,0,0,0.1)",--shadow-md,box shadow medium default card,box-shadow: var(--shadow-md),Shadow elevation scale
83
+ 82,shadow-lg,shadow,"0 10px 15px rgba(0,0,0,0.1)",--shadow-lg,box shadow large elevated modal,box-shadow: var(--shadow-lg),Shadow elevation scale
84
+ 83,shadow-xl,shadow,"0 20px 25px rgba(0,0,0,0.15)",--shadow-xl,box shadow extra large prominent,box-shadow: var(--shadow-xl),Shadow elevation scale
85
+ 84,z-base,z-index,0,--z-base,z-index base default layer,z-index: var(--z-base),Z-index layer scale
86
+ 85,z-dropdown,z-index,10,--z-dropdown,z-index dropdown menu popup,z-index: var(--z-dropdown),Z-index layer scale
87
+ 86,z-sticky,z-index,20,--z-sticky,z-index sticky header fixed,z-index: var(--z-sticky),Z-index layer scale
88
+ 87,z-overlay,z-index,30,--z-overlay,z-index overlay backdrop,z-index: var(--z-overlay),Z-index layer scale
89
+ 88,z-modal,z-index,40,--z-modal,z-index modal dialog,z-index: var(--z-modal),Z-index layer scale
90
+ 89,z-toast,z-index,50,--z-toast,z-index toast notification alert,z-index: var(--z-toast),Z-index layer scale
91
+ 90,font-family-sans,typography,"system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif",--font-family-sans,font family sans serif system stack body,font-family: var(--font-family-sans),System sans-serif stack for body text
92
+ 91,font-family-serif,typography,"Georgia, 'Times New Roman', serif",--font-family-serif,font family serif classic editorial heading,font-family: var(--font-family-serif),Classic serif stack for editorial headings
93
+ 92,font-family-mono,typography,"'SF Mono', 'Fira Code', 'Courier New', monospace",--font-family-mono,font family monospace code technical,font-family: var(--font-family-mono),Monospace stack for code and technical content
@@ -1,46 +1,48 @@
1
- No,Type,Category,Returns,Keywords,Required Props,Optional Props,Default Behavior,JSON Example,Constraints,Notes
2
- 1,checkbox,basic,boolean,"checkbox, boolean, toggle, true, false, on, off","type, id, label","default","Defaults to false if not set","{""type"":""checkbox"",""id"":""show_title"",""label"":""Show title"",""default"":true}","default must be boolean","Simple true/false toggle"
3
- 2,number,basic,number,"number, integer, numeric, count, quantity","type, id, label","default, min, max, step, placeholder","No default if omitted","{""type"":""number"",""id"":""columns"",""label"":""Columns"",""default"":3,""min"":1,""max"":6}","Must be a finite number; min/max/step are optional","Use for numeric inputs like column counts or sizes"
4
- 3,range,basic,number,"range, slider, min, max, step, unit, numeric","type, id, label, min, max, step","default, unit","Returns numeric value within min-max bounds","{""type"":""range"",""id"":""opacity"",""label"":""Opacity"",""min"":0,""max"":100,""step"":1,""default"":80,""unit"":""%""}","min/max/step are required; unit is display-only","Renders as a range slider in theme editor"
5
- 4,select,basic,string,"select, dropdown, options, choice, enum, list","type, id, label, options","default","Returns value of selected option","{""type"":""select"",""id"":""layout"",""label"":""Layout"",""options"":[{""value"":""grid"",""label"":""Grid""},{""value"":""list"",""label"":""List""}],""default"":""grid""}","options array required; each option needs value and label","Renders as dropdown select"
6
- 5,text,basic,string,"text, string, input, single line, short text, label","type, id, label","default, placeholder, info","Returns empty string if blank","{""type"":""text"",""id"":""heading"",""label"":""Heading"",""default"":""Welcome"",""placeholder"":""Enter heading""}","Single-line text; no HTML allowed","Use for short string inputs like headings or labels"
7
- 6,textarea,basic,string,"textarea, multiline, long text, paragraph, string","type, id, label","default, placeholder, info","Returns empty string if blank","{""type"":""textarea"",""id"":""description"",""label"":""Description"",""default"":""Enter your text here""}","Multi-line plain text; no HTML rendered","Use for longer text content without formatting"
8
- 7,radio,basic,string,"radio, radio button, choice, options, visual select","type, id, label, options","default","Returns value of selected radio option","{""type"":""radio"",""id"":""alignment"",""label"":""Alignment"",""options"":[{""value"":""left"",""label"":""Left""},{""value"":""right"",""label"":""Right""}],""default"":""left""}","options array required; each option needs value and label","Renders as visual radio buttons; similar to select"
9
- 8,text_alignment,basic,string,"text alignment, align, left, center, right, justify","type, id, label","default","Returns left/center/right/justify string","{""type"":""text_alignment"",""id"":""text_align"",""label"":""Text alignment"",""default"":""left""}","Returns one of: left, center, right, justify","Renders as alignment picker with visual icons"
10
- 9,color,color,string,"color, colour, hex, picker, rgba, background, foreground","type, id, label","default","Returns hex string or empty if not set","{""type"":""color"",""id"":""button_color"",""label"":""Button color"",""default"":""#1a1a1a""}","Stored as hex; supports rgba via color_to_rgb filter","Renders color picker; use color filters for manipulation"
11
- 10,color_background,color,string,"color background, gradient, solid, linear, radial, color","type, id, label","default","Returns CSS-compatible color or gradient string","{""type"":""color_background"",""id"":""bg_color"",""label"":""Background color"",""default"":""#ffffff""}","Supports solid colors and CSS gradients","Use for background colors that may need gradient support"
12
- 11,color_scheme,color,string,"color scheme, scheme, palette, theme colors, global","type, id, label","default","Returns reference to a color scheme object","{""type"":""color_scheme"",""id"":""color_scheme"",""label"":""Color scheme"",""default"":""scheme-1""}","Requires color_scheme_group defined in theme settings","References globally defined color schemes"
13
- 12,color_scheme_group,color,object,"color scheme group, palette group, schemes, global colors","type, id, label","definition","Returns group containing multiple color scheme definitions","{""type"":""color_scheme_group"",""id"":""color_scheme_group"",""label"":""Color scheme group""}","Used in theme settings to define available schemes","Top-level definition; referenced by color_scheme type"
14
- 13,image_picker,media,object,"image, photo, picture, media, upload, asset","type, id, label","default, info","Returns image object or null","{""type"":""image_picker"",""id"":""hero_image"",""label"":""Hero image"",""info"":""Recommended 1920x600px""}","Returns Shopify image object; use image_url filter","Access image via settings.image_picker_id | image_url"
15
- 14,video,media,object,"video, shopify video, hosted video, media, mp4","type, id, label","info","Returns Shopify-hosted video object or null","{""type"":""video"",""id"":""background_video"",""label"":""Background video""}","Only supports Shopify-hosted videos; use video_tag filter","Use video_tag filter to render; different from video_url"
16
- 15,video_url,media,string,"video url, youtube, vimeo, external video, embed, url","type, id, label","accept, placeholder, info","Returns URL string for YouTube or Vimeo","{""type"":""video_url"",""id"":""video_link"",""label"":""Video URL"",""accept"":[""youtube"",""vimeo""],""placeholder"":""Enter YouTube or Vimeo URL""}","accept array specifies allowed providers: youtube/vimeo","Use external_video_tag or external_video_url filter"
17
- 16,richtext,content,string,"richtext, rich text, html, formatted, wysiwyg, content","type, id, label","default, info","Returns HTML string with block-level elements","{""type"":""richtext"",""id"":""content"",""label"":""Content"",""default"":""<p>Add your content here</p>""}","Default must be valid HTML with block elements (p/ul/ol/h1-h6)","Supports p/ul/ol/h1-h6/br/strong/em/a tags"
18
- 17,inline_richtext,content,string,"inline richtext, inline, rich text, formatted, inline html","type, id, label","default, info","Returns HTML string without block-level elements","{""type"":""inline_richtext"",""id"":""subtitle"",""label"":""Subtitle"",""default"":""<strong>Bold text</strong> and normal text""}","No block-level elements allowed (no p/ul/h1 etc)","Use for inline formatted text within headings or captions"
19
- 18,html,content,string,"html, raw html, markup, code, custom html, embed","type, id, label","default, placeholder, info","Returns raw HTML string","{""type"":""html"",""id"":""custom_html"",""label"":""Custom HTML"",""placeholder"":""<div>Your HTML</div>""}","No sanitization; raw output; XSS risk if user-generated","Renders raw HTML; use with caution for security"
20
- 19,liquid,content,string,"liquid, liquid code, template, dynamic, code, markup","type, id, label","default, info","Returns Liquid code string to be rendered","{""type"":""liquid"",""id"":""custom_liquid"",""label"":""Custom Liquid"",""default"":""{{ shop.name }}""}","Must be valid Liquid; executed in section context","Powerful but risky; allows full Liquid template access"
21
- 20,font_picker,content,object,"font, typography, typeface, google fonts, system font, font family","type, id, label","default, info","Returns font object with family/fallback/weight/style","{""type"":""font_picker"",""id"":""body_font"",""label"":""Body font"",""default"":""sans-serif""}","Returns font object; use font_face/font_url/font_modify filters","Access via settings.body_font.family for CSS font-family"
22
- 21,url,resource-single,string,"url, link, href, external link, internal link, path","type, id, label","default, info","Returns URL string or null","{""type"":""url"",""id"":""button_link"",""label"":""Button link"",""default"":""/collections/all""}","Returns relative or absolute URL string","Supports internal Shopify paths and external URLs"
23
- 22,collection,resource-single,object,"collection, product collection, catalog, group","type, id, label","info","Returns collection object or null","{""type"":""collection"",""id"":""featured_collection"",""label"":""Collection""}","Returns full Shopify collection object","Access products via collection.products array"
24
- 23,product,resource-single,object,"product, item, variant, merchandise, single product","type, id, label","info","Returns product object or null","{""type"":""product"",""id"":""featured_product"",""label"":""Product""}","Returns full Shopify product object with variants","Access via settings.product_id with product properties"
25
- 24,blog,resource-single,object,"blog, posts, articles, journal, news","type, id, label","info","Returns blog object or null","{""type"":""blog"",""id"":""featured_blog"",""label"":""Blog""}","Returns Shopify blog object; access articles via blog.articles","Use for blog section featuring latest posts"
26
- 25,page,resource-single,object,"page, static page, content page, about","type, id, label","info","Returns page object or null","{""type"":""page"",""id"":""info_page"",""label"":""Page""}","Returns Shopify page object with content property","Access page.content for rendered HTML content"
27
- 26,article,resource-single,object,"article, blog post, post, news item","type, id, label","info","Returns article object or null","{""type"":""article"",""id"":""featured_article"",""label"":""Article""}","Returns single Shopify article object","Access article.title/content/image/author etc"
28
- 27,link_list,resource-single,object,"link list, menu, navigation, linklist, nav, links","type, id, label","default, info","Returns linklist object with links array","{""type"":""link_list"",""id"":""menu"",""label"":""Menu"",""default"":""main-menu""}","Returns Shopify linklist/menu object; access via links array","Iterate links array: for link in linklists[settings.menu].links"
29
- 28,metaobject,resource-single,object,"metaobject, custom data, structured data, reference","type, id, label","info","Returns metaobject instance or null","{""type"":""metaobject"",""id"":""featured_meta"",""label"":""Featured metaobject""}","Requires metaobject definition to exist in store","Access fields via metaobject.field_key.value"
30
- 29,collection_list,resource-list,array,"collection list, multiple collections, array, group, catalog","type, id, label","limit","Returns array of collection objects (max 20)","{""type"":""collection_list"",""id"":""collections"",""label"":""Collections"",""limit"":6}","Max 20 items by default; limit prop caps selection","Iterate with for collection in settings.collections"
31
- 30,product_list,resource-list,array,"product list, multiple products, array, items, selection","type, id, label","limit","Returns array of product objects (max 20)","{""type"":""product_list"",""id"":""products"",""label"":""Products"",""limit"":4}","Max 20 items; limit prop caps selection","Iterate with for product in settings.products"
32
- 31,article_list,resource-list,array,"article list, multiple articles, posts, blog posts, array","type, id, label","limit","Returns array of article objects (max 20)","{""type"":""article_list"",""id"":""articles"",""label"":""Articles"",""limit"":3}","Max 20 items; limit prop caps selection","Iterate with for article in settings.articles"
33
- 32,metaobject_list,resource-list,array,"metaobject list, multiple metaobjects, array, custom data","type, id, label","limit","Returns array of metaobject instances (max 20)","{""type"":""metaobject_list"",""id"":""items"",""label"":""Items"",""limit"":10}","Max 20 items; limit prop caps selection","Requires metaobject definition in store"
34
- 33,name,schema-property,string,"name, section name, display name, label, title","name","","Section name shown in theme editor","{""name"":""Hero Banner""}","Required string; shown as section label in editor","Displayed in Shopify theme editor section list"
35
- 34,tag,schema-property,string,"tag, html tag, wrapper, element, section tag, div","tag","","Defaults to div if not specified","{""tag"":""section""}","Valid HTML5 element tags: div/section/article/aside/header/footer","Sets the HTML wrapper element for the section"
36
- 35,class,schema-property,string,"class, css class, html class, wrapper class, styling","class","","No class added if not specified","{""class"":""featured-section spaced-section""}","Space-separated CSS class names string","Added to the section wrapper element's class attribute"
37
- 36,limit,schema-property,number,"limit, max instances, section limit, count","limit","","No limit by default","{""limit"":1}","Integer; restricts how many times section can be added to template","Use limit: 1 for sections that should appear only once"
38
- 37,max_blocks,schema-property,number,"max blocks, blocks limit, maximum, block count","max_blocks","","Default is 50 blocks","{""max_blocks"":16}","Integer; limits how many blocks can be added to section","Controls maximum number of blocks in section"
39
- 38,presets,schema-property,array,"presets, defaults, initial, theme editor preset, add section","presets","","No presets means section cannot be added via theme editor","{""presets"":[{""name"":""Featured Product""}]}","Array of preset objects with name property; enables Add section","Without presets section only usable if in template JSON"
40
- 39,blocks,schema-property,array,"blocks, block types, repeatable, dynamic blocks, content blocks","blocks","","No blocks if omitted","{""blocks"":[{""type"":""text"",""name"":""Text"",""settings"":[{""type"":""richtext"",""id"":""text"",""label"":""Text""}]}]}","Array of block type objects with type/name/settings","Define repeatable content units within a section"
41
- 40,enabled_on,schema-property,object,"enabled on, template restriction, allow, whitelist, templates","enabled_on","","Available everywhere if not specified","{""enabled_on"":{""templates"":[""index"",""product""]}}","Object with templates array listing allowed template types","Restricts section to specific page template types"
42
- 41,disabled_on,schema-property,object,"disabled on, template restriction, deny, blacklist, exclude","disabled_on","","No restrictions if not specified","{""disabled_on"":{""templates"":[""password""]}}","Object with templates array listing disallowed template types","Prevents section from appearing on specific template types"
43
- 42,settings,schema-property,array,"settings, configuration, inputs, section settings, options","settings","","Empty settings array if omitted","{""settings"":[{""type"":""text"",""id"":""heading"",""label"":""Heading""}]}","Array of setting type objects; each requires type/id/label","Main container for all section-level input settings"
44
- 43,default,schema-property,object,"default, initial values, preset defaults, starting configuration","default","","No default configuration if omitted","{""default"":{""settings"":{""heading"":""Welcome""},""blocks"":[{""type"":""text"",""settings"":{""text"":""Hello""}}]}}","Object with settings and blocks keys for initial values","Sets initial values when section is added via presets"
45
- 44,locales,schema-property,object,"locales, translations, i18n, internationalization, language","locales","","No translations if omitted","{""locales"":{""en"":{""title"":""Title""},""fr"":{""title"":""Titre""}}}","Nested object by locale code then translation key","Provides translated strings for section labels"
46
- 45,templates,schema-property,array,"templates, restrict, page types, template types, whitelist","templates","","Available on all templates if omitted","{""templates"":[""index"",""product"",""collection""]}","Array of template type strings","Restricts which templates the section appears on"
1
+ No,Type,Category,Returns,Keywords,Required Props,Optional Props,Default Behavior,JSON Example,Constraints,Notes
2
+ 1,checkbox,basic,boolean,"checkbox, boolean, toggle, true, false, on, off","type, id, label",default,Defaults to false if not set,"{""type"":""checkbox"",""id"":""show_title"",""label"":""Show title"",""default"":true}",default must be boolean,Simple true/false toggle
3
+ 2,number,basic,number,"number, integer, numeric, count, quantity","type, id, label","default, min, max, step, placeholder",No default if omitted,"{""type"":""number"",""id"":""columns"",""label"":""Columns"",""default"":3,""min"":1,""max"":6}",Must be a finite number; min/max/step are optional,Use for numeric inputs like column counts or sizes
4
+ 3,range,basic,number,"range, slider, min, max, step, unit, numeric","type, id, label, min, max, step","default, unit",Returns numeric value within min-max bounds,"{""type"":""range"",""id"":""opacity"",""label"":""Opacity"",""min"":0,""max"":100,""step"":1,""default"":80,""unit"":""%""}",min/max/step are required; unit is display-only,Renders as a range slider in theme editor
5
+ 4,select,basic,string,"select, dropdown, options, choice, enum, list","type, id, label, options",default,Returns value of selected option,"{""type"":""select"",""id"":""layout"",""label"":""Layout"",""options"":[{""value"":""grid"",""label"":""Grid""},{""value"":""list"",""label"":""List""}],""default"":""grid""}",options array required; each option needs value and label,Renders as dropdown select
6
+ 5,text,basic,string,"text, string, input, single line, short text, label","type, id, label","default, placeholder, info",Returns empty string if blank,"{""type"":""text"",""id"":""heading"",""label"":""Heading"",""default"":""Welcome"",""placeholder"":""Enter heading""}",Single-line text; no HTML allowed,Use for short string inputs like headings or labels
7
+ 6,textarea,basic,string,"textarea, multiline, long text, paragraph, string","type, id, label","default, placeholder, info",Returns empty string if blank,"{""type"":""textarea"",""id"":""description"",""label"":""Description"",""default"":""Enter your text here""}",Multi-line plain text; no HTML rendered,Use for longer text content without formatting
8
+ 7,radio,basic,string,"radio, radio button, choice, options, visual select","type, id, label, options",default,Returns value of selected radio option,"{""type"":""radio"",""id"":""alignment"",""label"":""Alignment"",""options"":[{""value"":""left"",""label"":""Left""},{""value"":""right"",""label"":""Right""}],""default"":""left""}",options array required; each option needs value and label,Renders as visual radio buttons; similar to select
9
+ 8,text_alignment,basic,string,"text alignment, align, left, center, right, justify","type, id, label",default,Returns left/center/right/justify string,"{""type"":""text_alignment"",""id"":""text_align"",""label"":""Text alignment"",""default"":""left""}","Returns one of: left, center, right, justify",Renders as alignment picker with visual icons
10
+ 9,color,color,string,"color, colour, hex, picker, rgba, background, foreground","type, id, label",default,Returns hex string or empty if not set,"{""type"":""color"",""id"":""button_color"",""label"":""Button color"",""default"":""#1a1a1a""}",Stored as hex; supports rgba via color_to_rgb filter,Renders color picker; use color filters for manipulation
11
+ 10,color_background,color,string,"color background, gradient, solid, linear, radial, color","type, id, label",default,Returns CSS-compatible color or gradient string,"{""type"":""color_background"",""id"":""bg_color"",""label"":""Background color"",""default"":""#ffffff""}",Supports solid colors and CSS gradients,Use for background colors that may need gradient support
12
+ 11,color_scheme,color,string,"color scheme, scheme, palette, theme colors, global","type, id, label",default,Returns reference to a color scheme object,"{""type"":""color_scheme"",""id"":""color_scheme"",""label"":""Color scheme"",""default"":""scheme-1""}",Requires color_scheme_group defined in theme settings,References globally defined color schemes
13
+ 12,color_scheme_group,color,object,"color scheme group, palette group, schemes, global colors","type, id, label",definition,Returns group containing multiple color scheme definitions,"{""type"":""color_scheme_group"",""id"":""color_scheme_group"",""label"":""Color scheme group""}",Used in theme settings to define available schemes,Top-level definition; referenced by color_scheme type
14
+ 13,image_picker,media,object,"image, photo, picture, media, upload, asset","type, id, label","default, info",Returns image object or null,"{""type"":""image_picker"",""id"":""hero_image"",""label"":""Hero image"",""info"":""Recommended 1920x600px""}",Returns Shopify image object; use image_url filter,Access image via settings.image_picker_id | image_url
15
+ 14,video,media,object,"video, shopify video, hosted video, media, mp4","type, id, label",info,Returns Shopify-hosted video object or null,"{""type"":""video"",""id"":""background_video"",""label"":""Background video""}",Only supports Shopify-hosted videos; use video_tag filter,Use video_tag filter to render; different from video_url
16
+ 15,video_url,media,string,"video url, youtube, vimeo, external video, embed, url","type, id, label","accept, placeholder, info",Returns URL string for YouTube or Vimeo,"{""type"":""video_url"",""id"":""video_link"",""label"":""Video URL"",""accept"":[""youtube"",""vimeo""],""placeholder"":""Enter YouTube or Vimeo URL""}",accept array specifies allowed providers: youtube/vimeo,Use external_video_tag or external_video_url filter
17
+ 16,richtext,content,string,"richtext, rich text, html, formatted, wysiwyg, content","type, id, label","default, info",Returns HTML string with block-level elements,"{""type"":""richtext"",""id"":""content"",""label"":""Content"",""default"":""<p>Add your content here</p>""}",Default must be valid HTML with block elements (p/ul/ol/h1-h6),Supports p/ul/ol/h1-h6/br/strong/em/a tags
18
+ 17,inline_richtext,content,string,"inline richtext, inline, rich text, formatted, inline html","type, id, label","default, info",Returns HTML string without block-level elements,"{""type"":""inline_richtext"",""id"":""subtitle"",""label"":""Subtitle"",""default"":""<strong>Bold text</strong> and normal text""}",No block-level elements allowed (no p/ul/h1 etc),Use for inline formatted text within headings or captions
19
+ 18,html,content,string,"html, raw html, markup, code, custom html, embed","type, id, label","default, placeholder, info",Returns raw HTML string,"{""type"":""html"",""id"":""custom_html"",""label"":""Custom HTML"",""placeholder"":""<div>Your HTML</div>""}",No sanitization; raw output; XSS risk if user-generated,Renders raw HTML; use with caution for security
20
+ 19,liquid,content,string,"liquid, liquid code, template, dynamic, code, markup","type, id, label","default, info",Returns Liquid code string to be rendered,"{""type"":""liquid"",""id"":""custom_liquid"",""label"":""Custom Liquid"",""default"":""{{ shop.name }}""}",Must be valid Liquid; executed in section context,Powerful but risky; allows full Liquid template access
21
+ 20,font_picker,content,object,"font, typography, typeface, google fonts, system font, font family","type, id, label","default, info",Returns font object with family/fallback/weight/style,"{""type"":""font_picker"",""id"":""body_font"",""label"":""Body font"",""default"":""sans-serif""}",Returns font object; use font_face/font_url/font_modify filters,Access via settings.body_font.family for CSS font-family
22
+ 21,url,resource-single,string,"url, link, href, external link, internal link, path","type, id, label","default, info",Returns URL string or null,"{""type"":""url"",""id"":""button_link"",""label"":""Button link"",""default"":""/collections/all""}",Returns relative or absolute URL string,Supports internal Shopify paths and external URLs
23
+ 22,collection,resource-single,object,"collection, product collection, catalog, group","type, id, label",info,Returns collection object or null,"{""type"":""collection"",""id"":""featured_collection"",""label"":""Collection""}",Returns full Shopify collection object,Access products via collection.products array
24
+ 23,product,resource-single,object,"product, item, variant, merchandise, single product","type, id, label",info,Returns product object or null,"{""type"":""product"",""id"":""featured_product"",""label"":""Product""}",Returns full Shopify product object with variants,Access via settings.product_id with product properties
25
+ 24,blog,resource-single,object,"blog, posts, articles, journal, news","type, id, label",info,Returns blog object or null,"{""type"":""blog"",""id"":""featured_blog"",""label"":""Blog""}",Returns Shopify blog object; access articles via blog.articles,Use for blog section featuring latest posts
26
+ 25,page,resource-single,object,"page, static page, content page, about","type, id, label",info,Returns page object or null,"{""type"":""page"",""id"":""info_page"",""label"":""Page""}",Returns Shopify page object with content property,Access page.content for rendered HTML content
27
+ 26,article,resource-single,object,"article, blog post, post, news item","type, id, label",info,Returns article object or null,"{""type"":""article"",""id"":""featured_article"",""label"":""Article""}",Returns single Shopify article object,Access article.title/content/image/author etc
28
+ 27,link_list,resource-single,object,"link list, menu, navigation, linklist, nav, links","type, id, label","default, info",Returns linklist object with links array,"{""type"":""link_list"",""id"":""menu"",""label"":""Menu"",""default"":""main-menu""}",Returns Shopify linklist/menu object; access via links array,Iterate links array: for link in linklists[settings.menu].links
29
+ 28,metaobject,resource-single,object,"metaobject, custom data, structured data, reference","type, id, label",info,Returns metaobject instance or null,"{""type"":""metaobject"",""id"":""featured_meta"",""label"":""Featured metaobject""}",Requires metaobject definition to exist in store,Access fields via metaobject.field_key.value
30
+ 29,collection_list,resource-list,array,"collection list, multiple collections, array, group, catalog","type, id, label",limit,Returns array of collection objects (max 20),"{""type"":""collection_list"",""id"":""collections"",""label"":""Collections"",""limit"":6}",Max 20 items by default; limit prop caps selection,Iterate with for collection in settings.collections
31
+ 30,product_list,resource-list,array,"product list, multiple products, array, items, selection","type, id, label",limit,Returns array of product objects (max 20),"{""type"":""product_list"",""id"":""products"",""label"":""Products"",""limit"":4}",Max 20 items; limit prop caps selection,Iterate with for product in settings.products
32
+ 31,article_list,resource-list,array,"article list, multiple articles, posts, blog posts, array","type, id, label",limit,Returns array of article objects (max 20),"{""type"":""article_list"",""id"":""articles"",""label"":""Articles"",""limit"":3}",Max 20 items; limit prop caps selection,Iterate with for article in settings.articles
33
+ 32,metaobject_list,resource-list,array,"metaobject list, multiple metaobjects, array, custom data","type, id, label",limit,Returns array of metaobject instances (max 20),"{""type"":""metaobject_list"",""id"":""items"",""label"":""Items"",""limit"":10}",Max 20 items; limit prop caps selection,Requires metaobject definition in store
34
+ 33,name,schema-property,string,"name, section name, display name, label, title",name,,Section name shown in theme editor,"{""name"":""Hero Banner""}",Required string; shown as section label in editor,Displayed in Shopify theme editor section list
35
+ 34,tag,schema-property,string,"tag, html tag, wrapper, element, section tag, div",tag,,Defaults to div if not specified,"{""tag"":""section""}",Valid HTML5 element tags: div/section/article/aside/header/footer,Sets the HTML wrapper element for the section
36
+ 35,class,schema-property,string,"class, css class, html class, wrapper class, styling",class,,No class added if not specified,"{""class"":""featured-section spaced-section""}",Space-separated CSS class names string,Added to the section wrapper element's class attribute
37
+ 36,limit,schema-property,number,"limit, max instances, section limit, count",limit,,No limit by default,"{""limit"":1}",Integer; restricts how many times section can be added to template,Use limit: 1 for sections that should appear only once
38
+ 37,max_blocks,schema-property,number,"max blocks, blocks limit, maximum, block count",max_blocks,,Default is 50 blocks,"{""max_blocks"":16}",Integer; limits how many blocks can be added to section,Controls maximum number of blocks in section
39
+ 38,presets,schema-property,array,"presets, defaults, initial, theme editor preset, add section",presets,,No presets means section cannot be added via theme editor,"{""presets"":[{""name"":""Featured Product""}]}",Array of preset objects with name property; enables Add section,Without presets section only usable if in template JSON
40
+ 39,blocks,schema-property,array,"blocks, block types, repeatable, dynamic blocks, content blocks",blocks,,No blocks if omitted,"{""blocks"":[{""type"":""text"",""name"":""Text"",""settings"":[{""type"":""richtext"",""id"":""text"",""label"":""Text""}]}]}",Array of block type objects with type/name/settings,Define repeatable content units within a section
41
+ 40,enabled_on,schema-property,object,"enabled on, template restriction, allow, whitelist, templates",enabled_on,,Available everywhere if not specified,"{""enabled_on"":{""templates"":[""index"",""product""]}}",Object with templates array listing allowed template types,Restricts section to specific page template types
42
+ 41,disabled_on,schema-property,object,"disabled on, template restriction, deny, blacklist, exclude",disabled_on,,No restrictions if not specified,"{""disabled_on"":{""templates"":[""password""]}}",Object with templates array listing disallowed template types,Prevents section from appearing on specific template types
43
+ 42,settings,schema-property,array,"settings, configuration, inputs, section settings, options",settings,,Empty settings array if omitted,"{""settings"":[{""type"":""text"",""id"":""heading"",""label"":""Heading""}]}",Array of setting type objects; each requires type/id/label,Main container for all section-level input settings
44
+ 43,default,schema-property,object,"default, initial values, preset defaults, starting configuration",default,,No default configuration if omitted,"{""default"":{""settings"":{""heading"":""Welcome""},""blocks"":[{""type"":""text"",""settings"":{""text"":""Hello""}}]}}",Object with settings and blocks keys for initial values,Sets initial values when section is added via presets
45
+ 44,locales,schema-property,object,"locales, translations, i18n, internationalization, language",locales,,No translations if omitted,"{""locales"":{""en"":{""title"":""Title""},""fr"":{""title"":""Titre""}}}",Nested object by locale code then translation key,Provides translated strings for section labels
46
+ 45,templates,schema-property,array,"templates, restrict, page types, template types, whitelist",templates,,Available on all templates if omitted,"{""templates"":[""index"",""product"",""collection""]}",Array of template type strings,Restricts which templates the section appears on
47
+ 46,header,display,none,"header, section header, divider, label, group title, display",content,info,Renders as a heading label in the theme editor,"{""type"":""header"",""content"":""Section settings""}",Display-only; no value returned to Liquid,Groups settings visually in theme editor; not accessible in Liquid
48
+ 47,paragraph,display,none,"paragraph, info text, help text, description, display",content,,Renders as body text in the theme editor,"{""type"":""paragraph"",""content"":""Customize the hero section below""}",Display-only; no value returned to Liquid,Adds descriptive text between settings in theme editor