Open Doors International
Editor Guide

Page Editing Reference

Welcome to the comprehensive guide for editing pages in Sanity. This page demonstrates each available block type with examples and usage instructions.

Use this as a reference when building pages. Each section below shows a different block type in action.

Content Block

What is a Content Block?

The Content Block is your go-to choice for adding text content to a page. It's perfect for articles, descriptions, and any text-heavy sections.

Key Features:

  • Rich text editor with formatting options
  • Support for headings (H2-H6)
  • Bullet and numbered lists
  • Links (internal and external)
  • Bold, italic, and other text styles

When to Use:

Use Content Blocks when you need to add substantial text content. They work well for about pages, service descriptions, policy pages, and any content that needs rich formatting.

Example CTA Block

Call to Action Blocks Drive Engagement

CTA blocks are designed to capture attention and encourage visitors to take action. They typically include a compelling message and one or more buttons.

Use CTAs strategically throughout your pages to guide users toward important actions like signing up, donating, or learning more.

Left Column

Column Row blocks let you create side-by-side content layouts. This is a two-column layout where each column takes half the width.

Columns automatically stack on mobile devices for better readability on small screens.

Right Column

You can have 1-4 columns with various width configurations: equal widths, 2/3 + 1/3, 1/4 + 3/4, and more.

Each column can contain its own rich text content, making this block very flexible for complex layouts.

Showcase Features

Feature Cards with Icons

Feature Cards are great for highlighting key benefits, services, or features. Each card can have an icon, title, description, and optional link.

Easy to Use

Intuitive interface designed for content editors of all skill levels.

Flexible Layouts

Mix and match blocks to create unique page designs without coding.

Live Preview

See your changes in real-time with our visual editing experience.

FAQ Accordion Block

Interactive FAQ Sections

The FAQ Accordion block displays frequently asked questions in a collapsible format. Users can click on a question to reveal the answer.

How to Use:

  • First, create FAQ documents in the FAQ section of the studio
  • Add an FAQ Accordion block to your page
  • Select which FAQ items to include
  • Add an optional title, subtitle, and link

Benefits:

  • Reduces page clutter by hiding detailed answers
  • Improves user experience with interactive content
  • Great for support pages, product FAQs, and help centers

Subscribe Newsletter Block

Newsletter Signup Forms

The Subscribe Newsletter block adds an email signup form to your page. It connects to your email marketing platform to capture leads.

Configuration:

  • Set a compelling title and description
  • Configure the form action URL for your email platform
  • Customize button text and success messages

Place newsletter blocks at strategic points on your pages - typically at the end of articles or in dedicated signup sections.

Reusable Blocks

Section References & Banner References

Reusable blocks allow you to create content once and use it across multiple pages. When you update the source, all references update automatically.

Section Reference

Section References link to Reusable Section documents. These can contain entire page sections with multiple blocks - perfect for standardized headers, footers, or promotional sections.

Banner References link to Banner documents. Banners are typically used for announcements, promotions, or important notices that appear across multiple pages.

Best Practices:

  • Use reusable sections for content that appears on 3+ pages
  • Give reusable sections clear, descriptive internal names
  • Organize by category (e.g., 'CTAs', 'Headers', 'Testimonials')
  • Consider language when creating reusable content

Decoupling:

If you need to customize a reusable section for a specific page, you can 'decouple' it. This creates a standalone copy that won't sync with the original.

Pro Tips

Best Practices for Page Editing

Keep these guidelines in mind when building pages:

  • Start with a Hero or strong headline to capture attention
  • Break up long text with images, CTAs, or feature cards
  • Use consistent spacing throughout the page
  • Preview your changes on mobile devices
  • Use reusable sections for content that appears on multiple pages
  • Add descriptive internal names to complex blocks