> ## 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.

# Header

> Configure your store's primary navigation, logo, menu structure, and utility tools.

The header section controls your store's primary navigation area, appearing consistently across all pages. It manages logo display, menu structure, search and cart access, and provides flexible layout options to match your brand identity.

<img src="https://mintcdn.com/digifist/OifBjyC-ivi-Rsyo/images/theme/sahara/sections/header/header-overview.png?fit=max&auto=format&n=OifBjyC-ivi-Rsyo&q=85&s=517c9f0c38d5a64c38fd32b87f5547a5" alt="Header section overview" width="3280" height="2186" data-path="images/theme/sahara/sections/header/header-overview.png" />

## What this section controls

* Logo display and sizing for desktop and mobile
* Navigation menu structure and layout
* Megamenu promotional cards and badges
* Search, cart, and account utilities
* Sticky header behavior and transparency effects
* Country/language selector placement

## Getting started

<Steps>
  <Step title="Open Theme Customizer">
    From Shopify admin, access the Theme Customizer.
  </Step>

  <Step title="Locate Header section">
    The Header section is automatically present at the top of your store. Find it in the left sidebar under Static sections.
  </Step>

  <Step title="Choose layout">
    Select your preferred layout from 6 available options to match your brand style.
  </Step>

  <Step title="Upload logo">
    Add your logo image or SVG code to replace the default store name text.
  </Step>
</Steps>

<img src="https://mintcdn.com/digifist/OifBjyC-ivi-Rsyo/images/theme/sahara/sections/header/header-location.png?fit=max&auto=format&n=OifBjyC-ivi-Rsyo&q=85&s=b2aa40f5d5d6dc9f82a21a87781d6b37" alt="Header location in Theme Customizer" width="3280" height="2186" data-path="images/theme/sahara/sections/header/header-location.png" />

## Layout options

Choose from 6 header layouts to control navigation and logo placement:

<Tabs>
  <Tab title="Logo Centered">
    **Default layout** - Logo centered with navigation split on left and right sides.

    Utilities (search, cart, account) appear on the right. Best for brand-focused stores where logo prominence matters most.

    <img src="https://mintcdn.com/digifist/OifBjyC-ivi-Rsyo/images/theme/sahara/sections/header/layout-logo-centered.png?fit=max&auto=format&n=OifBjyC-ivi-Rsyo&q=85&s=1697374cf9afcb2f9d5ddbd14740f81f" alt="Logo centered layout" width="3280" height="2186" data-path="images/theme/sahara/sections/header/layout-logo-centered.png" />
  </Tab>

  <Tab title="Navigation Centered">
    Navigation menu centered with logo on the left and utilities on the right.

    Works well for stores with concise navigation (3-5 menu items).

    <img src="https://mintcdn.com/digifist/OifBjyC-ivi-Rsyo/images/theme/sahara/sections/header/layout-nav-centered.png?fit=max&auto=format&n=OifBjyC-ivi-Rsyo&q=85&s=02262fb9e78eafbd1b9a603af80cc4c3" alt="Navigation centered layout" width="3280" height="2186" data-path="images/theme/sahara/sections/header/layout-nav-centered.png" />
  </Tab>

  <Tab title="Logo Centered, Nav Below">
    Logo centered on first row, navigation centered below on second row.

    Creates distinct visual separation. Ideal for stores with many menu items that need more horizontal space.

    <img src="https://mintcdn.com/digifist/hYQr0XufUEvbhaNj/images/theme/sahara/sections/header/layout-logo-nav-below.png?fit=max&auto=format&n=hYQr0XufUEvbhaNj&q=85&s=adbf3d92d8c4c11a125d7c28e93be2a6" alt="Logo centered with navigation below" width="3280" height="2186" data-path="images/theme/sahara/sections/header/layout-logo-nav-below.png" />
  </Tab>

  <Tab title="Nav Centered Below">
    All content (logo, utilities) on first row, navigation centered below on second row.

    Maximizes logo and utility visibility while giving navigation dedicated space.

    <img src="https://mintcdn.com/digifist/hYQr0XufUEvbhaNj/images/theme/sahara/sections/header/layout-nav-below.png?fit=max&auto=format&n=hYQr0XufUEvbhaNj&q=85&s=8e9312f769fb903f8dd2c1e046e7e4c9" alt="Navigation centered below layout" width="3280" height="2186" data-path="images/theme/sahara/sections/header/layout-nav-below.png" />
  </Tab>

  <Tab title="Nav and Logo Left">
    Logo and navigation aligned to the left, utilities on the right.

    Clean left-aligned layout. Works for minimal designs or when utilities need prominence.

    <img src="https://mintcdn.com/digifist/hYQr0XufUEvbhaNj/images/theme/sahara/sections/header/layout-nav-logo-left.png?fit=max&auto=format&n=hYQr0XufUEvbhaNj&q=85&s=05351790b56358c871fce1359b892e63" alt="Navigation and logo left aligned" width="3280" height="2186" data-path="images/theme/sahara/sections/header/layout-nav-logo-left.png" />
  </Tab>

  <Tab title="Navigation Drawer">
    Mobile-style drawer menu for desktop and mobile. Hamburger icon opens full-screen navigation menu.

    Best for complex navigation with many categories or deep menu hierarchies.

    <img src="https://mintcdn.com/digifist/OifBjyC-ivi-Rsyo/images/theme/sahara/sections/header/layout-nav-drawer.png?fit=max&auto=format&n=OifBjyC-ivi-Rsyo&q=85&s=9ca8d591849f6f08f21976a62b067741" alt="Navigation drawer layout" width="3280" height="2186" data-path="images/theme/sahara/sections/header/layout-nav-drawer.png" />
  </Tab>
