1. My Awesome App
  2. Help
  3. Publishing and Managing Releases

Publishing and Managing Releases

Learn how to publish releases, manage drafts, filter releases, and view your public releases page.

Publishing Your Release

Save as Draft

Before publishing, you can save your work as a draft:

  1. Click Save Draft in the release editor
  2. Your release will be saved but not visible to users
  3. You can continue editing later

Use drafts when:

  • You're still working on the content
  • You want to review before publishing
  • You're waiting for approval
  • You want to schedule publishing for later

Publish Immediately

To make your release visible to users right away:

  1. Click Publish in the release editor
  2. Your release will be immediately visible on your public releases page
  3. Users can now see and read your release notes

Before publishing, make sure:

  • ✅ All content is complete and accurate
  • ✅ Formatting looks good in preview
  • ✅ Features are added (if applicable)
  • ✅ Labels are correctly assigned

Unpublishing a Release

To hide a published release from users:

  1. Open the release menu (three dots) on the release card
  2. Click Unpublish
  3. The release will become a draft again

Note: Unpublishing doesn't delete the release. You can republish it later.

Managing Releases

Viewing Your Releases

The releases list shows all your releases with:

  • Title and Version: Quick identification
  • Status Badge: Published (green) or Draft (amber)
  • Labels: Visual indicators of release type
  • Excerpt Preview: First few lines of content
  • Date: Creation or publish date

Filtering Releases

Use the filter buttons at the top to view:

All Releases

Shows every release regardless of status. Use this to see everything at once.

Published

Shows only published releases visible to users. Useful for:

  • Reviewing what's currently live
  • Checking published content
  • Managing active releases

Drafts

Shows only draft releases. Useful for:

  • Finding work in progress
  • Completing unfinished releases
  • Reviewing before publishing

Editing a Release

You can edit any release at any time:

Method 1: From the List

  1. Click on a release card to view details
  2. Or click the menu (three dots) and select Edit
  3. The release editor will open

Method 2: From Detail Page

  1. Click on a release to view the detail page
  2. Use the edit option from there

Note: You can edit both published and draft releases. Changes to published releases are immediately visible.

Deleting a Release

To permanently delete a release:

  1. Click the menu (three dots) on a release
  2. Click Delete
  3. Confirm the deletion in the dialog

⚠️ Warning: This action cannot be undone. The release and all its features will be permanently deleted.

Viewing Public Releases

Public Releases Page

Published releases are automatically available on your public releases page. This is where your users see your release notes.

How to View

There are two ways to view your public releases page:

Method 1: From Overview Card

  1. On the Releases page, find the overview card
  2. Click the View → link next to "Public page"
  3. The page opens in a new tab

Method 2: From Release Menu

  1. Click the menu (three dots) on a published release
  2. Select View Public Page
  3. The page opens in a new tab

Public URL Format

Your public releases page URL follows this format:

/p/{organization-slug}/{project-slug}/releases

Individual release URLs:

/p/{organization-slug}/{project-slug}/releases/{release-slug}

What Users See

On the public page, users can:

  • Browse all published releases
  • Read full release notes
  • View highlighted features with media
  • See release dates and versions
  • Filter by labels (if implemented)

Release Status

Draft Status

Draft releases:

  • Are saved but not visible to users
  • Can be edited and published later
  • Appear with an amber "Draft" badge
  • Don't appear on the public page

Published Status

Published releases:

  • Are visible to all users
  • Appear on your public releases page
  • Show a green "Published" badge
  • Can be edited or unpublished
  • Include a publish date

Best Practices

Before Publishing

  • ✅ Review content for accuracy
  • ✅ Check formatting in preview mode
  • ✅ Verify all links work
  • ✅ Ensure images load correctly
  • ✅ Test on the public page

After Publishing

  • ✅ Monitor user feedback
  • ✅ Update if you find errors
  • ✅ Unpublish if major issues arise
  • ✅ Keep releases organized with labels

Organization

  • ✅ Use consistent version numbering
  • ✅ Keep drafts organized
  • ✅ Archive old releases if needed
  • ✅ Maintain a regular publishing schedule

Troubleshooting

Release Not Appearing on Public Page

If a release isn't showing:

  • Check it's published (not draft)
  • Verify the public page URL is correct
  • Clear browser cache
  • Check if there are any errors

Can't Edit a Release

If you can't edit:

  • Make sure you have proper permissions
  • Try refreshing the page
  • Check if the release was deleted

Next Steps

Now that you know how to publish and manage releases:

  • Review the overview for a complete picture
  • Learn about writing effective release notes
  • Explore adding highlighted features