Joystream · traumschule · Dec 9, 2025 · Dec 9, 2025 · Dec 9, 2025 · Dec 9, 2025
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -383,7 +383,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 - Mainnet network in the setting.
-- Documentation link to the [Joystream Handbook](https://joystream.gitbook.io/testnet-workspace) for each working group.
+- Documentation link to the [Joystream Handbook](https://handbook.joystream.org) for each working group.
 - Refresh auto-conf network button.
 - RPC blockheight and latest processed block in settings.
 
@@ -403,7 +403,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Fixed
 - Large election revealing stage (long term fix).
 - Recovering the stake locked when applying to an opening.
-- Some broken [Joystream Handbook](https://joystream.gitbook.io/testnet-workspace) links.
+- Some broken [Joystream Handbook](https://handbook.joystream.org) links.
 - Replace placeholder text on vesting tooltips.
 - Broken text on the insufficient funds modal.
 - Proposal discussion order.

diff --git a/packages/ui/README.md b/packages/ui/README.md
@@ -80,12 +80,12 @@ The application is divided to 4 types of building blocks (located in the `src` d
 * A domain/use-case specific:
   * `accounts` – domain of Polkadot's accounts handling, transferring tokens, balances, etc
   * `api` – domain containing Joystream's API specific code: hooks, providers, utilities, etc
-  * `council` – [council governance](https://joystream.gitbook.io/joystream-handbook/governance/council)
-  * `forum` - [forum subsystem](https://joystream.gitbook.io/joystream-handbook/subsystems/forum)
-  * `memberships` – [memberships management](https://joystream.gitbook.io/joystream-handbook/subsystems/membership)
+  * `council` – [council governance](https://handbook.joystream.org/system/council)
+  * `forum` - [forum subsystem](https://handbook.joystream.org/system/forum)
+  * `memberships` – [memberships management](https://handbook.joystream.org/system/memberships)
   * `working-groups`
-    – [working group governance](https://joystream.gitbook.io/joystream-handbook/governance/working-groups)
-  * `proposals` – [proposal system](https://joystream.gitbook.io/joystream-handbook/governance/proposals)
+    – [working group governance](https://handbook.joystream.org/system/working-groups)
+  * `proposals` – [proposal system](https://handbook.joystream.org/system/proposal-system)
   * `bounty`, `financials`, `overview`: are domains which are not available yet but coming soon.
   * `services` – Contains internationalization utilities.
 * `app` – Anything related to the application

diff --git a/packages/ui/src/accounts/modals/MoveFundsModal/MoveFundsModal.tsx b/packages/ui/src/accounts/modals/MoveFundsModal/MoveFundsModal.tsx
@@ -80,9 +80,7 @@ export const MoveFundsModal = () => {
               <>
                 Unfortunately, you don’t have any accounts suitable for {actionNameMapper(lock)}. You need at least{' '}
                 <TokenValue value={requiredStake} /> on the balances free from{' '}
-                <a href="https://joystream.gitbook.io/joystream-handbook/key-concepts/staking#locks-1">
-                  rivalrous locks.
-                </a>
+                <a href="https://handbook.joystream.org/system/accounts-and-staking#locks">rivalrous locks.</a>
               </>
             )}
           </TextMedium>

diff --git a/packages/ui/src/accounts/model/lockTypes.ts b/packages/ui/src/accounts/model/lockTypes.ts
@@ -5,7 +5,7 @@ import { BalanceLock, LockType, WorkerLocks, WorkerLockType } from '../types'
 
 // Mapping from:
 // - [/runtime/src/constants.rs:104](https://github.com/Joystream/joystream/blob/5a153fa18351a8fefd919a7d5230b911f180e13d/runtime/src/constants.rs#L104)
-// - and the [handbook](https://joystream.gitbook.io/joystream-handbook/key-concepts/staking#locks-1)
+// - and the [handbook](https://handbook.joystream.org/system/accounts-and-staking#locks)
 export const lockTypes: { [key: string]: LockType } = {
   ['staking ']: 'Staking',
   ['vesting ']: 'Vesting',

diff --git a/packages/ui/src/app/pages/Profile/MyAccounts.tsx b/packages/ui/src/app/pages/Profile/MyAccounts.tsx
@@ -25,7 +25,7 @@ const hints = {
   },
   locked: {
     title: 'Total locked balance',
-    tooltipLinkURL: 'https://joystream.gitbook.io/joystream-handbook/key-concepts/staking#locks',
+    tooltipLinkURL: 'https://handbook.joystream.org/system/accounts-and-staking#locks',
     tooltipText:
       'Staking, or bonding, is the act of locking up funds under some terms so that they are not transferable and otherwise not entirely usable as they otherwise would be. The terms, referred to as unstaking terms describe the circumstances under which the funds may begin to cease being staked. The way staking is implemented is with the use of account.',
   },

diff --git a/packages/ui/src/council/components/pastCouncil/PastCouncilStats.tsx b/packages/ui/src/council/components/pastCouncil/PastCouncilStats.tsx
@@ -26,7 +26,7 @@ export const PastCouncilStats = ({
       title="Total missed rewards"
       value={totalMissedRewards}
       tooltipText="Total rewards missed. Missed rewards are unallocated rewards from the council budget."
-      tooltipLinkURL="https://joystream.gitbook.io/testnet-workspace/system/council#budget"
+      tooltipLinkURL="https://handbook.joystream.org/system/council#budget"
     />
     <TokenValueStat
       title="Total paid rewards"
@@ -37,7 +37,7 @@ export const PastCouncilStats = ({
       title="Total spent on proposals"
       value={totalSpentOnProposals}
       tooltipText="Total council budget spent on proposals, including funding proposals. More details on proposals spending can be found in the Overview module."
-      tooltipLinkURL="https://joystream.gitbook.io/joystream-handbook/governance/council#council"
+      tooltipLinkURL="https://handbook.joystream.org/system/council"
     />
   </Statistics>
 )
diff --git a/packages/ui/src/memberships/modals/BuyMembershipModal/BuyMembershipFormModal.tsx b/packages/ui/src/memberships/modals/BuyMembershipModal/BuyMembershipFormModal.tsx
@@ -295,7 +295,7 @@ export const BuyMembershipForm = ({
               title="Creation fee:"
               value={membershipPrice?.toBn()}
               tooltipText="Creation fee is the price of membership, it is managed by council through the proposal system. It is inclusive of transaction fee."
-              tooltipLinkURL="https://joystream.gitbook.io/joystream-handbook/governance/proposals"
+              tooltipLinkURL="https://handbook.joystream.org/system/proposal-system#set-membership-price"
               tooltipLinkText="Learn more"
             />
           </TransactionInfoContainer>

diff --git a/packages/ui/src/proposals/components/StatisticsPreview/ProposalStatistics.tsx b/packages/ui/src/proposals/components/StatisticsPreview/ProposalStatistics.tsx
@@ -6,7 +6,7 @@ import { isDefined } from '@/common/utils'
 import { VoteCount } from '@/proposals/hooks/useVotingRounds'
 import { ProposalConstants } from '@/proposals/types'
 
-const tooltipLinkURL = 'https://joystream.gitbook.io/joystream-handbook/governance/proposals#concepts'
+const tooltipLinkURL = 'https://handbook.joystream.org/system/proposal-system#concepts'
 
 interface ProposalStatisticsProps {
   voteCount: VoteCount

diff --git a/packages/ui/src/proposals/modals/AddNewProposal/components/StakingAccountStep.tsx b/packages/ui/src/proposals/modals/AddNewProposal/components/StakingAccountStep.tsx
@@ -35,7 +35,7 @@ export const StakingAccountStep = ({ requiredStake }: StakingAccountStepProps) =
           <InputComponent
             label="Select account for Staking"
             tooltipText="The budget is the root resource pool for all token minting in the working group, and the size of the pool is denoted by budget."
-            tooltipLinkURL="https://joystream.gitbook.io/joystream-handbook/key-concepts/staking#locks-1"
+            tooltipLinkURL="https://handbook.joystream.org/system/accounts-and-staking#locks"
             tooltipLinkText="Learn more"
             inputSize={isMobile ? 'xxl' : 'l'}
             required