</Tabs>

## General settings

<Tabs>
  <Tab title="Sticky Header">
    ### Enable sticky header

    Header remains visible when scrolling down the page.

    **Default:** Enabled

    Keeps navigation and cart accessible throughout browsing. We recommend leaving this enabled for better user experience.

    <img src="https://mintcdn.com/digifist/hYQr0XufUEvbhaNj/images/theme/sahara/sections/header/sticky-header.png?fit=max&auto=format&n=hYQr0XufUEvbhaNj&q=85&s=9ac5f6545425903ee40d41f188e7bb69" alt="Sticky header setting" width="3280" height="2186" data-path="images/theme/sahara/sections/header/sticky-header.png" />
  </Tab>

  <Tab title="Transparency">
    ### Transparent header on scroll

    Maintains transparent header background even when scrolling.

    **Default:** Disabled

    When enabled, the header background remains transparent during page navigation. Use this for immersive homepage experiences where content flows behind the header.

    <Note>
      Requires sufficient contrast between header text and page content. Test thoroughly to ensure navigation remains readable.
    </Note>

    ### Bottom border for transparent header

    Adds subtle border line at bottom of transparent header.

    **Default:** Enabled

    Provides visual separation between header and page content when transparency is active. Only works when transparent header is enabled.

    <img src="https://mintcdn.com/digifist/hYQr0XufUEvbhaNj/images/theme/sahara/sections/header/transparent-header.png?fit=max&auto=format&n=hYQr0XufUEvbhaNj&q=85&s=dbb20a8547bc6f8a4298fd8339196d22" alt="Transparent header settings" width="3280" height="2186" data-path="images/theme/sahara/sections/header/transparent-header.png" />
  </Tab>

  <Tab title="Navigation Drawer">
    ### Enable navigation drawer layer

    Adds show/hide toggles to third-level menu items in navigation drawer.

    **Default:** Enabled

    Creates accordion-style expansion for deep menu hierarchies. Disable if you have shallow navigation (1-2 levels) to simplify the drawer interface.

    <img src="https://mintcdn.com/digifist/OifBjyC-ivi-Rsyo/images/theme/sahara/sections/header/drawer-layer.png?fit=max&auto=format&n=OifBjyC-ivi-Rsyo&q=85&s=eb68d77777d98421705b4dd34a243e27" alt="Navigation drawer layer setting" width="3280" height="2186" data-path="images/theme/sahara/sections/header/drawer-layer.png" />
  </Tab>
