diff --git a/docs/Budgeting/jointaccounts.md b/docs/Budgeting/jointaccounts.md
new file mode 100644
index 0000000000..d76f10454e
--- /dev/null
+++ b/docs/Budgeting/jointaccounts.md
@@ -0,0 +1,46 @@
+---
+title: 'Strategies for handling joint accounts'
+---
+
+Situation:  I am using Actual to keep track of my budget and finances, but I share a joint account with my partner.
+
+## Basic setup steps
+1. Create an **on-budget** account used to pay joint bills.
+2. Create a **category group** used to group your shared expense categories.
+3. Create the **categories** you plan to budget using your joint account.
+4. **Optional:** Create an **Income Category** called **Partner Contribution** or something similar.  This will be explained further below.
+
+## Adding funds to the joint account
+
+### Your contribution
+
+Each month you will add a transfer of your share to the joint account from one of your on-budget accounts.  You don't need a category for your contribution since it is just a transfer from one of your accounts to another.  
+
+![](/img/jointaccount-2.png)
+
+### Partner contribution
+
+#### Option 1
+
+When your partner makes a contribution to the joint account, use the **Income Category** you created as the category.  By having a separate category for this contribution, it will be easier to filter out when doing reports later since this isn't true income, though it is income to the budget.  
+
+![](/img/jointaccount-3.png)
+
+#### Option 2
+
+If option 1 doesn't seem right to you, the same result could be achieved by treating the new income like a return to a store.  In this case, you can assign your partners deposit directly to the shared categories.  The deposit should be made into the **Joint Account** ledger.  As you can see, you can fund each shared category using the **split transaction** option.
+
+![](/img/jointaccount-5.png)
+
+## Budgeting
+
+### Option 1
+If you are entering the data for the joint account according to option 1, budget the whole amount for the bill.  The total budgeted of the shared expenses category group should equal the total amount available in the joint account.  The joint account and category group are loosely connected in this scenario.  There is no safeguard to prevent over budgeting for that account so you will need to monitor the balance of the account and the balance of the category group to be sure they are the same.
+
+![](/img/jointaccount-1.png)
+
+### Option 2
+
+If you've decided to fund the categories directly with the deposit, you only need to fund the budget categories for your portion of the shared expense.  As you can see, each of the budget categories is still funded to the same level but in this case there is no **income** that will show in reports.  The Joint account balance and budgeted amount should still be the same.
+
+![](/img/jointaccount-4.png)
\ No newline at end of file
diff --git a/sidebars.js b/sidebars.js
index fa0e46a2f4..1e298d7f8b 100644
--- a/sidebars.js
+++ b/sidebars.js
@@ -132,6 +132,7 @@ const sidebars = {
         'Budgeting/reconcile',
         'Budgeting/returnsandreimbursements',
         'Budgeting/creditcards',
+        'Budgeting/jointaccounts',
         //unavailable('Returns and Reimbursements'),
       ],
     },
diff --git a/static/img/jointaccount-1.png b/static/img/jointaccount-1.png
new file mode 100644
index 0000000000..5d8ab4558c
Binary files /dev/null and b/static/img/jointaccount-1.png differ
diff --git a/static/img/jointaccount-2.png b/static/img/jointaccount-2.png
new file mode 100644
index 0000000000..abee52a2db
Binary files /dev/null and b/static/img/jointaccount-2.png differ
diff --git a/static/img/jointaccount-3.png b/static/img/jointaccount-3.png
new file mode 100644
index 0000000000..6de5f74a08
Binary files /dev/null and b/static/img/jointaccount-3.png differ
diff --git a/static/img/jointaccount-4.png b/static/img/jointaccount-4.png
new file mode 100644
index 0000000000..c39e3606c8
Binary files /dev/null and b/static/img/jointaccount-4.png differ
diff --git a/static/img/jointaccount-5.png b/static/img/jointaccount-5.png
new file mode 100644
index 0000000000..eac5ba52cb
Binary files /dev/null and b/static/img/jointaccount-5.png differ