diff --git a/docs/authentication/group-sync.md b/docs/authentication/group-sync.md
index 29d7a64..b9eb2d6 100644
--- a/docs/authentication/group-sync.md
+++ b/docs/authentication/group-sync.md
@@ -5,7 +5,7 @@ hide_title: true
description: Automatically provision project memberships based on identity provider groups.
---
-# Manage project access with IdP groups
+# Manage project access with IdP groups
:::info
Group syncing is currently available on the self-hosted Commercial Edition and supports OIDC only. SAML and LDAP support is coming soon.
diff --git a/docs/core-concepts/projects/manage-project-members.md b/docs/core-concepts/projects/manage-project-members.md
index 741eb2b..ea264db 100644
--- a/docs/core-concepts/projects/manage-project-members.md
+++ b/docs/core-concepts/projects/manage-project-members.md
@@ -145,7 +145,7 @@ Users can become project members in two different ways, and understanding both h
Users can have both types of access simultaneously. When this happens, Plane automatically applies whichever role gives them higher permissions. For example, if someone is a `Guest` on your project but joins a linked teamspace, they're automatically upgraded to `Member` access. If they're already an `Admin`, they keep their `Admin` role.
-## View project member activity
+## View project member activity
::: info
The Enterprise plan is currently only available for self-hosted instances. If you're interested in Enterprise features for your self-hosted deployment, contact [sales@plane.so](mailto:sales@plane.so) for pricing and licensing information.
diff --git a/docs/workflows-and-approvals/workflows.md b/docs/workflows-and-approvals/workflows.md
index 9609d78..c845bda 100644
--- a/docs/workflows-and-approvals/workflows.md
+++ b/docs/workflows-and-approvals/workflows.md
@@ -1,19 +1,21 @@
---
title: Workflows to control work item state transitions
-description: Set up Workflows to control work item transitions, require approval from specific reviewers, and ensure work follows your team's established processes.
+description: Set up workflows to control how work items move through states, define transition rules, and require approvals before work progresses.
---
-# Control your work item transitions
+# Control how work items move
-Workflows give you control over how work items move through your process. Think of it as creating guardrails that ensure work follows your team's agreed-upon path, with the right people making decisions at each step.
+Workflows give you control over how work items move through states in your project. Think of it as creating guardrails that ensure work follows your team's agreed-upon path, with the right people making decisions at each step.
-This means you can:
+You define which transitions are allowed, who can make them, and whether certain moves need approval before they take effect.
-- Create clear paths for work items to follow.
-- Ensure important transitions are only made by the right team members.
-- Prevent work items from moving backward in your process unexpectedly.
-- Control which states can receive new work items.
+Every project has a single default workflow that applies to all work items regardless of type. On the Enterprise Grid, you can create additional workflows, each scoped to specific work item types, so different kinds of work can follow their own process.
+:::tip
+If you already had a workflow configured before, it's now your project's default workflow. All your existing transition rules and reviewer settings have been preserved. You can edit them at any time from the Workflows settings page.
+:::
+
+
+
+## Turn on workflows
+
+Head over to your [Project Settings](https://docs.plane.so/core-concepts/projects/overview#configure-project-settings) and select **Workflows** from the sidebar. Toggle **Enable workflows** on at the top of the page.
+
+Once enabled, you'll see your project's default workflow listed with **Default** and **Active** badges. This workflow is active by default and governs all work items in the project.
+
+
+
+The workflows list includes a search bar to find workflows by name. You can also filter the list by status (Active or Inactive) and by work item type, and sort it by name, date created, or date modified in ascending or descending order.
+
+## Define a workflow
+
+Whether you're editing the default workflow or a type-specific one, the workflow detail page works the same way. It lists all the states included in the workflow and lets you add flows that control how work items move between them.
+
+### Add states
+
+The default workflow includes all states configured in your project. When you create a new workflow, it starts empty. You choose which states to include by clicking **Add states** in the top-right corner of the "Define workflow" section. A panel lists all available project states grouped by category. Select the ones you need and click **Add selected**.
+
+
+
+### Allow new work items
+
+Each state has an **Allow new work items** toggle on the right side. When this is on, team members can create work items directly in that state. Turn it off for states that should only be reached through progression.
+
+
+
+### Add flows
-## Set up your workflow
+Flows define the rules for moving a work item from one state to another. To add a flow, expand a state by clicking its arrow, then click **+ Add flow**. A panel appears on the right where you choose the flow type - **Transition** or **Approval** - then click **Next** to configure it.
-Getting started with Workflows takes just a few minutes:
+You can add multiple flows to a single state, but they must all be the same type - either all transitions or all approvals.
-1. Head over to your [Project Settings](https://docs.plane.so/core-concepts/projects/overview#configure-project-settings) and select **Workflows** from the right pane.
+#### Transition flows
-2. You'll see all your workflow states listed. Each state represents a stage in your process (like "Backlog," "Todo," "In Progress").
+A transition flow defines a permitted state change. When you add one, you configure three fields:
-3. For each state, you'll notice a toggle labeled **Allow new work items**. This controls whether team members can create new items directly in this state. Toggle it off for states that should only be reached through progression (like "Ready to Publish").
+- **via** - shows **Transition** to indicate the flow type.
+- **move to** - the destination state. Click to select from available project states on the right pane.
+- **by** - who can make this transition. Defaults to **All**, meaning any project member. To restrict it, open the Members panel and select specific individuals.
- 
+
-4. Under the state, click **Add permitted state change** to define possible transitions.
- - When you click this option, a menu appears where you can select which states this work item can move to next. For example, from "Backlog," you might allow transitions to "Todo" or "Sprint Backlog".
+Click **Save** to confirm the flow, or **Discard** to cancel it.
- 
+#### Approval flows
- - Click **Add reviewers** to specify Members who are permitted to make this change. If you don't add any reviewers, any team member can move items to this state.
+An approval flow adds a gate: the work item won't move forward until designated approvers accept or reject it. When you add one, you configure:
- 
+- **via** - shows "Approval" to indicate the flow type.
+- **on approve, move to** - the state the item moves to when approved.
+- **on reject, move to** - the state the item falls back to when rejected.
+- **by** - who can approve or reject. Defaults to **All**, but you can restrict it to specific members.
-5. Add all the state transitions your team needs, building out your complete workflow.
+
-6. When everything looks good, click the **Live** toggle at the top right to activate your workflow.
+For example, you might add an approval flow on "Testing" so that moving to "Ready for Release" requires sign-off from a QA lead. If rejected, the item moves back to "In Development" for further work.
-7. The three-dot menu in the top-right provides additional options:
+### Activate the workflow
- 
- - **Reset workflow**
- Removes all your custom workflow settings
- - **View change history**
- See a log of modifications made to your workflow
+Once you've defined all the states and flows you need, toggle the workflow on from the Workflows settings page to make it active. You can toggle it off at any time to pause enforcement without losing your configuration.
+
+### Additional options
+
+The three-dot menu on each workflow provides three options:
+
+- **Edit** - update the workflow's name, description, or assigned work item types.
+- **View change history** - see a log of all modifications made to the workflow, including who made each change and when.
+- **Delete** - permanently remove the workflow. Work items previously governed by this workflow will fall back to the default workflow.
+
+## Create a custom workflow
+
+A custom workflow lets you define separate rules for different kinds of work. For example, you might want bug fixes to go through a stricter approval process than feature work, or you might want improvements to skip certain states entirely. When a work item matches a type-specific workflow, that workflow takes precedence over the default.
+
+To create one:
+
+1. On the Workflows settings page, click **Add new workflow**.
+
+2. Give the workflow a unique name and an optional description.
+
+3. Under **Select types**, choose one or more work item types that this workflow will govern.
+
+ 
+
+4. Click **Create**.
+
+You'll land on the workflow detail page, where you can [define its states and flows](#define-a-workflow).
## How workflows work
-Once your workflow is live, you'll notice some changes in how work items behave:
+Once a workflow is active, work items in the project follow its rules:
+
+**State creation restrictions**
+Items can only be created in states where **Allow new work items** is enabled. If a member tries to create a work item in a restricted state, they won't be able to.
+
+**Transition enforcement**
+Members can only move items along the transitions you've defined. If someone tries to make a state change that isn't permitted, they'll see a blocker message explaining why.
-- A special icon appears next to the state column, indicating a workflow is active.
+
- 
+**Approval gates**
+When a work item reaches a state with an approval flow, it enters a pending state. Approvers see **Approve** and **Reject** buttons at the top of the work item detail view. The item moves to the appropriate destination based on the approver's decision.
-- Items can only be created in states where "Allow new work items" is enabled.
-- Members will only be able to move items to the states you've permitted.
-- If someone tries to make a state change they're not authorized for, they'll see a blocker message.
+
- 
+**Workflow precedence**
+If a work item's type matches a type-specific workflow, that workflow's rules apply instead of the default. For example, if you have a type-specific workflow for bugs, any bug in the project follows that workflow's transition and approval rules. All other work item types continue to follow the default workflow.