</Tabs>

## Logo settings

<Tabs>
  <Tab title="Logo Images">
    ### Logo

    Primary logo image displayed in the header.

    Upload PNG or JPG with transparent background. Recommended size: 400×100px.

    ### Logo for transparent header

    Alternative logo used when transparent header is enabled.

    Use a version with different color (typically white or dark) to ensure visibility against varied backgrounds.

    ### SVG code

    Paste SVG code directly for vector logo display.

    Overwrites uploaded image if SVG code is present. SVG logos scale perfectly at any size.

    <Tip>
      SVG logos load faster and scale perfectly. Use SVG code when possible for best quality.
    </Tip>

    <img src="https://mintcdn.com/digifist/3KkBT-t6Ampd2IuI/images/theme/sahara/sections/header/logo-upload.png?fit=max&auto=format&n=3KkBT-t6Ampd2IuI&q=85&s=31d980d0621e7b24ccbc5ca76d36a66d" alt="Logo upload settings" width="3280" height="2186" data-path="images/theme/sahara/sections/header/logo-upload.png" />
  </Tab>

  <Tab title="Logo Sizing">
    ### Max desktop width

    Controls logo width on desktop screens.

    **Range:** 50-200px\
    **Default:** 120px

    Only applies when logo image or SVG is present. Text logos use font size setting instead.

    ### Max mobile width

    Controls logo width on mobile screens.

    **Range:** 40-160px\
    **Default:** 80px

    Smaller default ensures header elements fit on mobile screens.

    ### Logo font size

    Controls text logo size when no image/SVG is uploaded.

    **Range:** 0.5× - 4.0×\
    **Default:** 1.0×

    Only affects text-based logos (when logo image/SVG fields are empty).

    <img src="https://mintcdn.com/digifist/3KkBT-t6Ampd2IuI/images/theme/sahara/sections/header/logo-sizing.png?fit=max&auto=format&n=3KkBT-t6Ampd2IuI&q=85&s=e1372a6a58343c08f8c3433bc35ceabd" alt="Logo sizing controls" width="3280" height="2186" data-path="images/theme/sahara/sections/header/logo-sizing.png" />
  </Tab>
</Tabs>

## Navigation settings

<Tabs>
  <Tab title="Menus">
    ### Menu

    Primary navigation menu for desktop.

    **Default:** main-menu

    Create menus in Shopify admin under **Online Store > Navigation**.

    ### Mobile menu

    Alternative menu for mobile devices.

    Leave empty to use the same menu as desktop. Create simplified mobile menu for better small-screen experience.

    ### Submenu

    Additional menu visible only in navigation drawer layout.

    **Default:** main-menu

    Appears below primary navigation in drawer. Use for secondary links like policies, help center, or social links.

    <img src="https://mintcdn.com/digifist/3KkBT-t6Ampd2IuI/images/theme/sahara/sections/header/menu-selection.png?fit=max&auto=format&n=3KkBT-t6Ampd2IuI&q=85&s=7e3dc4615153d7c7e445134d50fa7167" alt="Menu selection settings" width="3280" height="2186" data-path="images/theme/sahara/sections/header/menu-selection.png" />
  </Tab>

  <Tab title="Layout">
    ### Menu column count

    Number of columns in megamenu dropdown.

    **Range:** 1-6 columns\
    **Default:** 5

    Controls how menu items distribute horizontally in megamenu. More columns = wider megamenu. Fewer columns = more compact display.

    <Note>
      Adjust based on number of items in your menu. 3-5 columns works well for most stores.
    </Note>

    <img src="https://mintcdn.com/digifist/hYQr0XufUEvbhaNj/images/theme/sahara/sections/header/menu-columns.png?fit=max&auto=format&n=hYQr0XufUEvbhaNj&q=85&s=94e8f8df66de1f8b431e92ecdc44f1a6" alt="Menu column count setting" width="3280" height="2186" data-path="images/theme/sahara/sections/header/menu-columns.png" />
  </Tab>
