Legal pages

Name: Legal pages
Author: Abdullah_omar

Compliance and legal pages management (AGB, Terms & Conditions, Privacy Policy, Impressum) for Medusa v2 with an interactive Admin Dashboard UI, public Store APIs, and multilingual support.

Featured on Medusa

npm install medusa-plugin-legal-pages

Medusa v2 Legal Pages & Compliance Plugin

A lightweight, production-ready Medusa v2 plugin for managing compliance and legal disclosure pages (AGB / Terms & Conditions, Datenschutzerklärung / Privacy Policy, and Impressum / Legal Notice) directly inside the Medusa Admin panel.

✨ Features

🏛️ Dedicated Medusa Admin UI: Adds a clean "Legal Pages" route to the Medusa Admin navigation bar.
📝 Live Markdown Workspace: Split-screen editor with real-time customer-facing preview, formatting toolbar, and keyboard shortcuts ( / ).
📝 Multi-Document Management: Create and manage customized compliance documents (Terms & Conditions, Privacy Policy, Imprint, Revocation) with custom versioning and draft/published statuses.
🚀 Dynamic App & Storefront Delivery: Public Store APIs (, ) allowing React Native mobile apps and Next.js storefronts to fetch compliance texts live without waiting for App Store or Google Play reviews.
🌐 Localization & Fallbacks: Built-in locale support (, , ) with automatic fallbacks to ensure legal screens are never blank.

📦 Installation

In your Medusa v2 backend project root:

npm install medusa-plugin-legal-pages

Or with yarn / pnpm:

1yarn add medusa-plugin-legal-pages
2# or
3pnpm add medusa-plugin-legal-pages

⚙️ Configuration

Simply register the plugin in your :

1import { defineConfig } from "@medusajs/framework/utils"
2
3module.exports = defineConfig({
4  projectConfig: {
5    // ... your project config
6  },
7  plugins: [
8    {
9      resolve: "medusa-plugin-legal-pages",
10      options: {},
11    },
12  ],
13})

That's it! In Medusa v2, registering the plugin automatically:

🧭 Injects the Legal Pages item into your Medusa Admin sidebar navigation.
📡 Exposes all Storefront & Admin REST API routes (, ).
🗄️ Registers the Legal Module and database schema.

🗄️ Database Migrations

Run the database migration to create the table and indexes:

npx medusa db:migrate

📡 Store API Reference

The plugin provides public endpoints for web storefronts and mobile apps:

1. List All Published Legal Pages

GET /store/legal-pages?locale=en

Response (200 OK):

1{
"legal_pages": [
  {
    "id": "leg_01J8ABC...",
    "slug": "terms",
    "title": "Terms and Conditions (GTC)",
    "locale": "en",
    "version": "1.0",
    "updated_at": "2026-09-26T20:00:00.000Z"
  },
  {
    "id": "leg_01J8DEF...",
    "slug": "privacy-policy",
    "title": "Privacy Policy (GDPR)",
    "locale": "en",
    "version": "1.0",
    "updated_at": "2026-09-26T20:00:00.000Z"
  }
]
20}

2. Retrieve Specific Legal Document (with Markdown Content)

GET /store/legal-pages/:slug?locale=de

Example:

Response (200 OK):

1{
"legal_page": {
  "id": "leg_01J8ABC...",
  "slug": "agb",
  "title": "Allgemeine Geschäftsbedingungen",
  "content": "# Allgemeine Geschäftsbedingungen\n\n### § 1 Geltungsbereich...",
  "locale": "de",
  "is_published": true,
  "version": "1.0",
  "updated_at": "2026-09-26T20:00:00.000Z"
}
12}

📱 Mobile App (React Native / Expo) Usage Example

1// services/legal.ts
2const MEDUSA_BACKEND_URL = "https://api.yourstore.com"
3
4export const fetchLegalPage = async (slug: string, locale: string = "de") => {
5  const res = await fetch(`${MEDUSA_BACKEND_URL}/store/legal-pages/${slug}?locale=${locale}`, {
6    headers: {
7      "x-publishable-api-key": process.env.EXPO_PUBLIC_MEDUSA_PUBLISHABLE_KEY!,
8      "Accept": "application/json",
9    },
10  })
11  if (!res.ok) return null
12  const data = await res.json()
13  return data.legal_page
14}

🛠️ Contributing

Contributions and feedback are always welcome! Feel free to open an issue or submit a pull request.

📄 License

Distributed under the MIT License. See LICENSE for more information.

Similar plugins

View all

Tax

Avalara

By U11d

Avalara AvaTax automated tax calculations

Featured on Medusa

Tax

Itrk

By Sadu-dev

Medusa plugin for syncing IT-Recht Kanzlei legal documents and exposing them to storefronts.

Featured on Medusa

Tax

Infakt

By Zanreal

Medusa v2 plugin for Polish invoicing: issues inFakt invoices for paid orders and files them to KSeF, with a durable, crash-safe state machine and an operator surface for invoices that need review.

Featured on Medusa