Skip to main content

New Page

Book 1: Getting Started Page 1 — Introduction to the CMS

Drupal 10 powersEditorial theUser Guide

For editors managing website youcontent arein editing.Drupal 10.
This guide explains how to log in, create, edit,create and publishedit contentcontent, whileuse followingparagraph types, update menus and cards, add documents and calls to action, manage FAQs, and follow the correct editorial workflow.

Roles


and permissions

Editor: create and edit content in Draft or Needs Review states.

Reviewer: review and publish approved content.

Administrator: manage structure, menus, and configuration.

Core terms

Term Meaning Node A piece of content such as a page, blog, or product. Paragraph A reusable building block within a page layout. Block Content placed in site regions (e.g., footer). CTA “Call to Action” – a link or button encouraging user action. Page 2 —

1. Logging In

Open

    your
  1. Go webto browser/user
  2. and go to: https://your-site-domain/user

  3. Enter your username and password.

    password
  4. Click Log in.

    in
  5. You

  6. To willlog beout, redirected to your dashboard oropen the Contentuser list.

    menu

    Resetting(top right) → Log out

Reset your password

  1. On the login page, selectclick Request new password.

    password
  2. Enter your accountemail
  3. email.

    Check your inbox for

  4. Follow the reset link (validsent forto 24your hours).

    inbox

Two-Factorfactor Authenticationauthentication (if enabled)

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


2. Understanding Content Types

Content TypeUse When You Need To...
Basic PageCreate a static page such as About, Terms, or Contact
Blog PostPublish an article or update with a date and author
Press ReleasePublish an announcement or formal statement
ProductShowcase 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

LoggingTip: outUse ## 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 TypePurpose
Text blockRich text section
Image + textImage beside copy
Video embedEmbed YouTube/Vimeo link
Quote/TestimonialHighlight quote
Card gridMultiple linked cards
Accordion / FAQCollapsible Q&A
CTA blockCall-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)

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 ParagraphLogAccordion out./ 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

FieldDescription
TitleRequired page name
SummaryOptional teaser
BodyMain content area
ParagraphsPage layout sections
Menu settingsControls navigation links
URL aliasCustom path
Meta tagsSEO data
Featured imageHero image for Blog/Press
Moderation stateWorkflow status

End of document.