• Add with “/” and type “Paragraph,” or just start typing anywhere in an empty block area.
• Use the floating toolbar for Bold, Italic, Link, Inline Code, and Highlight.
• Enable Drop Cap in the block sidebar for editorial/magazine-style opening paragraphs.
• Avoid overriding font sizes at the block level — prefer global Typography settings in the Site Editor for consistency.
• Use the Text Alignment toolbar button (left, center, right) to control paragraph alignment.

• Use only one H1 per page — typically the post or page title.
• Follow a logical hierarchy: H2 for major sections → H3 for subsections. Never skip levels.
• Set an HTML Anchor (Advanced tab in sidebar) to create jump-link targets for long pages.
• Apply custom color or font size adjustments in the sidebar, but prefer global styles for consistency.
• Heading level and visual size are independent — you can style an H2 to look like an H4 without changing semantics.

• Switch between unordered / ordered using the toolbar toggle at the top of the block.
• Press Tab to indent a list item (create a nested child); Shift+Tab to outdent.
• Use the Start Value option (sidebar) to begin an ordered list at a number other than 1.
• Style variants: Default and No Bullets (available in the Styles panel).
• Avoid deeply nested lists (3+ levels) — they’re hard to read on mobile.

• The citation field (below the quote text) is for attribution — name, title, source, or publication.
• Switch to the Large style variant (Styles panel) for more prominent editorial quotes.
• Other blocks can be nested inside a Quote — useful for multi-paragraph attributed passages.
• For decorative pull quotes displayed visually mid-column, prefer the Pullquote block instead.

• Choose between Default and Solid Line styles in the block Styles panel.
• Customize background color and text color for branded, on-theme quote styling.
• The citation field is optional but recommended for attributed quotes.
• Use sparingly — one per long-form post maintains visual impact.
• Consider Wide Width alignment to break the quote out of the text column.

• Unlike Paragraph, Verse preserves hard line breaks exactly as typed — no <br> tags needed.
• Accepts inline formatting (bold, italic, links) — unlike the Code block.
• Adjust font family in the sidebar for a more literary or typewriter aesthetic.
• Use for poetry, lyrics, or structured plain text. Use the Code block for actual code snippets.

• Paste raw code — HTML entities are auto-escaped so tags display as text, not rendered HTML.
• No syntax highlighting is included natively — install a plugin (Prismatic, Enlighter, Code Syntax Block) for colored syntax.
• The font family and size can be adjusted in the sidebar Typography settings.
• For multi-file examples or documentation, consider a dedicated code block plugin with language tabs.

• Use when exact spacing and line breaks must be preserved without code-block styling.
• Accepts inline formatting (bold, italic, links) — unlike the Code block.
• Good for terminal output, ASCII diagrams, or plain-text data tables.
• For actual programming code, the Code block is more semantically appropriate.

• Set column and row count in the initial setup modal before creating the table.
• Enable Fixed Width Table Cells (sidebar) for equal-width columns.
• Toggle Header Section and Footer Section (sidebar) to add semantic <thead> and <tfoot> rows.
• Use the Stripes style variant for improved readability on wide data tables.
• Right-click any cell to access Insert Row/Column and Delete Row/Column options.

• Always fill in the Alt Text field — required for accessibility (WCAG) and SEO.
• Use Wide Width or Full Width alignment to break an image outside the content column for hero-style presentation.
• Link options: Media File (lightbox), Attachment Page, Custom URL, or None.
• Upload at 2× display size for retina screens (e.g., upload 2400px wide for a 1200px full-width display).
• Use the Image Size dropdown in the sidebar to serve the appropriate registered size — don’t always use Full Size.
• Decorative images (borders, dividers) with no meaning can have empty alt text (alt=””) — never omit the attribute entirely.

• Set column count (1–8) in the sidebar — the gallery is responsive and stacks on mobile automatically.
• Enable Crop Images to maintain a consistent aspect ratio across all images in the grid.
• Rearrange individual images via drag-and-drop inside the gallery block.
• Set Link To: Media File to enable a lightbox on click (requires a lightbox plugin or theme support for the lightbox UI).
• Click any individual image in the gallery to edit its alt text or caption independently.

• Use for self-hosted .mp4, .webm, or .ogg files — not YouTube/Vimeo (those are Embed blocks).
• Enable Muted + Autoplay + Loop and hide controls for a background/ambient video effect.
• Always add a Poster Image (the frame shown before playback) for better first-load UX.
• Self-hosting large video files increases bandwidth costs — consider a CDN or third-party host (Vimeo, Cloudinary) for production.
• Add a caption for context; it also aids accessibility for users who cannot view video.

