> ## Documentation Index
> Fetch the complete documentation index at: https://docs.digifist.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Theme Settings

> Global configuration options that control your Sahara theme appearance and functionality

Theme Settings provide global controls that affect your entire store - from typography and colors to cart features and performance optimization. Changes made here cascade across all pages, sections, and templates, ensuring consistent design and functionality. Master these settings first to establish your store's foundation, then customize individual sections with confidence.

Theme Settings provide global controls that affect your entire store. Changes made here cascade across all pages, sections, and templates, ensuring consistent design and functionality.

<Tip>Think of Theme Settings as your store's foundation - configure these first before customizing individual sections.</Tip>

## Available Settings

<CardGroup cols={2}>
  <Card title="Typography" icon="text" href="/themes/sahara/theme-settings/typography">
    Fonts, sizing, spacing, and text styling for headings and body text
  </Card>

  <Card title="Colors" icon="palette" href="/themes/sahara/theme-settings/colors">
    Color schemes with backgrounds, text, buttons, and UI element colors
  </Card>

  <Card title="Layout" icon="grid" href="/themes/sahara/theme-settings/layout">
    Page width, section spacing, grid spacing, and media overlays
  </Card>

  <Card title="Buttons" icon="square" href="/themes/sahara/theme-settings/buttons">
    Button styles, shapes, text formatting, and input field styling
  </Card>

  <Card title="Social Media" icon="share-nodes" href="/themes/sahara/theme-settings/social-media">
    Social profile links and product sharing options
  </Card>

  <Card title="Common Settings" icon="sliders" href="/themes/sahara/common-settings">
    Shared settings used across all sections (width, spacing, borders)
  </Card>
</CardGroup>

## Configuration Order

For best results, configure theme settings in this order:

<Steps>
  <Step title="Typography">
    Start with fonts and text sizing - affects all content
  </Step>

  <Step title="Colors">
    Define color schemes that sections will inherit
  </Step>

  <Step title="Layout">
    Set page width and spacing that frames all sections
  </Step>

  <Step title="Buttons">
    Configure button styles that appear throughout
  </Step>

  <Step title="Social Media">
    Add profile links and enable sharing features
  </Step>
</Steps>

## How Theme Settings Work

<AccordionGroup>
  <Accordion title="Global vs Section Settings">
    **Theme Settings (Global):**

    * Apply to entire store
    * Set once, affect everywhere
    * Examples: Fonts, page width, color schemes
    * Changed in: Theme Settings panel

    **Section Settings (Local):**

    * Apply to individual sections
    * Can override theme settings
    * Examples: Section color scheme, heading text
    * Changed in: Individual section editors

    **Inheritance Model:**

    1. Theme Settings define defaults
    2. Sections inherit these defaults
    3. Sections can override when needed
  </Accordion>

  <Accordion title="Preview Before Publishing">
    **Testing Process:**

    1. Make changes in Theme Settings
    2. Preview across multiple pages:
       * Homepage
       * Collection page
       * Product page
       * Cart page
    3. Check both desktop and mobile
    4. Verify changes work with images
    5. Test on actual devices if possible
    6. Publish when confident

    **Common Issues to Check:**

    * Color contrast (text readable on all backgrounds?)
    * Button visibility (clear on all schemes?)
    * Layout on mobile (content fits well?)
    * Typography readability (comfortable at all sizes?)
  </Accordion>

  <Accordion title="Resetting to Defaults">
    **Individual Settings:**

    * No built-in reset button per setting
    * Refer to documentation for default values
    * Manually restore original values

    **Entire Theme:**

    * Use "Actions" → "Duplicate theme"
    * Restore from backup if available
    * Or reinstall theme (loses all customizations)

    **Best Practice:**

    * Duplicate theme before major changes
    * Document your custom values
    * Test changes thoroughly before publishing
  </Accordion>
</AccordionGroup>

## Best practices

1. **Start with defaults** - Sahara's defaults are well-balanced for most stores
2. **Change one setting at a time** - Test impact before making multiple changes
3. **Maintain consistency** - Keep typography, colors, and spacing coordinated
4. **Consider mobile** - Preview all changes on small screens
5. **Test accessibility** - Ensure text contrast meets WCAG standards
6. **Document changes** - Note custom values for future reference
7. **Duplicate before major changes** - Keep backup of working configuration

## Related Documentation

* [Common Settings](/themes/sahara/common-settings) - Section-level shared settings
* [Sections Overview](/themes/sahara/sections/) - Individual section documentation
* [Shopify Theme Customization](https://help.shopify.com/manual/online-store/themes/customize) - Official Shopify guide

***

**Need help?** Changes in Theme Settings affect your entire store. Preview thoroughly before publishing, and consider duplicating your theme before making major modifications.
