Skip to Content
DeveloperTheme Settings

Theme Settings

Defined in config/settings_schema.json and edited in Shopify Admin → Theme → Customize → Theme settings. Saved values live in config/settings_data.json.

Typography

  • type_heading_font (font picker, default assistant_n6)
  • type_body_font (font picker, default assistant_n4)
  • type_base_size (14–20px, default 16)
  • type_heading_scale (100–140%, default 120)
  • type_heading_weight (400–800, default 600)

Layout

  • max_page_width (80 / 96 / 120rem, default 96rem)
  • min_page_margin (12–60px, default 24)
  • spacing_sections (0–100px, default 56)

Colors

  • color_schemes — a color-scheme group of 3 schemes, each with background, background gradient, text, border, button and button-label colors. Mapped to CSS variables in css-variables.liquid.

Appearance

  • button_corner_radius (0–40px, default 6)
  • input_corner_radius (0–20px, default 6)
  • card_corner_radius (0–24px, default 10)
  • animations_enabled (default true)

Product

  • product_card_image_ratio (portrait | square)
  • product_card_hover_image (bool)
  • product_card_show_vendor (bool)
  • product_card_alignment (left | center)
  • product_card_swatches (bool)
  • swatch_option_names (e.g. Color, Colour)
  • swatch_config (text map, e.g. Sage: #9caf88)
  • show_discount_badge (bool)
  • discount_badge_type (amount | percent | both)

Cart

  • cart_free_shipping (bool, default true)
  • cart_free_shipping_threshold (number)

Social

  • social_instagram, social_facebook, social_x, social_youtube, social_tiktok, social_linkedin — feed the Organization sameAs.

SEO

  • schema_enabled, schema_organization, schema_product, schema_article, schema_breadcrumb, schema_faq
  • google_site_verification, bing_site_verification, yandex_verification, pinterest_verification
  • llms_txt, llms_full_txt, agents_md
  • brand_logo, share_image

The SEO settings drive the whole AI & SEO layer. Full detail is in that section.

Shopify’s Theme Store forbids a custom robots.txt.liquid, so Citera does not ship a robots override or an allow_ai_crawlers setting. Robots directives are managed through Shopify’s own robots settings.

Presets

settings_data.json ships three named presets: Warm Editorial, Bold Commerce, and Minimal Mono. Warm Editorial uses serif (Lora) headings with Assistant body on a cream/tan palette; the others swap fonts and colours. The store’s live values (fonts, colours, spacing) are whatever is saved in settings_data.json — pull the theme to see the current state.

BlocksAssets