LinkBio in Mewayz

The LinkBio Add-On is a link-in-bio builder with referrer-aware theming, click analytics, and installable PWA bio pages.

Mewayz-original module — ported from seemless.link. No Mewayz upstream. Documentation authored from package source at packages/mewayz/LinkBio/.

Demo URL

Introduction

LinkBio is Mewayz's first-party link-in-bio builder — the same kind of single shareable public URL that creators put in their Instagram or TikTok bio. Each LinkBio page lists the operator's important links and content, themed to match their brand.

Unlike third-party tools, LinkBio detects **where the visitor came from** (Instagram, TikTok, Twitter/X, etc.) and serves a theme tailored to that platform automatically. A click from Instagram gets an Instagram-style layout; a click from TikTok gets a TikTok- style layout — without the operator having to build multiple landing pages.

The module also includes per-link click analytics, a template gallery, dynamic OG card generation for nice social previews, and optional PWA support so a fan can "install" the bio page on their phone home screen.

How To Install The Add-On?

To Set Up the LinkBio Add-On, you can follow this link: Setup Add-On.

The Add-On is gated by PlanModuleCheck:LinkBio. Activate it on the operator's plan or per-tenant via the Add-Ons admin page.

Page Management

Browse Pages

• Navigate to LinkBio in the sidebar.
• The list view shows all link-in-bio pages the operator has

created, with link count, view count, and active/inactive status.

Create a New Page

• Click + New Page to open the create form.
• Fields:
• Slug — The path segment of your public URL (2–50 chars,

lowercase letters, numbers, hyphens). A live "check-slug" call validates availability as you type. Reserved slugs (admin, api, login, dashboard, link-bio, etc.) are blocked.

• Title — Display name on the public page (your name or brand)
• Bio — Short description shown under the title
• Click Save to create the page. You are then redirected to the

editor.

Edit a Page

The editor at /link-bio/{id}/edit is the main workspace.

Profile Section

• Avatar — Profile image shown at the top of the public page
• Background — Solid color, gradient, or uploaded image
• Theme preset — Pick from the included themes
• Theme overrides — Optional JSON for advanced color tweaks

Social Links

• Add Twitter / X, Instagram, TikTok, YouTube, LinkedIn, GitHub, and

custom platforms. Each gets an icon and target URL.

SEO

• Custom title and description for search engines + OG previews
• Custom OG image (or use the auto-generated one)

Contact

• Email, phone, address shown in the contact section

PWA Settings

• Toggle PWA enabled to allow visitors to install the bio as an

app on their phone home screen.

• Customize the app name, theme color, and short name.

Custom Domain

• Optionally serve the bio at a custom domain (e.g. myname.link)

instead of the platform slug URL.

QR Config

• The page can render its own QR code for offline distribution

(business cards, posters). Customize foreground/background colors and dot styles here.

Add Links

Inside the page editor, the Links panel lets you add:

• Link — Standard outbound URL (auto-prepends https:// if you

forget the scheme). If you paste a URL, LinkBio fetches the page's OG image and offers it as the thumbnail.

• Social — Icon-only social platform link (shown as a row of

icons rather than a button)

• Header — A section header that visually groups the links below
• Divider — A horizontal rule
• Embed — Inline embeds (YouTube, Spotify, etc.)
• Video — Direct video player
• Music — Music player
• Email — mailto: link with subject prefill
• Phone — tel: link

Reorder Links

Drag any link to reorder. The new order is persisted via POST /link-bio/links/reorder with a JSON array of link IDs in their new order.

Activate / Deactivate Links

Each link has an active toggle. Inactive links are hidden from the public page but kept in the editor — handy for seasonal promotions.

Public Page

Visitors hit the page at https://app.mewayz.com/{slug} (or the configured custom domain).

The public surface:

• Renders SEO-friendly meta tags + JSON-LD schema (Person /

Organization, with social links) for rich search results

• Auto-detects the referrer platform from the HTTP Referer

header and the fbclid query param, and applies the platform's theme on top of the operator's theme preset

• Increments view_count on every page load and records an analytic

row (page_view event) with platform, device, and referrer

• Serves a PWA manifest at /{slug}/manifest.json if PWA is

enabled

• Serves a dynamic OG card at /{slug}/og.png (1200×630),

cached by a hash of the page's title, bio, avatar, and brand color — so social previews stay sharp and unique

Click Tracking

When a visitor clicks a link, the front-end POSTs to /track with the page ID, link ID, platform, device, and referrer. The link's click_count is incremented; the analytic row is recorded fire-and- forget (failures never block the visitor's navigation).

Analytics

• Navigate to a page in your list and click Analytics.
• The default 30-day view shows:
• Total page views vs. unique link clicks
• Daily breakdown — Line chart by day
• Top 10 links — Most-clicked outbound URLs
• Platform breakdown — Where your traffic comes from (IG vs.

TT vs. Twitter vs. direct)

• Device breakdown — Desktop vs. mobile vs. tablet

Templates Gallery

• Navigate to LinkBio → Templates.
• Browse the included starter pages (designed for common

industries: creator, restaurant, agency, etc.).

• Click Clone on any template to copy it into your own pages

with a freshly-generated unique slug. Edit from there.

Database Tables

The package adds three tables:

• link_bio_pages — One row per bio page
• link_bio_links — Many rows per page (the actual links)
• link_bio_analytics — One row per tracked event (page view or

link click)

Operator Notes

• The slug must be unique platform-wide. The live check-slug

endpoint is what powers the "this slug is available" indicator.

• OG image cache invalidates automatically when any of the

hashed inputs change (title, bio, avatar, brand color), so a refresh after edit is reflected in social previews.

• Referrer detection has a ?seemless=<platform> override for

preview testing — pass it to force-render the theme for a specific platform.

• Free-tier badge — Pages on the free tier display a small

"Powered by Mewayz" badge at the bottom; the badge link carries UTM params for referral attribution. Paid plans hide the badge.

• Analytic recording is fire-and-forget — if the analytics

table is unavailable, the public page still renders normally.