Official Integration • Medusa v2

Supercharge Your Medusa Store with AI-Powered, Brand-Aware Product Content

Generate conversion-focused product titles, subtitles, and descriptions directly inside Medusa v2 Admin. Maintain brand voice, support multi-language storefronts, and keep full editorial control before publishing.

Quick Install:
npm install @uribbon/medusa-plugin
Medusa Admin v2 / Products / Silk Artisan Scarf
URibbon Active
U

URibbon Content Copilot

Brand DNA & Locale Driven

v2.19+
Brand Persona Heritage Atelier
Locale English (en-US)
Proposed Title ✓ Approved

Loom-Woven Silk Mulberry Scarf

Proposed Subtitle ✓ Approved

Heirloom tactile luster handcrafted by master silk weavers.

Rich Description ✓ Selected

Spun from 100% grade-6A mulberry silk fibers, this signature wrap blends whispering softness with enduring structural resilience...

Atomic Safe (v2.1)

🎯 Key Business Benefits

Business Value & Why Merchants Need It

Generic AI produces flat, disengaged product descriptions. URibbon's Medusa plugin connects your store's catalog directly to your living Brand DNA—delivering high-converting, consistent copy across every product.

Consistent Brand Voice

How It Solves the Problem

Generates copy tailored to the store's configured Brand persona, tone, and guidelines stored in URibbon.

Business Impact

No generic AI copy; high-trust, brand-aligned messaging across all SKUs.

Multi-Language Ready

How It Solves the Problem

Automatically detects Medusa store locales (English, Persian fa-IR, Arabic, French, German, etc.) and generates localized content.

Business Impact

Effortlessly scale into international markets without expensive manual copywriting.

Human-in-the-Loop Safety

How It Solves the Problem

AI generates a preview with side-by-side comparison; merchants explicitly pick which fields (Title, Subtitle, Description) to apply.

Business Impact

Prevents accidental overwrites or unwanted changes to live catalog items.

Stale-Product Collision Protection

How It Solves the Problem

Built-in concurrency checks reject updates if someone edited the product between generation and application (409 Conflict).

Business Impact

Ensures team collaboration without data loss or race conditions.

Direct Draft Importer

How It Solves the Problem

Pull approved, ready-to-publish campaigns from URibbon directly into Medusa as Draft Products.

Business Impact

Bridges marketing team workflows directly into inventory and catalog management.

Authentication

Where & How to Get the URibbon API Key

Connecting Medusa v2 to your URibbon workspace takes under two minutes. Follow these three simple steps:

Step 1 01

Sign in to URibbon

Sign in to your URibbon account at uribbon.com using your credentials or RibbonID.

Step 2 02

Navigate to API Settings

Go to Dashboard → Settings → API & Integrations in your URibbon Studio workspace.

Step 3 03

Create & Copy Key

Click "Create New API Key", name it "Medusa Admin", and securely copy the generated key.

Brand Setup

Ensure at least one Brand profile is created under your URibbon organization (e.g., Brand Name, Tone of Voice, Target Audience). The plugin will automatically retrieve your brands once connected.

Enterprise-Grade Security

The API key is stored securely on the Medusa backend database and is never exposed to browser clients or admin frontend scripts.

Developer & Merchant Guide

How to Install & Configure

Follow this simple 4-step setup to integrate @uribbon/medusa-plugin into your Medusa v2 project.

01

Install the plugin

Add the official npm package to your Medusa v2 backend project dependencies.
bash
npm install @uribbon/medusa-plugin
02

Register in medusa-config.ts

Add the plugin definition to your Medusa backend configuration.
typescript
import { defineConfig } from "@medusajs/framework/utils"

module.exports = defineConfig({
  plugins: [
    {
      resolve: "@uribbon/medusa-plugin",
    },
  ],
})
03

Run database migration

Create the plugin's persistent settings tables in your Medusa database.
bash
npx medusa db:migrate
04

Configure in Medusa Admin

Open your Medusa Admin panel and navigate to Settings → URibbon to finalize setup.
  • Enter your URibbon API URL (default: https://api.uribbon.com).
  • Paste your API Key and click Save Settings.
  • Select your Default Brand (automatically populated from your URibbon account) and Default Language.

Interactive Workflow

How It Works on Product Pages

Experience an intuitive, non-destructive copywriting copilot embedded directly in your Medusa product editor.

01

Open Product

Go to any product in Medusa Admin. A new URibbon Product Content widget appears seamlessly in the sidebar.

Medusa Admin Sidebar
02

Select Parameters

Choose your target language (auto-populated from enabled store locales) and desired Brand voice profile.

Medusa Admin Sidebar
03

Generate & Review

Click "Generate with URibbon". A side-by-side preview shows the proposed title, subtitle, and rich description.

Medusa Admin Sidebar
04

Select & Apply

Check the fields you wish to accept and click "Apply to Product". Your Medusa product is instantly updated.

Medusa Admin Sidebar

Got Questions?

Frequently Asked Questions

Everything you need to know about integrating URibbon into your Medusa v2 store catalog.

Does this plugin overwrite my product content automatically?
No. The plugin is strictly opt-in and human-in-the-loop. Content is only applied when an admin user explicitly previews and approves it.
What Medusa versions are supported?
The plugin is built natively for Medusa v2 (tested and validated on Medusa 2.19+ and Node 20+ / 22+).
Can I use this for multi-store or multi-language setups?
Yes. The plugin dynamically queries your Medusa Store configuration for enabled locales and allows you to generate content in any of those languages.
What happens if another team member edits the product while I'm generating?
The plugin includes atomic version checking. If the product was updated in the background, the apply request will safely reject with a stale-content warning (409 Conflict), preventing accidental overrides.

Ready to supercharge your Medusa catalog?

Get your API key today and start generating conversion-focused, brand-grounded copy directly within your Medusa admin dashboard.