• Use for podcasts, music previews, soundbites, and instructional audio clips.
• Upload via the Media Library or link to an external audio URL.
• Autoplay and Loop options are in the block sidebar — use sparingly to avoid surprising users.
• Always include surrounding text or a caption to give screen reader users context for the audio content.

• Use the Focal Point Picker to control which part of the background stays in frame when the cover is cropped on different screen sizes.
• Enable Fixed Background for a parallax scroll effect (may not work on all mobile browsers).
• Adjust Overlay Opacity to balance text legibility against background image visibility.
• Set a Minimum Height (px or vh) to prevent the Cover from collapsing on sparse content.
• Use Wide Width or Full Width alignment for hero sections that span the full viewport.
• Any block type can be placed inside the Cover — headings, paragraphs, buttons, forms, etc.

• Upload files via the Media Library or link to an external file URL.
• Toggle the Download button visibility in the block sidebar.
• Click the filename text in the editor to rename the visible link label.
• Enable Open in New Tab to prevent navigating users away from the current page.
• Enable the PDF Embed toggle to render PDF previews inline in supported browsers.

• Toggle media position (left/right) using the Media Position button in the block toolbar.
• Adjust the Media Width percentage slider (sidebar) for custom column splits (e.g., 60/40).
• Enable Stack on Mobile to vertically stack media above content on small screens.
• Use the Focal Point Picker to control image crop behavior inside the media panel.
• The text area accepts any block type — headings, paragraphs, lists, buttons, etc.

• Group is the primary FSE layout primitive — use it to create cards, sections, and containers.
• Layout type options: Block (default stacked), Row (flex horizontal), Stack (flex vertical), Grid.
• Apply background color + padding + border radius to create visually distinct content sections.
• Nest Groups: a Full Width outer Group with a constrained inner Group creates a colored full-bleed section with centered content.
• Use the “Inner Blocks Use Content Width” toggle to constrain inner content to the theme’s content width inside a wide Group.

• Select the column count and preset layout in the initial modal that appears on insert.
• Set a custom Width % per column in the sidebar to create asymmetric layouts (e.g., 66/33).
• Style individual Column blocks independently with background, border, and padding for card-grid designs.
• Columns stack on mobile by default — consider content order and hierarchy when building for responsiveness.
• Nest Columns inside Groups for full-bleed colored section layouts with multi-column interiors.

• Insert via the block inserter by selecting “Row” — it’s a Group with Flex Row layout pre-applied.
• Justification options: Left, Center, Right, Space Between (toolbar or sidebar).
• Enable “Allow to wrap to multiple lines” for responsive behavior on small screens.
• Good for: logo bars, icon grids, tag/pill rows, inline CTAs, header logo + nav combos.
• Nest Rows inside Columns for complex multi-directional grid layouts.

• Insert via the block inserter and selecting “Stack” (Group with vertical Flex layout pre-applied).
• Control spacing between children using the Block Gap value in the sidebar Dimensions panel.
• Use the Justification option to align all children to left, center, or right.
• Ideal for card interiors where consistent internal spacing is needed without manual margin adjustments on each child block.

• Multiple buttons inside a single Buttons wrapper automatically arrange horizontally with wrapping.
• Each Button block has its own link, style (Fill/Outline), border radius, and color settings.
• Use the Justify Items option on the Buttons container to align the group left, center, or right.
• Open in New Tab is available per-button via the link settings gear icon.
• For accessibility, use descriptive link text (“Download the Report”) instead of generic labels (“Click Here” / “Learn More”).

• Select a style variant (Default, Wide, Dots) in the block Styles panel on the right sidebar.
• Customize the separator color via the Color settings in the sidebar.
• Default style is constrained to content width; Wide spans the full container width.
• Use between major content sections — avoid overuse to maintain visual rhythm.

• Drag the bottom handle to resize visually, or enter an exact pixel value in the sidebar.
• Use sparingly — prefer padding/margin settings on Group blocks for systemic, token-based spacing.
• Spacers are aria-hidden and invisible to screen readers — they are purely presentational.
• Useful as a quick fix for one-off spacing needs that don’t warrant a global style change.

This content is hidden by default and revealed on click. Use the Details block for FAQs, terms & conditions, supplemental information, or any content that benefits from progressive disclosure.

• Any block type can live inside a Details block.
• Details blocks can be nested inside other Details blocks for multi-level accordions.
• No JavaScript is required — it’s native HTML behavior.

• Click the Summary text inside the block to edit the always-visible label.
• Add any block inside the Details body — paragraphs, lists, images, or even nested Details.
• Requires WordPress 6.3+ — verify your site version before using.
• For FAQ sections, stack multiple Details blocks vertically inside a Group container.
• Style the summary and interior with Typography and Color settings in the sidebar.

