Skip to main content

Migration Settings

Migrate your existing changelog from Headway, Beamer, GitHub, ReleaseNotes.io, or Noticeable into AnnounceKit.

If you're moving to AnnounceKit from another changelog tool, you don't have to start from a blank feed. AnnounceKit's Migration tool can import your existing posts so your release history stays intact.

What you can import


AnnounceKit currently supports importing posts from these sources:

  • Headway

  • Beamer

  • GitHub (release notes from a public repository)

  • ReleaseNotes.io

  • Noticeable

How to run a migration


  1. In the dashboard, open Settings > Migration.

  2. Pick the platform you want to migrate from.

  3. Paste the public URL of your existing changelog or release feed (see the per-source URL formats below).

  4. Start the import and wait for it to finish — the importer pulls each post and creates a corresponding draft post in your AnnounceKit project.

  5. Review the imported posts before publishing them.

Per-source URL formats


Use the public URL of your existing changelog. The exact format depends on the source:

Source

URL to paste

Headway

https://headwayapp.co/your-project — the public Headway page for your project.

Beamer

https://app.getbeamer.com/your-project or your custom Beamer changelog URL.

GitHub

https://github.com/owner/repo/releases — the public Releases page of a repository. The repo must be public so the importer can read it.

ReleaseNotes.io

Your public ReleaseNotes.io changelog URL (for example https://your-project.releasenotes.io).

Noticeable

Your public Noticeable newsfeed URL (for example https://your-project.noticeable.news).

What gets imported


For each source, the importer reads the publicly visible content and creates an AnnounceKit post for each entry. As a rule of thumb you can expect the following to come across:

  • Title of each post.

  • Body / description text. Basic formatting (paragraphs, lists, links) is preserved where possible.

  • Publish date from the source, when available.

Known limitations


Because the importer is reading public pages rather than connecting to private APIs on each platform, a few things do not migrate automatically:

  • Comments and reactions from the original platform are not imported.

  • Subscribers and email lists are not imported. You'll need to invite users to subscribe again from AnnounceKit.

  • Categories, labels, and tags may not map 1:1 onto AnnounceKit's Labels. Plan to recreate the labels you care about and re-tag posts after import.

  • Embedded images and media hosted on the source platform may need to be re-uploaded if they're served from URLs that expire or require authentication.

  • Private or unlisted posts on the source platform aren't visible to the importer and won't be migrated. Make the relevant posts public first, or recreate them manually.

  • Targeted / segmented posts are imported as standard public posts. Re-apply segmentation rules in AnnounceKit afterwards if you need targeting.

After the import — what to verify


Imported posts arrive as drafts. Before publishing, take a few minutes to:

  1. Open a few posts at random and confirm titles, bodies, and dates look right.

  2. Check images and links render correctly. Re-upload any image that didn't come through.

  3. Recreate labels in Labels and apply them to the imported posts as needed.

  4. Decide what to publish. You can publish posts in bulk, keep older ones as drafts for archival, or delete entries you don't want public.

  5. Set up redirects on your old changelog (if you control it) so existing links land on your new AnnounceKit feed.

Troubleshooting


  • The import returns no posts. Make sure the URL you pasted is the public changelog URL (not a dashboard or admin URL), and that the changelog is reachable without logging in.

  • Some posts are missing. Posts that were private, draft, or hidden on the source platform won't be visible to the importer. Make them public on the source first, then re-run the import.

  • Formatting looks off. Heavy custom HTML on the source can render differently in AnnounceKit. Edit the imported post and clean up any leftover markup.

  • You don't see your platform listed. If you're moving from a tool not listed above, reach out to support — we can usually help you get your existing posts into AnnounceKit by exporting from the source and importing manually.

Need a hand with your migration? Drop us a message in the chat and we'll walk through it with you.

Did this answer your question?