</Tabs>

## Additional links

Add up to 2 standalone links in header navigation or utilities area (placement depends on layout).

<Tabs>
  <Tab title="First Link">
    ### Label

    Link text displayed to visitors.

    **Default:** "Collections"

    ### Link

    Destination URL for the link.

    **Default:** /collections

    <img src="https://mintcdn.com/digifist/OifBjyC-ivi-Rsyo/images/theme/sahara/sections/header/additional-link-1.png?fit=max&auto=format&n=OifBjyC-ivi-Rsyo&q=85&s=c72073132ff6cf226c3029491e49b655" alt="First additional link settings" width="3280" height="2186" data-path="images/theme/sahara/sections/header/additional-link-1.png" />
  </Tab>

  <Tab title="Second Link">
    ### Label

    Link text displayed to visitors.

    **Default:** "Products"

    ### Link

    Destination URL for the link.

    **Default:** /collections/all

    <img src="https://mintcdn.com/digifist/OifBjyC-ivi-Rsyo/images/theme/sahara/sections/header/additional-link-2.png?fit=max&auto=format&n=OifBjyC-ivi-Rsyo&q=85&s=1db586cf70e45155e5b6b4be45c7587d" alt="Second additional link settings" width="3280" height="2186" data-path="images/theme/sahara/sections/header/additional-link-2.png" />
  </Tab>
</Tabs>

<Note>
  Additional link placement varies by layout. In centered layouts, links appear in utilities area. In left-aligned layouts, links appear in main navigation.
</Note>

## Country drawer

Control where language and currency selectors appear.

### Enable in header

Display country/language selector in main header navigation or utilities.

**Default:** Enabled

Position depends on selected layout.

### Enable in navigation drawer

Display country/language selector in navigation drawer menu.

**Default:** Enabled

Appears at bottom of drawer menu on both desktop and mobile.

<Tip>
  Enable in both locations for maximum accessibility, or choose one location to simplify header design.
</Tip>

<img src="https://mintcdn.com/digifist/hYQr0XufUEvbhaNj/images/theme/sahara/sections/header/country-drawer.png?fit=max&auto=format&n=hYQr0XufUEvbhaNj&q=85&s=8d808e5189c7051286a80f52d8b0b908" alt="Country drawer settings" width="3280" height="2186" data-path="images/theme/sahara/sections/header/country-drawer.png" />

## Megamenu settings

### Card aspect ratio

Image proportions for megamenu promotional cards on desktop.

**Options:** auto, 1:1, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5, 16:9, 9:16, 2:1, 4:1, 8:1, 1:2\
**Default:** 3:4 (portrait)

### Card aspect ratio for mobile

Image proportions for megamenu cards on mobile screens.

**Options:** (same as above)\
**Default:** 3:4

<Note>
  Aspect ratio only affects promotional cards added via blocks (Image with link and text), not regular menu items.
</Note>

<img src="https://mintcdn.com/digifist/_esiHYFPbGbrtz2H/images/theme/sahara/sections/header/megamenu-aspect-ratio.png?fit=max&auto=format&n=_esiHYFPbGbrtz2H&q=85&s=d25b3b7ff183a5f5942b273dd18d44b5" alt="Megamenu card aspect ratio settings" width="3280" height="2186" data-path="images/theme/sahara/sections/header/megamenu-aspect-ratio.png" />

