Skip to content
Nook, home

Docs for Nook 1.0.0

Accessibility and motion

Nook is built so every shopper can browse and buy: with a mouse, a keyboard or a screen reader, or zoomed in. Your content matters too; the notes below help you keep it that way.

What the theme does

  • Keyboard: every menu, drawer, filter, swatch and button works with the keyboard and shows a clear focus outline. A Skip to content link is the first thing keyboard users reach.
  • Screen readers: buttons and fields have names, cart and filter updates are announced, and headings follow a logical order.
  • Text size: all text is at least 12 pixels and grows with the shopper's browser text size and zoom. Large headings scale smoothly with the screen size.
  • Contrast: the four color schemes meet the WCAG AA contrast guidelines for text and controls.
  • Tap targets: buttons are at least 44 pixels, and links and small controls at least 24.
  • Reduced motion: when a shopper's device asks for less motion, Nook turns off fades and slides, stops scrolling text and shows the hero's still image instead of the video.
  • Pause buttons: the hero video, video, scrolling text and announcement bar have visible pause buttons whenever they're moving.
  • Without JavaScript: menus, filters, sorting, paging, the cart and forms still work.

Motion settings

Under Theme settings › Animations:

  • Reveal sections on scroll: sections fade in as shoppers scroll.
  • Move scrolling text: turn off to show the scrolling text standing still.

Keep your content accessible

  • Alt text: describe each product and lifestyle image in a few words ("Harlow sofa in oat bouclé, front view"). Leave alt text empty only for purely decorative images.
  • Colors: if you edit a color scheme, check that text and buttons still stand out from the background. Aim for a contrast ratio of at least 4.5:1 for text.
  • Text over photos: the Hero video, Collection slideshow and Image with quote always use light text over a dark shade. Keep Overlay strength (Hero video) or Overlay opacity (Collection slideshow) high enough that the text reads clearly on your photo; the minimum for both is 40%. The Image with quote section sits on a fixed shade.
  • Headings: each page has one main heading (the page or product title). Use section headings in order and don't choose a heading for its size alone.
  • Links: write link and button text that makes sense on its own ("Shop sofas", not "Click here").
  • Video: add captions to videos with speech.

Performance

  • Upload images at least 2400 pixels wide for full-width sections, and at least 1600 pixels wide for all others. Shopify resizes them for each screen.
  • For the hero video, keep the video short (a few seconds that loop), about 1920 pixels wide and under 10 MB. Set a poster image: it's what shoppers see first and while the video loads.
  • Each app you install can add code to every page. Remove apps you don't use.

Something here unclear or out of date? Contact support.