• Paste any raw HTML — it renders unescaped on the front end exactly as entered.
• Toggle between Edit (code view) and Preview (rendered output) using the toolbar buttons.
• Common uses: third-party form embeds, custom SVG icons, JavaScript widgets, legacy shortcode HTML.
• Some HTML may be filtered by WordPress security settings — admin-level users can typically render <script> tags; editors/contributors cannot.
• Avoid using Custom HTML for content that could instead be handled by a native block.

• The Classic block appears when importing content from the Classic Editor or older WordPress installations.
• To modernize content, click the block and use “Convert to Blocks” in the block toolbar — this splits the HTML into individual native blocks.
• Avoid creating new Classic blocks on FSE sites — they bypass block-level styling controls.
• Use only as a temporary bridge for migrated content while converting to native blocks.

• The logo must be set in Settings → General → Site Icon & Logo (or via the Site Editor).
• Adjust width using the Image Width slider in the sidebar — the logo scales proportionally.
• Primarily used in the Header template part — place on pages for branding reference and QA.
• The logo links to the homepage by default; disable the link in the sidebar if needed.

• The title text pulls from Settings → General → Site Title — edit it there, not in the block.
• Set the heading level in the sidebar — use H1 on the homepage template, H2 or P on other templates.
• Disable the link option in the sidebar for static (non-clickable) site title text.

• Edit the tagline text at Settings → General → Tagline — not within the block itself.
• Often hidden on production sites via CSS or block visibility settings.
• Can be styled independently from the Site Title using Typography settings in the sidebar.

• Add menu items directly in the block or select a saved Navigation from the sidebar dropdown.
• Add sub-items by hovering a link and clicking the “Add submenu” button — creates dropdown navigation.
• Overlay Menu setting controls when the hamburger activates: Always, Never, or Mobile (default).
• Add a Search or Social Links block inside Navigation for inline search/social icon support.
• Navigation menus saved in the Site Editor appear as shared menus reusable across all templates.

• Configure post type, count, order, and taxonomy filters in the Query block’s sidebar settings.
• The Post Template inner block defines how each individual post item is displayed — customize freely.
• Add Query Pagination (Previous, Numbers, Next) inside the Query block for multi-page archives.
• Add a Query No Results block inside as a fallback message when no posts match.
• On archive/taxonomy templates, enable “Inherit Query from Template” to use the page’s current query context automatically.
• Use multiple Query Loop blocks on a single page for “Featured Posts” + “Recent Posts” patterns.

• Post Featured Image: Set dimensions, aspect ratio, and whether it links to the single post.
• Post Title: Set heading level — H1 on single post template, H2 or H3 inside Query Loop cards.
• Post Date: Choose display format (e.g., “January 1, 2025” vs. “2025-01-01”) in the sidebar.
• Post Author: Toggle avatar visibility, author name link, and biography text display.
• Post Excerpt: Set excerpt word count limit and customize the “read more” link text.
• Post Terms: Select the taxonomy to display (category, tag, or any custom taxonomy). Set a separator string between multiple terms.

• Use two blocks — one set to “Previous,” one set to “Next” — placed side-by-side in a Row Group.
• Enable Show Post Title to display the adjacent post’s title alongside the direction label.
• This block only produces output on single post templates — it renders empty on standard pages.
• Add an arrow character (← / →) to the Label field for a clear visual direction cue.

• The Comments block wraps all comment-related inner blocks — edit each independently for full control.
• Comment Template defines the layout of each individual comment (avatar, author name, date, content, reply link).
• Comments must be enabled in Settings → Discussion for this block to render output.
• Used primarily in the Single Post template in the Site Editor.
• Style the Post Comments Form with CSS custom properties or theme.json to match your design system.

• Toggle “Display Login as Form” to show an inline login form instead of a link.
• Logged-out visitors see “Log In”; logged-in users see “Log Out” — no conditional logic required.
• Customize the redirect URL after login/logout in the block’s Advanced settings.
• Useful inside Navigation blocks for sites with memberships, subscriptions, or client portals.

• Select which template part to reference from the dropdown in the block sidebar.
• Create and edit template parts in the Site Editor → Template Parts.
• Common parts: header, footer, sidebar, post-meta, comments.
• Edits to a template part propagate everywhere it's used — ideal for global header/footer UI.
• To create a new part, insert a Template Part block and click "Start blank" or "Choose existing."

• This block exists only inside templates — it acts as a placeholder for the post's actual content.
• Place it in the Single Post, Page, or any content template in the Site Editor.
• You can wrap the Post Content block in a Group with constrained layout to control max-width of post content.
• Do not use this block on pages that have their own block content — it is a template-level dynamic output only.

• Set button position: Button Outside (default), Button Inside, or No Button.
• Enable "Use Button Icon" to replace the button text with a magnifying glass icon.
• Customize the placeholder text for contextual search fields (e.g., "Search documentation…").
• Style the button using Color and Typography settings in the sidebar to match your design system.

