We use cookies to improve your experience, analyze traffic, and personalize content. By clicking "Accept all" you agree to storing them on your device. Read our privacy policy.

Settings

This doc explains all the settings you’ll find under Settings in Mosaic. These options let you control how your theme looks, behaves, and integrates with WordPress.

Mosaic settings panel showing options for controling how Mosaic behaves

Mosaic gives you control over key preferences that affect privacy, performance, workflow, and font handling.

General

Mosaic General settings panel showing options for usage tracking, inline scripts, preloading CSS/JS, emoji support, and server-side thumbnail rendering
  • Allow tracking usage data: Collects anonymous usage info to help improve Mosaic. No personal data is tracked.
  • Load scripts inline: Embeds JavaScript in the page HTML instead of separate files.
  • Preload critical CSS and JS in Header: Loads key styles and scripts earlier by controlling fetch priority in the HTTP header. Enable it to load Mosaic’s layout faster and render the page sooner. Disable it if you’re using plugins that should load early, like a header slider, to keep a better Largest Contentful Paint (LCP) score.
  • WordPress emoji support: Enables WordPress’s built-in emoji script, ensuring emojis display consistently across all browsers and devices.
  • Server-side thumbnail rendering: Generates thumbnails on the server with Chrome headless for sharper, faster previews.

Post type

Mosaic Post type settings panel with option to manually assign to content types
  • Enable manual assign: Lets you manually control which content this applies to. You can enable it for All, or limit assignment to Posts, Pages, or Media.

Editor

Mosaic Editor settings panel showing options for small nudge, big nudge, preview in new window, and history limit
  • Small nudge: Sets how many pixels spacing values adjust when you drag them in the editor.
  • Big nudge: Sets how many pixels spacing values adjust when you drag them in the editor while holding Shift.
  • Open preview in new window: Opens the preview in a separate browser window.
  • History limit: Sets how many undo and redo steps the editor remembers.

Google fonts

Mosaic Google fonts settings panel with options to save fonts locally and set cache expiration
  • Save fonts locally: Stores Google fonts on your server instead of loading them from Google’s servers, improving privacy and performance.
  • Cache expiration: Controls how long browsers keep cached fonts before checking for updates.

Last updated: October 29, 2025

Still have more questions? Let us help!