Public Page

Your public page is your music portfolio on the web at thelibrary.fm/pages/your-name. Unlike token-gated share links, a published page is designed to showcase selected work and let clients reach out about licensing.

Think of it as your online music storefront. A page is publicly available only while it is published; an unpublished page returns 404 unless the owner uses an authorized preview.

What You Need First

Before you can publish, two things must be in place:

A connected Dropbox account is required. Your public page streams audio directly from Dropbox, allowing visitors to listen to track previews without downloading files. If Dropbox isn’t connected, you won’t be able to publish — the publish button stays disabled until you complete the connection.

Basic profile information comes from your account settings. The public-page settings endpoint returns your name, bio, profile image, social links, and email separately from page-specific settings.

Setting Up Your Page

Navigate to Settings > Public Page to configure your portfolio. Here you can personalize how your page looks and decide what content appears.

Choosing Your Display Name

Your display name becomes your public URL: thelibrary.fm/pages/john-beats. Pick something memorable and professional — ideally your artist name or producer alias. Display names must be 3–50 characters and can only contain lowercase letters, numbers, and hyphens.

The display name must be unique across users. Check availability before publishing.

Customizing Appearance

Two options let you brand your page:

Banner image — Upload a wide landscape image that displays at the top of your page. This is your first impression, so choose something visually striking that represents your style.

Accent color — Pick a hex color code (like #3b82f6) that complements your brand. This color appears on play buttons, links, waveform players, and other interactive elements throughout your page.

Adding Content with Buckets

Your public page organizes music into bucket sections — each project bucket you add becomes a clickable section on your page. The section title is simply the bucket name, making it easy for visitors to understand what they’re browsing.

Selecting Buckets

In Settings > Public Page, click “Edit Buckets” to open the selector. You’ll see all your projects with their artwork and track counts. Check the boxes next to buckets you want to include, then save.

The renderer reads the selected bucket sections and their associated track groups. Across all selected sections, it exposes no more than 10 visible tracks in total; later sections can be empty when earlier sections use the limit.

Choosing Display Formats

Each bucket section supports two display modes:

Grid view shows album artwork in a compact grid. This works well for large catalogs where visitors want to scan many tracks quickly.

Cards view displays tracks as larger horizontal cards with more details visible — think of it like a refined playlist view. You can also choose card size (small, medium, or large) to control how much space each track takes up.

Section Order

The saved bucket-section array determines section order. The renderer preserves that order while applying the total 10-track visible cap.

Featuring Collaborators

Your public page can highlight the people you work with. In Settings > Public Page, click “Edit Collaborators” to choose which collaborators appear and whether to feature specific ones.

Featured collaborators get extra visibility in the configured collaborator section. The page renders the selected collaborator data and avatar fallback.

Previewing Before You Publish

Before sharing your URL with the world, use the owner-authorized preview mode. This is the only route that can render an unpublished page; a normal public request must not bypass the published-state check.

Check the rendered banner, accent color, profile/page data, bucket-section order, and 10-track visible cap. An authorized draft preview is render-only: visitor playback, checkout, contact, and other visitor actions are disabled.

Publishing Your Page

When you are satisfied with the page, click Publish in Settings > Public Page. A successful publish requires a display name, profile name, and valid Dropbox connection, then makes the page available at its unique URL.

You can unpublish at any time — this removes the page from public access while preserving the original published date and settings. Republish whenever you are ready to go live again.

The Visitor Experience

When someone visits your public page, they see a professional portfolio designed for music discovery:

Header area with your banner image, profile photo, name, and bio
Social links in a compact row below your bio
Bucket sections for each project you selected, showing your tracks
Waveform player for visitor-accessible tracks with playable bounces
Optional contact section when the page configuration enables it

Published pages are public. An unpublished page requires an authorized owner preview token, and that preview disables visitor actions.

Tips

Setting Up Your Public Page — Step-by-step configuration
Adding Content — Managing buckets and tracks
Visitor Experience — What clients see and can do
Preview & Publish — Going live with your page
Sharing Overview — Compare public pages with other sharing options