diff --git a/CHANGELOG.rst b/CHANGELOG.rst
new file mode 100644
index 0000000..23e11a2
--- /dev/null
+++ b/CHANGELOG.rst
@@ -0,0 +1,36 @@
+Changelog
+=========
+
+All notable changes to this project will be documented in this file.
+
+Unreleased
+----------
+
+PayPal Integration
+~~~~~~~~~~~~~~~~~~
+
+* Added PayPal as a payment processor alongside Stripe and crypto payments
+* New models: ``PayPalPayment`` and ``PayPalUserShop`` for tracking PayPal transactions
+* Shop settings now include PayPal client ID and secret configuration
+* Checkout page supports PayPal payment option when enabled
+* Added PayPal saved payment methods (vault) support
+* Added ``/billing/disconnect-paypal`` route for users to manage saved PayPal
+* See ``docs/CHANGES_PAYPAL.md`` for detailed implementation notes
+
+CSS Grid Lanes
+~~~~~~~~~~~~~~
+
+* Added toggleable CSS Grid Lanes (masonry layout) setting per shop
+* New ``grid_lanes_enabled`` column on Shop model
+
+Video Thumbnails
+~~~~~~~~~~~~~~~~
+
+* Added play button overlay on video thumbnails for unlocked content
+* Styled video play overlay with red tint and click-to-play text
+
+Meta Tags
+~~~~~~~~~
+
+* Added Twitter card meta tags for proper link unfurling on Matrix/Discord
+* Increased meta description truncation to 500 chars
diff --git a/README.rst b/README.rst
index a36cc08..ac3b545 100644
--- a/README.rst
+++ b/README.rst
@@ -3,7 +3,7 @@ Make Post Sell
 
 The `Make Post Sell <https://www.makepostsell.com>`_ monolith platform service.
 
-You can use the SaaS or self-host! Accepts credit cards, Monero (XMR), and Dogecoin (DOGE) crypto payments.
+You can use the SaaS or self-host! Accepts credit cards (Stripe), PayPal, Monero (XMR), and Dogecoin (DOGE) payments.
 
 Our `blog acts as our user guide <https://blog.makepostsell.com/>`_ & also uses ``make_post_sell``!
 
diff --git a/CHANGES_PAYPAL.md b/docs/CHANGES_PAYPAL.md
similarity index 100%
rename from CHANGES_PAYPAL.md
rename to docs/CHANGES_PAYPAL.md