## Design settings

<Tabs>
  <Tab title="Width">
    ### Section width

    Controls header container width.

    **Options:**

    * **Page** - Content width (1400px max)
    * **Fluid** - 90% viewport width
    * **Full** - Edge-to-edge (100vw)

    **Default:** Fluid

    <img src="https://mintcdn.com/digifist/_esiHYFPbGbrtz2H/images/theme/sahara/sections/header/section-width.png?fit=max&auto=format&n=_esiHYFPbGbrtz2H&q=85&s=cf007763baebac2804663def028c0d9c" alt="Section width setting" width="3280" height="2186" data-path="images/theme/sahara/sections/header/section-width.png" />
  </Tab>

  <Tab title="Color">
    ### Color scheme

    Background and text colors for header.

    **Default:** Scheme 1

    Choose scheme with sufficient contrast for navigation readability.

    <img src="https://mintcdn.com/digifist/_esiHYFPbGbrtz2H/images/theme/sahara/sections/header/color-scheme.png?fit=max&auto=format&n=_esiHYFPbGbrtz2H&q=85&s=45a041c1795b58ce87a7258615c6bd04" alt="Color scheme setting" width="3280" height="2186" data-path="images/theme/sahara/sections/header/color-scheme.png" />
  </Tab>
</Tabs>

## Block settings

Add promotional elements to your navigation using blocks.

<Tabs>
  <Tab title="Image with Link and Text">
    Add promotional card with image and text to megamenu dropdown.

    ### Available settings

    <AccordionGroup>
      <Accordion title="Menu item position" icon="arrow-down-1-9">
        Links the block to a specific top-level menu item.

        Enter the position number (1, 2, 3, etc.) of the tier 1 menu link. The block appears in that menu item's dropdown.

        **Example:** Enter "2" to attach block to second menu item.

        <img src="https://mintlify.s3.us-west-1.amazonaws.com/digifist/images/theme/sahara/sections/header/block-position.png" alt="Menu item position setting" />
      </Accordion>

      <Accordion title="Color scheme" icon="palette">
        Background and text colors for promotional card.

        **Default:** Scheme 1

        Can differ from header color scheme for visual emphasis.
      </Accordion>

      <Accordion title="Image" icon="image">
        Card background image.

        Recommended size based on aspect ratio setting (e.g., 400×533px for 3:4 portrait).
      </Accordion>

      <Accordion title="Position" icon="align-justify">
        Vertical alignment of card content.

        **Options:**

        * **Top** - Content aligned to top
        * **Center** - Content centered vertically
        * **Bottom** - Content aligned to bottom

        **Default:** Center

        <img src="https://mintlify.s3.us-west-1.amazonaws.com/digifist/images/theme/sahara/sections/header/card-alignment.png" alt="Content vertical alignment setting" />
      </Accordion>

      <Accordion title="Heading" icon="heading">
        Card title text.

        **Default:** "Heading goes here"

        Supports inline formatting (bold, italic).
      </Accordion>

      <Accordion title="Link type" icon="link">
        How visitors interact with the card.

        **Options:**

        * **Button** - Shows clickable button with custom text
        * **Card** - Entire card is clickable (no visible button)

        **Default:** Card

        <img src="https://mintcdn.com/digifist/hYQr0XufUEvbhaNj/images/theme/sahara/sections/header/link-type.png?fit=max&auto=format&n=hYQr0XufUEvbhaNj&q=85&s=0d7aae55bb7e15acd730f22e5ba9b414" alt="Link type setting" width="3280" height="2186" data-path="images/theme/sahara/sections/header/link-type.png" />
      </Accordion>

      <Accordion title="Button label" icon="tag">
        Text displayed on button.

        Only visible when Link type is set to "Button".

        **Example:** "Shop Now", "Learn More"
      </Accordion>

      <Accordion title="Link" icon="external-link">
        Destination URL when clicking card or button.
      </Accordion>
    </AccordionGroup>

    <Tip>
      Use promotional cards to highlight featured collections, new arrivals, or seasonal campaigns directly in navigation.
    </Tip>
  </Tab>

  <Tab title="Menu Link Badge">
    Add badge labels to menu items (e.g., "New", "Sale", "Hot").

    ### Available settings

    <AccordionGroup>
      <Accordion title="Menu item position" icon="arrow-down-1-9">
        Links the badge to a specific top-level menu item.

        Enter position number (1, 2, 3, etc.) of the tier 1 menu link. Badge appears next to that menu item's text.

        <img src="https://mintlify.s3.us-west-1.amazonaws.com/digifist/images/theme/sahara/sections/header/badge-position.png" alt="Badge menu position setting" />
      </Accordion>

      <Accordion title="Badge label" icon="tag">
        Text displayed in the badge.

        Keep short (1-4 characters) for best display. Examples: "New", "Sale", "%"

        <img src="https://mintcdn.com/digifist/OifBjyC-ivi-Rsyo/images/theme/sahara/sections/header/badge-label.png?fit=max&auto=format&n=OifBjyC-ivi-Rsyo&q=85&s=6ed3744e68fcabd55e97ffc0c42d3a9c" alt="Badge label setting" width="3280" height="2186" data-path="images/theme/sahara/sections/header/badge-label.png" />
      </Accordion>

      <Accordion title="Badge style" icon="shapes">
        Visual shape of the badge.

        **Options:**

        * **Square** - Sharp corners
        * **Rounded** - Rounded corners (pill shape)

        **Default:** Rounded

        <img src="https://mintlify.s3.us-west-1.amazonaws.com/digifist/images/theme/sahara/sections/header/badge-style.png" alt="Badge style setting" />
      </Accordion>
    </AccordionGroup>

    <Warning>
      Use badges sparingly. Too many badges reduce their effectiveness and create visual clutter.
    </Warning>
  </Tab>
