For Developers
Soulwell Mediaframe
Enable rich content previews for links shared within the Soulwell ecosystem.
Overview
Soulwell Mediaframe is a metadata system that allows you to control how your content is displayed when shared on Soulwell Pulse. By adding a few simple meta tags to your web pages, you can create rich, engaging previews.
When a URL is shared, our system checks for soulwell: tags first. If they're not found, we fall back to standard Open Graph tags. This ensures your content always looks its best.
Meta Tag Reference
Add these tags to the
<head> of your HTML file.soulwell:allow
Controls whether Soulwell can retrieve metadata.
<meta name="soulwell:allow" content="true" />soulwell:type
Defines the preview type. Supported: image, video, link.
<meta name="soulwell:type" content="image" />soulwell:site
Associates a Soulwell profile with the content.
<meta name="soulwell:site" content="@username" />soulwell:title
The title of your content.
<meta name="soulwell:title" content="Example Title" />soulwell:description
A brief description of your content.
<meta name="soulwell:description" content="Example description here." />soulwell:image
URL for the preview image.
<meta name="soulwell:image" content="https://example.com/image.jpg" />soulwell:video
URL for an embeddable video player.
<meta name="soulwell:video" content="https://example.com/embed/video" />AI-Powered Tag Generator
Enter a URL to automatically generate suggested Soulwell Mediaframe tags based on the page content.
Domain Approval (Placeholder)
In a future release, full Mediaframe support will be limited to approved domains to ensure content quality and security. A domain management tool will be available here.