Medium Import Guide for BuildTales

This guide provides step-by-step instructions for importing BuildTales articles to Medium using the new clean permalink structure.

New URL Structure

All articles now use clean, Medium-friendly URLs:

Before (Old URLs):

After (New URLs):

Article Permalink Mapping

ACH Series

Payments Series

Systems Series

Leadership Series

Tools Series

Crypto Series

Import Process

1. Prepare Articles for Medium

Each article should include:

2. Medium Import Settings

Canonical URL: Set to the new BuildTales permalink Import Source: BuildTales.dev Author: Suma Manjunath Publication: Your Medium publication (if applicable)

3. Content Formatting

4. SEO Optimization

Redirect Verification

After deployment, verify that all old URLs redirect properly:

# Test redirects locally
curl -I "http://localhost:4000/fintech/payments/2025/08/13/money-flow-bank-account.html"
# Should return 301 redirect to /money-flow-bank-account/

# Test new URLs
curl -I "http://localhost:4000/money-flow-bank-account/"
# Should return 200 OK

Benefits of New Structure

  1. Medium-Friendly: Clean URLs that work well with Medium’s import system
  2. SEO Optimized: Shorter, more memorable URLs
  3. Redirects Preserved: All existing links continue to work
  4. Consistent Format: Uniform structure across all articles
  5. Easy Maintenance: Simple to manage and update

Troubleshooting

Common Issues

  1. Redirects Not Working: Ensure _redirects file is included in build
  2. Jekyll Build Errors: Check for malformed front matter
  3. Missing Articles: Verify all articles have permalink front matter
  4. Medium Import Failures: Check canonical URLs and content formatting

Support

For issues with:

Next Steps

  1. Test Locally: Run bundle exec jekyll serve to verify changes
  2. Deploy: Push changes to production
  3. Verify Redirects: Test old URLs redirect to new ones
  4. Import to Medium: Use new permalinks for Medium import
  5. Monitor: Check analytics for any broken links

File Structure

buildtales/
├── _config.yml          # Updated permalink configuration
├── _redirects           # Comprehensive redirect rules
├── _posts/              # Articles with permalink front matter
├── add_permalinks.py    # Script to add permalinks (can be removed after use)
└── MEDIUM_IMPORT_GUIDE.md # This guide

All articles now have clean, Medium-friendly URLs while maintaining full backward compatibility through redirects.