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.
Multi-Column Layouts with Column Row
Column 1
Column 2
Section Block with Inner Blocks
The Section block is a flexible container that can hold various inner content blocks in different layouts.
Text Content Block
This is a Text Content inner block. It's perfect for adding formatted text within a section.
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.
Image Gallery Block
Image galleries showcase multiple images in either a grid or slider layout. Perfect for portfolios, event photos, or product showcases.
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
Get to know couragous Christians
My new Section
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
Reusable Content References
Reusable blocks allow you to create content once and use it across multiple pages. When you update the source, all references update automatically.
Banner Reference (Hero Carousels)
Banner documents contain one or more Hero slides that display as a carousel. Use Banner References to embed these carousels on any page.
- Multiple hero slides - Create engaging rotating content with different messages
- Autoplay settings - Configure auto-rotation speed (1-30 seconds)
- Transition effects - Choose between fade or slide animations
- Navigation controls - Show/hide arrows and pagination dots
- Persona targeting - Show specific slides based on visitor segments (Show All Matches or Show First Match)
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.
Best Practices:
- Use reusable content for elements appearing on 3+ pages
- Give clear, descriptive internal names (e.g., 'Homepage Hero Carousel 2025')
- Consider language when creating reusable content - each language needs its own version
- Test carousel autoplay and transitions before publishing
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.
Dynamic Content Block
Data-Driven Content Listings
The Dynamic Content block automatically pulls and displays content from your CMS based on filters you define. It's perfect for blog listings, resource libraries, and related content sections.
Content Types Supported:
- Blog posts - Display articles with filtering by category, country, or tags
- Pages - Show related pages based on taxonomy
- Resources - List downloadable assets like PDFs and guides
- Snippets - Pull in reusable content fragments
Key Configuration Options:
- Filter by taxonomy (topics, countries, site tags) - pre-filter content for editors
- Enable visitor filtering - let users filter content themselves
- Choose layout template (grid, list, cards)
- Set pagination and items per page
Dynamic Content blocks use SKOS taxonomy relationships, so child categories are automatically included when you filter by a parent topic.
World Watch List Map
Interactive Persecution Map
The WWL Map block displays an interactive map showing persecution levels across countries on the World Watch List. It visualizes persecution scores with colour-coded countries.
Display Modes:
- Full interactive - Includes history player and all controls for exploring data over time
- Map only - Simplified view without the history controls
Configuration:
- Select the WWL year dataset to display
- Optionally highlight a specific country on load
- Set the base path for country profile links
The map loads country profile metadata from your CMS and displays rank badges and tooltips using your brand colours.
Rich Text Building Blocks
Inline Content Elements
Within any rich text editor, you can insert special content blocks beyond basic text. These appear inline within your content flow.
Available Rich Text Elements:
- Quote - Styled pull quotes with optional citation and alignment options
- Summary/Detail - Collapsible disclosure component for expandable content
- YouTube Video - Embed videos by pasting the YouTube video ID
- Simple CTA - Inline call-to-action with background colour and button
- Buttons - Add button groups directly within text content
- Image - Inline images with alignment and width options
How to Insert:
In the rich text editor, click the '+' button or use the insert menu to add these special elements. They will appear inline with your text and can be moved or deleted like any other content.
