Hero image for Using Modules in Real Pages

You now know where content lives and how Markdown works. This post shows the practical workflow for using WebGrid modules without guesswork.

What a Module Is

A module is a feature block you embed in a page using:

![[embeds/module-key]]

Common keys used in this scaffold:

  • blog-module
  • contact-form
  • store-module
  • gallery-module

Quick Start Pattern

Use this 4-step pattern every time:

  1. Open the page where the module should appear (blog.md, contact.md, store.md, or gallery.md).
  2. Add a short intro paragraph for context.
  3. Insert the embed line.
  4. Add a short outro or call-to-action below the embed.

That gives users orientation before and after interactive content.

Blog Module Example

---
title: Blog
visibility: private
---

Latest updates and guides:

![[embeds/blog-module]]

Start with the newest post at the top.

Contact Module Example

---
title: Contact
visibility: private
actionEmail: you@example.com
---

Questions? Send a message below.

![[embeds/contact-form]]

Store Module Example

---
title: Store
visibility: private
---

Browse products below.

![[embeds/store-module]]

Troubleshooting Checklist

If a module doesn't appear as expected:

  • Confirm the embed note name matches exactly (for example ![[embeds/blog-module]]).
  • Confirm the page has visibility: private.
  • Confirm supporting content exists (blog posts, products, gallery items).
  • Keep one blank line above and below embed syntax.

What’s Next

Next we walk through publishing workflow from draft to production-ready content.


Blog Module Syntax Guide · Publishing Workflow