Sharing Briefs

Briefs are the primary way to share analysis with stakeholders. Share the story without exposing your underlying data.

Making a Brief Public

1. Open the brief in the editor
2. Click the Share button in the toolbar
3. Toggle Public on
4. Set a URL slug (e.g., q4-sales-analysis)
5. Optionally add a public title and description
6. Copy and share the link

Your brief is now live at:

marginfordata.com/@username/briefs/your-slug

What Viewers See

When someone opens your public brief:

Viewers see rendered outputs only—the polished results you chose to include.

URL Slugs

The slug is the URL-friendly identifier for your brief:

• Must be unique within your profile
• Can contain letters, numbers, and hyphens
• Keep it short and descriptive

Good examples:

• q4-2024-revenue
• customer-churn-analysis
• market-research-findings

Public Title and Description

Optionally customize what appears on your public profile:

• Public title – May differ from your working title
• Public description – Short summary for preview cards

If not set, the regular title is used.

Linked Notebooks

If your brief is linked to a notebook:

• Embedded artifacts come from that notebook
• The notebook itself remains private
• Viewers cannot access the notebook code

Revoking Access

To make a brief private again:

1. Open the brief editor
2. Click Share
3. Toggle Public off
4. Save

The public URL stops working immediately. Anyone with the link will see a 404.

Best Practices

1. Use descriptive slugs – q4-analysis is better than analysis1
2. Add descriptions – Help viewers understand what they'll find
3. Review before publishing – Check that all artifacts render correctly
4. Share selectively – Only make public what you want the world to see

Sharing from the Dashboard

You can also share briefs from the main Briefs list:

1. Find the brief in your list
2. Click the ⋮ menu
3. Select Copy share link (coming soon)

Next Steps

• Sharing datasets – Enable full reproducibility (Pro)
• Privacy model – Understand the security model