</Tabs>

## Best practices

<CardGroup cols={2}>
  <Card title="Choose layout strategically" icon="table-layout">
    Logo centered works for brand-focused stores. Navigation drawer suits stores with deep navigation hierarchies (10+ categories).
  </Card>

  <Card title="Enable sticky header" icon="thumbtack">
    Keep sticky header enabled (default) to ensure cart and search remain accessible while customers browse.
  </Card>

  <Card title="Optimize logo sizing" icon="expand">
    Desktop logos at 100-140px and mobile at 60-100px create balanced proportions. Test on actual devices.
  </Card>

  <Card title="Use transparent header carefully" icon="eye-slash">
    Transparent header works best on homepage hero images. Ensure sufficient text contrast throughout scrolling.
  </Card>

  <Card title="Simplify mobile navigation" icon="mobile-screen">
    Create separate mobile menu with fewer items (5-7 max) for better small-screen usability.
  </Card>

  <Card title="Match megamenu columns to items" icon="columns-3">
    3-5 columns works for most stores. Adjust based on menu item count to avoid awkward spacing.
  </Card>

  <Card title="Position blocks strategically" icon="list-ol">
    Attach promotional cards to your most popular or seasonal menu items for maximum visibility.
  </Card>

  <Card title="Limit menu badges" icon="award">
    Use 1-2 badges maximum. Focus on promoting new collections or active sales only.
  </Card>

  <Card title="Test country drawer placement" icon="globe">
    Enable in header for quick access. Enable in drawer for cleaner header appearance. Test both.
  </Card>

  <Card title="Use SVG logos when possible" icon="vector-square">
    SVG logos scale perfectly at any size and load faster than PNG/JPG images.
  </Card>
</CardGroup>

## Related guides

<Card title="Announcement bar" icon="rectangle-ad" href="/themes/sahara/header/announcement-bar">
  Configure messages and promotions above the header
</Card>
