Skip to main content

Drupal 10 Editorial User Guide

For editors managing website content in Drupal 10.
This guide explains how to log in, create and edit content, use paragraph types, update menus and cards, add documents and calls to action, manage FAQs, and follow the editorial workflow.

1. Logging In

  1. Go to /user
  2. Enter your username and password
  3. Click Log in
  4. To log out, open the user menu (top right) → Log out

 

image.png

 

Reset your password

  1. On the login page, click Request new password
  2. Enter your email
  3. Follow the reset link sent to your inbox

Two-factor authentication (if enabled)

After logging in, enter the six-digit code from your authenticator app.

2. Understanding Content Types

Content Type Use When You Need To...
Basic Page Create a static page such as About, Terms, or Contact
Blog Post Publish an article or update with a date and author
Press Release Publish an announcement or formal statement
Product Showcase a product with description, image, and downloads

3. Creating Content

3.1 Basic Page

  1. In the admin toolbar, select Content → Add content → Basic page
  2. Fill in:
    • Title – clear and descriptive
    • Body – main text content
    • Summary – optional short excerpt
  3. Under URL alias, create a friendly URL (e.g. /about/company)
  4. Under Meta tags, add a description for SEO
  5. Click Save → choose Save as Draft

Tip: Use ## for headings, short paragraphs, and bullet lists for clarity.

3.2 Blog Post

  1. Content → Add content → Blog post
  2. Add:
    • Featured image (recommended 1200x630 px)
    • Tags (1–5 relevant keywords)
    • Author
  3. Save as Draft, then move to Needs Review when ready.

3.3 Press Release

  1. Content → Add content → Press release
  2. Enter Title, Body, and Press date
  3. (Optional) Upload a PDF document
  4. Choose a Category
  5. Save → Needs Review

3.4 Product Page

  1. Content → Add content → Product
  2. Fill:
    • Product Name
    • Short Description
    • Image
    • Specification Document (PDF)
    • Product Category
  3. Save → Needs Review

4. Paragraphs and Layout

Paragraphs are layout building blocks added inside a page’s Body field.

Paragraph Type Purpose
Text block Rich text section
Image + text Image beside copy
Video embed Embed YouTube/Vimeo link
Quote/Testimonial Highlight quote
Card grid Multiple linked cards
Accordion / FAQ Collapsible Q&A
CTA block Call-to-action button or link

How to Add a Paragraph

  1. In the Body area, click Add Paragraph
  2. Choose the desired type
  3. Complete the fields
  4. Click Add another item to add more sections

5. Section Styling

Each section (paragraph) may have color and width options.

Color options:

  • Default (light)
  • Dark (white text on dark background)
  • Accent (brand color)

Width options:

  • Full width
  • Contained (standard)
  • Half width (two-column)

Accessibility:
Ensure text has enough contrast and images include alt text.

6. Updating Cards, Menus, and Footer

6.1 Updating Card Links

  1. Edit the page containing the Card grid
  2. Locate the card you want to edit
  3. Update Card title, Link, and optional Description
  4. Save and check display

Tip: Use internal links (e.g. /services) rather than full URLs.

6.2 Editing the Main Menu

  1. Go to Structure → Menus → Main navigation
  2. Add, edit, or reorder links
  3. Fields:
    • Menu link title
    • Link
    • Parent item (for dropdowns)
  4. Click Save

Best practice:
Limit top-level items to 5–7. Keep titles short and consistent.

6.3 Editing the Footer

Depending on setup, your footer may use a menu or a block.

If using a menu:

  1. Structure → Menus → Footer menu
  2. Add or edit links
  3. Save

If using a block:

  1. Structure → Block layout
  2. Find the footer region
  3. Edit the content block
  4. Save

7. Adding Documents and Calls to Action

7.1 Upload a Document (PDF)

  1. Content → Media → Add media → Document
  2. Enter a Name (e.g. privacy-policy-2025.pdf)
  3. Add Alternative text
  4. Save

7.2 Add a Document Link in Text

Use Markdown syntax inside text fields:

[Download our Privacy Policy (PDF)](/media/privacy-policy-2025.pdf)

  • Link text must describe the document (avoid "click here").

7.3 Add a CTA Button

If a CTA Block paragraph is available:

  1. Add CTA Block
  2. Set:
    • Button text – e.g. “Download brochure”
    • Link – media file or URL
  3. Save

8. Adding FAQs

  1. Edit the target page
  2. Click Add Paragraph → Accordion / FAQ
  3. Fill:
    • Question
    • Answer
  4. Add additional items as needed
  5. Save and test expand/collapse

Writing tips:

  • Use short, clear questions
  • Keep answers concise
  • Use bullet points for steps

9. Editorial Workflow

States:

  • Draft → content in progress
  • Needs review → ready for review
  • Published → live
  • Archived → stored but hidden

Changing State

  1. Edit the content item
  2. Locate Moderation state
  3. Choose the next state (e.g. “Needs review”)
  4. Save

Good Practice

  • Add an editorial note if the reviewer needs context
  • Avoid editing directly on Published content unless minor
  • Archive old versions instead of deleting

10. Troubleshooting

Menu item missing

  • Check if it’s Enabled and correctly nested

Image blurry

  • Upload higher-resolution (recommended dimensions above)

Accordion doesn’t expand

  • Confirm paragraph type is “Accordion / FAQ”
  • Verify internal path or external URL is correct

11. Accessibility and Style

  • Use clear, structured headings (##, ###)
  • All images must have meaningful alt text
  • Ensure color contrast meets WCAG AA
  • Link text must describe destination (avoid “click here”)
  • Use short paragraphs and bullet points

12. Quick Reference

Field Description
Title Required page name
Summary Optional teaser
Body Main content area
Paragraphs Page layout sections
Menu settings Controls navigation links
URL alias Custom path
Meta tags SEO data
Featured image Hero image for Blog/Press
Moderation state Workflow status

End of document.

Back to top