• Adjust Posts to Show, Layout (List/Grid), and Columns in the sidebar.
• Toggle Featured Image, Post Date, Author, and Post Excerpt independently as needed.
• For full control over post card layout and custom queries, use the Query Loop block instead.
• Filter by Category in the sidebar to show posts from a specific category only.

• Set the number of comments to display (1–100) in the sidebar.
• Toggle Avatar, Date, and Excerpt display independently.
• Comments must be enabled (Settings → Discussion) for this block to render output.
• Best suited for blog sidebars or footer widgets on community or news-heavy sites.

• Enable "Display as Dropdown" to render a <select> element for compact sidebar navigation.
• Enable "Show Hierarchy" to visually display parent/child category relationships.
• Enable "Show Post Counts" to append the number of posts per category in parentheses.
• Enable "Show Empty Categories" to include categories with no posts (hidden by default).

• Type options: Monthly (default), Yearly, Daily, Weekly.
• Enable "Display as Dropdown" for a compact <select> version of the archives list.
• Enable "Show Post Counts" to display how many posts exist per archive period.
• Works best on content-heavy blogs and news sites with years of archive history.

• Dates with published posts become clickable links to that day's archive page.
• Use the previous/next month arrows to navigate.
• Styling is largely theme-controlled — the block has very limited sidebar options.
• Rarely used on modern marketing sites; more relevant for high-frequency news or event-based blogs.

• Set the Number of Tags to display — the most frequently used tags are shown.
• Adjust Smallest and Largest Font Size to define the visual weight range.
• Select any registered taxonomy (Tags, Categories, or custom) in the sidebar.
• Enable "Show Post Counts" to append tag usage numbers in parentheses after each tag.

• Enter a valid RSS/Atom feed URL in the block field and press Enter or click the arrow to load.
• Set Items to Show (1–20) and toggle Date, Author, and Excerpt display in the sidebar.
• RSS feeds are cached by WordPress — content changes may take time to appear on the front end.
• This block supports public feeds only — password-protected or authenticated feeds require a plugin.

• Add individual Social Link blocks for each platform — select the service to auto-assign the correct icon.
• Style variants: Default (background circle), Logos Only (no background), Pill Shape.
• Control icon size and color globally at the Social Links container level.
• Best placed in the site footer or inside a Navigation block.
• Enable "Open in New Tab" on each Social Link block to avoid navigating users away from the site.

• The block automatically pulls all published pages — no manual list creation needed.
• Page hierarchy (parent/child relationships) is reflected in visual indentation.
• To show only a sub-tree of pages, set a Parent Page filter in the block sidebar.
• Most commonly embedded inside a Navigation block to auto-generate a full page-hierarchy navigation menu.

• Paste a YouTube URL on its own paragraph line — WordPress auto-converts it to an embed on save.
• Alternatively, insert an Embed block, select the provider, then enter the URL.
• Add a start time by appending ?t=90 (seconds) or ?t=1m30s to the YouTube URL.
• For privacy-enhanced embeds, replace youtube.com with youtube-nocookie.com in the URL.
• All embeds are responsive by default and scale with their container.
• Add a caption beneath the embed for context, transcription links, or attribution.

• Paste a Vimeo video URL — WordPress auto-detects the provider and creates the embed.
• Vimeo Pro/Business privacy settings (password protection, domain restrictions) are honored in the embed.
• Right-click any video in Vimeo and choose "Copy Link" to get the embeddable URL.
• Use Vimeo for portfolio videos, brand films, and case study content where YouTube ads are inappropriate.

• Use public Spotify URLs for tracks, albums, playlists, artists, or podcast episodes.
• Right-click any item in Spotify and choose Share → Copy Link to get the embeddable URL.
• Works for both music and podcast content.
• Supports all Spotify content types: tracks, albums, playlists, artists, podcasts, and episodes.

• Copy a post's URL from X (e.g., https://x.com/username/status/123) and paste it into the Embed block.
• X/Twitter oEmbed can be unreliable — verify the embed renders before publishing.
• The embed inherits light/dark theme from the platform — theme control is limited.
• Consider screenshotting tweets as images if oEmbed reliability is a concern for critical content.

• All embeds are responsive — they scale to fill their container width automatically.
• Embeds respect the content column width. Use Wide/Full alignment to expand beyond the content column.
• If a URL doesn't embed automatically, try using the Embed block and manually selecting the provider.
• For privacy and GDPR compliance, consider a cookie-consent embed wrapper plugin (e.g., Borlabs Cookie) to defer third-party embed loading until user consent is given.
• Some providers (Instagram, TikTok) may require additional API credentials or platform approval to embed reliably.