From c741ef74431e8a618b352bea6e92ca16e9e88311 Mon Sep 17 00:00:00 2001 From: sue-arkin Date: Mon, 10 Aug 2026 10:38:58 +0100 Subject: [PATCH 01/10] For older versions With a link to 1.20 docs, since linking within the same version will no longer include installation instructions --- Packages/com.unity.inputsystem/Documentation~/index.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/Packages/com.unity.inputsystem/Documentation~/index.md b/Packages/com.unity.inputsystem/Documentation~/index.md index 64cd72adc1..8663ab8489 100644 --- a/Packages/com.unity.inputsystem/Documentation~/index.md +++ b/Packages/com.unity.inputsystem/Documentation~/index.md @@ -12,7 +12,9 @@ Unity supports input through two separate systems, one older, and one newer. The older system, which is built-in to the editor, is called the [Input Manager](https://docs.unity3d.com/Manual/class-InputManager.html). The Input Manager is part of the core Unity platform and is the default, if you do not install the Input System package. -This **Input System package** is a newer, more flexible system, which allows you to use any kind of Input Device to control your Unity content. It's intended to be a replacement for Unity's classic Input Manager. It is referred to as the "Input" System Package, or just **The Input System**. To use it, you must [install it into your project using the Package Manager](Installation.md). +This **Input System package** is a newer, more flexible system, which allows you to use any kind of Input Device to control your Unity content. It's intended to be a replacement for Unity's classic Input Manager. It is referred to as the "Input" System Package, or just **The Input System**. + +The Unity Editor 6.7 and newer includes the Input System package by default. For older versions of the Editor, please install the package [using the Package Manager](https://docs.unity3d.com/Packages/com.unity.inputsystem@1.20/manual/Installation.html). > [!TIP] > During the installation process for the **Input System** package, the installer offers to automatically deactivate the older built-in system. From fed85a790ade4849fe3aeca4c96d566a5a838558 Mon Sep 17 00:00:00 2001 From: sue-arkin Date: Mon, 10 Aug 2026 10:48:35 +0100 Subject: [PATCH 02/10] Index.md updated for 6.7 --- .../com.unity.inputsystem/Documentation~/index.md | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) diff --git a/Packages/com.unity.inputsystem/Documentation~/index.md b/Packages/com.unity.inputsystem/Documentation~/index.md index 8663ab8489..ad43d0a48f 100644 --- a/Packages/com.unity.inputsystem/Documentation~/index.md +++ b/Packages/com.unity.inputsystem/Documentation~/index.md @@ -10,22 +10,21 @@ The **Input System** allows your users to control your game or app using a devic Unity supports input through two separate systems, one older, and one newer. -The older system, which is built-in to the editor, is called the [Input Manager](https://docs.unity3d.com/Manual/class-InputManager.html). The Input Manager is part of the core Unity platform and is the default, if you do not install the Input System package. - -This **Input System package** is a newer, more flexible system, which allows you to use any kind of Input Device to control your Unity content. It's intended to be a replacement for Unity's classic Input Manager. It is referred to as the "Input" System Package, or just **The Input System**. +- The [Input Manager](https://docs.unity3d.com/Manual/class-InputManager.html), documented in the main Unity manual. This system is available for backward compatibility. For new projects, use the Input System. +- The Input System package described in this documentation. This is a more flexible system than the Input Manager, supporting The Unity Editor 6.7 and newer includes the Input System package by default. For older versions of the Editor, please install the package [using the Package Manager](https://docs.unity3d.com/Packages/com.unity.inputsystem@1.20/manual/Installation.html). > [!TIP] > During the installation process for the **Input System** package, the installer offers to automatically deactivate the older built-in system. -To get started, refer to the [Workflows](workflows.md) section to decide how to use Input: +To get started, refer to the [Workflows](workflows.md) section to decide how to use the Input System: -* Using actions, which is the recommended workflow. -* Using both actions and the PlayerInput component, which provides features for callbacks and multiplayer. -* Directly read device states with a script for fast prototyping or single-platform applications. +- Using actions, which is the recommended workflow. +- Using both actions and the PlayerInput component, which provides features for callbacks and multiplayer. +- Directly read device states with a script for fast prototyping or single-platform applications. For a demo project, refer to the [Warriors demo](https://github.com/UnityTechnologies/InputSystem_Warriors) on GitHub. ![Screenshot of the Input Actions Editor window displaying the default action map, Actions, and Action Properties. They are displayed in 3 columns side-by-side in that order.](Images/ActionsEditor.png)
-*The Input Actions Editor, displaying some of the default actions that come pre-configured with the Input System package.* +*The Input Actions Editor, displaying several default actions from the Input System package.* From 1d5ef195e56d40ca905cc082d8fc3fab233d277f Mon Sep 17 00:00:00 2001 From: sue-arkin Date: Mon, 10 Aug 2026 10:53:53 +0100 Subject: [PATCH 03/10] Installation still sometimes needed --- Packages/com.unity.inputsystem/Documentation~/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Packages/com.unity.inputsystem/Documentation~/index.md b/Packages/com.unity.inputsystem/Documentation~/index.md index ad43d0a48f..60773b0236 100644 --- a/Packages/com.unity.inputsystem/Documentation~/index.md +++ b/Packages/com.unity.inputsystem/Documentation~/index.md @@ -13,7 +13,7 @@ Unity supports input through two separate systems, one older, and one newer. - The [Input Manager](https://docs.unity3d.com/Manual/class-InputManager.html), documented in the main Unity manual. This system is available for backward compatibility. For new projects, use the Input System. - The Input System package described in this documentation. This is a more flexible system than the Input Manager, supporting -The Unity Editor 6.7 and newer includes the Input System package by default. For older versions of the Editor, please install the package [using the Package Manager](https://docs.unity3d.com/Packages/com.unity.inputsystem@1.20/manual/Installation.html). +The Unity Editor 6.7 and newer installs the Input System package for projects created from a template. For empty projects and for older versions of the Editor, please install the package [using the Package Manager](Installation.md). > [!TIP] > During the installation process for the **Input System** package, the installer offers to automatically deactivate the older built-in system. From 7e9a51e79f99c4488577ffe94a8bc9ab4b2ca41e Mon Sep 17 00:00:00 2001 From: sue-arkin Date: Mon, 10 Aug 2026 10:54:58 +0100 Subject: [PATCH 04/10] Small fix --- Packages/com.unity.inputsystem/Documentation~/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Packages/com.unity.inputsystem/Documentation~/index.md b/Packages/com.unity.inputsystem/Documentation~/index.md index 60773b0236..907a668a2b 100644 --- a/Packages/com.unity.inputsystem/Documentation~/index.md +++ b/Packages/com.unity.inputsystem/Documentation~/index.md @@ -8,7 +8,7 @@ The **Input System** allows your users to control your game or app using a devic ## Introduction -Unity supports input through two separate systems, one older, and one newer. +Unity supports input through two systems: - The [Input Manager](https://docs.unity3d.com/Manual/class-InputManager.html), documented in the main Unity manual. This system is available for backward compatibility. For new projects, use the Input System. - The Input System package described in this documentation. This is a more flexible system than the Input Manager, supporting From d2afb094ee3cc3c891baed5824b4400fc5528c74 Mon Sep 17 00:00:00 2001 From: sue-arkin Date: Wed, 12 Aug 2026 08:06:40 +0100 Subject: [PATCH 05/10] Pre-enduser-docs --- .../Documentation~/Installation.md | 64 +++++++++---------- 1 file changed, 30 insertions(+), 34 deletions(-) diff --git a/Packages/com.unity.inputsystem/Documentation~/Installation.md b/Packages/com.unity.inputsystem/Documentation~/Installation.md index ee5d834923..1aab95ad32 100644 --- a/Packages/com.unity.inputsystem/Documentation~/Installation.md +++ b/Packages/com.unity.inputsystem/Documentation~/Installation.md @@ -5,54 +5,50 @@ uid: input-system-installation This page describes how to install and activate the **Input System** package for your Unity Project. -> [!NOTE] -> This version of the new Input System requires the .NET 4 runtime. It doesn't work in projects using the old .NET 3.5 runtime. -> -> This package is only compatible with Unity Editor release versions 2021.3 and later. If you are working in a release version of the Editor prior to 2021.3, you need to use the package version that works with that version of the Editor, indicated by the **Release** tag in the [Unity Package Manager](https://docs.unity3d.com/Manual/upm-ui.html) window. - ## Install the package -To install the new Input System: - -1. In the main menu of the Unity Editor, go to __Window__ > __Package Manager__ to open the Unity Package Manager. - -2. Select **Unity Registry** from the navigation panel. - -3. Select the __Input System__ package from the list. - - The Package Manager automatically selects that version to install by default. - -4. Select __Install__, follow any prompts to [enable the backends](#) for the new Input System. +From Unity 6.7, Input System is automatically included for new projects from templates. -This package also provides several samples that demonstrate how to work with the new Input System, which are also available on the [Unity Package Manager](https://docs.unity3d.com/Manual/upm-ui.html) window. Refer to [Install samples](#install-samples). +If you've created an empty project, or are upgrading an existing project's input, install the Input System package: -## Enable the new input backends +1. Go to **Main Menu** > **Window** > **Package Manager**. +1. Go to **Unity Registry**. +1. From the package list, select **Input System**. +1. Select **Install**. +1. Follow any prompts to [enable the backends](#enable-the-new-input-backends). -By default, Unity's classic Input Manager (`UnityEngine.Input`) is active, and support for the new Input System is inactive. This allows existing Unity Projects to keep working as they are. +## Select a back end -When you install the Input System package, Unity will ask whether you want to enable the new backends. Click **Yes** to enable the new backends and disable the old backends. The Editor restarts during this process. +The Unity Editor has two back end options: -![Editor Restart Warning](Images/EditorRestartWarning.png) +- The legacy Input Manager for backwards compatibility. +- The Input System package for new or upgraded projects. -You can find the corresponding setting in __Edit__ > __Project Settings__ > __Player__ > __Other Settings__ > __Active Input Handling__. If you change this setting you must restart the Editor for it to take effect. +When you install the Input System package in your project, Unity will ask whether you want to enable the new backends. Click **Yes** to enable the new backends and disable the old backends. The Editor restarts to complete the change. -> [!NOTE] -> You can enable __both__ the old __and__ the new system at the same time. To do so, set **Active Input Handling** to **Both**. +To manually select a back end: -![Active Input Handling](Images/ActiveInputHandling.png) +1. Go to **Project Settings** > **Player** > **Other Settings**. +1. In **Active Input Handling**, select a back end: + - Input Manager (Old). Builds have the `ENABLE_LEGACY_INPUT_MANAGER=1` C# `#define`. + - Input System Package (New). Builds have the `ENABLE_INPUT_SYSTEM=1` C# `#define`. + - Both. Builds have both of the C# `#define`. +1. The Editor restarts with a new back end. -When the new input backends are enabled, the `ENABLE_INPUT_SYSTEM=1` C# `#define` is added to builds. Similarly, when the old input backends are enabled, the `ENABLE_LEGACY_INPUT_MANAGER=1` C# `#define` is added. Because both can be enabled at the same time, it is possible for __both__ defines to be 1 at the same time. +## Compatibility notes for existing projects -## Install samples +Before upgrading existing projects to use Input System, please ensure: -The package comes with a number of samples. You can install these directly from the Package Manager window in Unity (__Window > Package Manager__). +* You're using .NET 4 runtime or newer. +* You're using an Editor version of 2021.3 or newer. For older versions, match the package version to the Editor version as indicated by the **Release** tag in the [Unity Package Manager](https://docs.unity3d.com/Manual/upm-ui.html) window. -To view the list of samples: +## Samples and demos -1. Select the package in the **Package Manager** window. -1. Select the __Samples__ tab. -1. Select __Import__ next to any sample name to import that sample into the current project. +The Input System package includes several samples. To import a sample into your project: -![Install Samples](Images/InstallSamples.png) +1. Go to the **Package Manager** window. +1. Select the Input System package. +1. Go to the **Samples** tab. +1. To import a sample, select **Import** next to its name. -For a more comprehensive demo project for the Input System, refer to the [InputSystem_Warriors](https://github.com/UnityTechnologies/InputSystem_Warriors) GitHub repository. +For a more comprehensive demo, use the [Warriors](https://github.com/UnityTechnologies/InputSystem_Warriors) project. \ No newline at end of file From 9a724a1237d65a2164d57f0c9a5b484d645061ee Mon Sep 17 00:00:00 2001 From: sue-arkin Date: Wed, 12 Aug 2026 08:40:41 +0100 Subject: [PATCH 06/10] Finishing up --- .../Documentation~/HowDoI.md | 4 +- .../Documentation~/Installation.md | 57 +++++++++++-------- .../Documentation~/TableOfContents.md | 4 +- .../about-responding-to-input.md | 2 +- .../enable-correct-input-system.md | 2 +- .../Documentation~/index.md | 2 +- .../introduction-virtual-mouse.md | 2 +- .../migrate-from-old-input-system.md | 2 +- .../Documentation~/optimize-controls.md | 2 +- .../Documentation~/quick-start-guide.md | 4 +- ...mobile-device-input-editor-unity-remote.md | 2 +- .../Documentation~/visualizers.md | 2 +- 12 files changed, 46 insertions(+), 39 deletions(-) diff --git a/Packages/com.unity.inputsystem/Documentation~/HowDoI.md b/Packages/com.unity.inputsystem/Documentation~/HowDoI.md index 03ee37af22..230c2907c6 100644 --- a/Packages/com.unity.inputsystem/Documentation~/HowDoI.md +++ b/Packages/com.unity.inputsystem/Documentation~/HowDoI.md @@ -7,7 +7,7 @@ A collection of frequently asked questions, and where to find their answers in t > **Note:** > -> If you're new to the Input System and have landed on this page looking for documentation, it's best to read the [QuickStart Guide](quick-start-guide.md), and the [Concepts](understanding-input.md) and [Workflows](workflows.md) pages, so that you can make sure you're choosing the best workflow for your project's input requirements. +> If you're new to the Input System and have landed on this page looking for documentation, it's best to read the [QuickStart Guide](quick-start-guide.md), and the [Concepts](understanding-input.md) and [Workflows](Workflows.md) pages, so that you can make sure you're choosing the best workflow for your project's input requirements. > > This is because there are a number of different ways to read input using the Input System, and many of the answers on this page give you the quickest but least flexible solution, and may not be suitable for a project with more complex requirements. @@ -27,7 +27,7 @@ How do I...? - [create my own custom devices?](hid-create-custom-layout.md) - create a simple "Fire" type action?
-Use the same techniques shown for the "Jump" action in the [Workflows section](workflows.md) +Use the same techniques shown for the "Jump" action in the [Workflows section](Workflows.md) - [require a button to be held down for some duration before triggering an action?](built-in-interactions.md#hold) diff --git a/Packages/com.unity.inputsystem/Documentation~/Installation.md b/Packages/com.unity.inputsystem/Documentation~/Installation.md index 1aab95ad32..0708e55589 100644 --- a/Packages/com.unity.inputsystem/Documentation~/Installation.md +++ b/Packages/com.unity.inputsystem/Documentation~/Installation.md @@ -1,54 +1,61 @@ --- uid: input-system-installation --- -# Installation guide +# Install the Input System package -This page describes how to install and activate the **Input System** package for your Unity Project. +Install the Input System package and enable the input back end for your project. + +## Compatibility notes for existing projects + +Before you upgrade an existing project, check the following requirements: + +- You're using .NET 4 runtime or newer. +- You're using an Editor version of 2021.3 or newer. For older versions, match the package version to the Editor version as indicated by the **Release** tag in the [Unity Package Manager](https://docs.unity3d.com/Manual/upm-ui.html) window. ## Install the package -From Unity 6.7, Input System is automatically included for new projects from templates. +Unity 6.7 and later include the Input System package in projects created from templates. If you've created an empty project, or are upgrading an existing project's input, install the Input System package: -1. Go to **Main Menu** > **Window** > **Package Manager**. -1. Go to **Unity Registry**. +1. In the main menu, go to **Window** > **Package Manager**. +1. Go to **Unity Registry**. 1. From the package list, select **Input System**. 1. Select **Install**. -1. Follow any prompts to [enable the backends](#enable-the-new-input-backends). +1. Follow any prompts to [enable the backends](#select-a-back-end). ## Select a back end -The Unity Editor has two back end options: +The Unity Editor has two back end options: -- The legacy Input Manager for backwards compatibility. +- The Input Manager for backwards compatibility. - The Input System package for new or upgraded projects. -When you install the Input System package in your project, Unity will ask whether you want to enable the new backends. Click **Yes** to enable the new backends and disable the old backends. The Editor restarts to complete the change. +When you install the Input System package in your project, Unity asks whether to enable the Input System back ends. Select **Yes** to enable the Input System back ends and disable the Input Manager back ends. The Editor restarts to complete the change. To manually select a back end: -1. Go to **Project Settings** > **Player** > **Other Settings**. -1. In **Active Input Handling**, select a back end: - - Input Manager (Old). Builds have the `ENABLE_LEGACY_INPUT_MANAGER=1` C# `#define`. - - Input System Package (New). Builds have the `ENABLE_INPUT_SYSTEM=1` C# `#define`. - - Both. Builds have both of the C# `#define`. -1. The Editor restarts with a new back end. +1. In the main menu, go to **Edit** > **Project Settings** > **Player**. +1. In the **Other Settings** section, set **Active Input Handling** to select a back end: + - Input Manager (Old): Builds have the `ENABLE_LEGACY_INPUT_MANAGER=1` C# `#define`. + - Input System Package (New): Builds have the `ENABLE_INPUT_SYSTEM=1` C# `#define`. + - Both: Builds have both of the C# `#define`. -## Compatibility notes for existing projects +The Editor restarts with a new back end. -Before upgrading existing projects to use Input System, please ensure: - -* You're using .NET 4 runtime or newer. -* You're using an Editor version of 2021.3 or newer. For older versions, match the package version to the Editor version as indicated by the **Release** tag in the [Unity Package Manager](https://docs.unity3d.com/Manual/upm-ui.html) window. - -## Samples and demos +## Import samples and demos The Input System package includes several samples. To import a sample into your project: -1. Go to the **Package Manager** window. +1. Go to **Window** > **Package Manager**. 1. Select the Input System package. -1. Go to the **Samples** tab. +1. Select **Samples**. 1. To import a sample, select **Import** next to its name. -For a more comprehensive demo, use the [Warriors](https://github.com/UnityTechnologies/InputSystem_Warriors) project. \ No newline at end of file +For a more comprehensive demo, use the [Warriors](https://github.com/UnityTechnologies/InputSystem_Warriors) project. + +## Additional resources + +* [Quickstart guide](quick-start-guide.md) +* [Migrate from the old input system](migrate-from-old-input-system.md) +* [Input System workflows](Workflows.md) \ No newline at end of file diff --git a/Packages/com.unity.inputsystem/Documentation~/TableOfContents.md b/Packages/com.unity.inputsystem/Documentation~/TableOfContents.md index 4fcdfcfb58..873e546d0c 100644 --- a/Packages/com.unity.inputsystem/Documentation~/TableOfContents.md +++ b/Packages/com.unity.inputsystem/Documentation~/TableOfContents.md @@ -1,7 +1,7 @@ * [Introduction](index.md) - * [Installation](Installation.md) + * [Install the Input System package](Installation.md) * [Concepts](understanding-input.md) - * [Workflows](workflows.md) + * [Workflows](Workflows.md) * [Using the Actions Workflow](using-actions-workflow.md) * [Using the PlayerInput Workflow](using-playerinput-workflow.md) * [Using the Direct Workflow](using-direct-workflow.md) diff --git a/Packages/com.unity.inputsystem/Documentation~/about-responding-to-input.md b/Packages/com.unity.inputsystem/Documentation~/about-responding-to-input.md index 021630182a..3d2ac646ef 100644 --- a/Packages/com.unity.inputsystem/Documentation~/about-responding-to-input.md +++ b/Packages/com.unity.inputsystem/Documentation~/about-responding-to-input.md @@ -8,7 +8,7 @@ The Input System offers various ways to respond to input at runtime, from the re ## Recommended workflow -Working with the Input System's [recommended workflow](workflows.md) in your project involves two phases which you must approach in this order: +Working with the Input System's [recommended workflow](Workflows.md) in your project involves two phases which you must approach in this order: 1. Configure your project's actions. 2. Implement responses to actions. diff --git a/Packages/com.unity.inputsystem/Documentation~/enable-correct-input-system.md b/Packages/com.unity.inputsystem/Documentation~/enable-correct-input-system.md index e5ab52e28a..506cf0ca91 100644 --- a/Packages/com.unity.inputsystem/Documentation~/enable-correct-input-system.md +++ b/Packages/com.unity.inputsystem/Documentation~/enable-correct-input-system.md @@ -4,7 +4,7 @@ uid: input-system-enable-correct-input-system # Enable the correct input system -When installing the new Input System, Unity prompts you to enable the new input system and disable the old one. You can change this setting at any time later, by going to **Edit > Project Settings > Player > Other Settings > Active Input Handling**, [as described here](./Installation.md#enable-the-new-input-backends). +When installing the new Input System, Unity prompts you to enable the new input system and disable the old one. You can change this setting at any time later, by going to **Edit > Project Settings > Player > Other Settings > Active Input Handling**. For more information, refer to [Install the Input System package](./Installation.md#select-a-back-end). There are scripting symbols defined which allow you to use conditional compilation based on which system is enabled, as shown in the example below. diff --git a/Packages/com.unity.inputsystem/Documentation~/index.md b/Packages/com.unity.inputsystem/Documentation~/index.md index 907a668a2b..9e9dd22812 100644 --- a/Packages/com.unity.inputsystem/Documentation~/index.md +++ b/Packages/com.unity.inputsystem/Documentation~/index.md @@ -18,7 +18,7 @@ The Unity Editor 6.7 and newer installs the Input System package for projects cr > [!TIP] > During the installation process for the **Input System** package, the installer offers to automatically deactivate the older built-in system. -To get started, refer to the [Workflows](workflows.md) section to decide how to use the Input System: +To get started, refer to the [Workflows](Workflows.md) section to decide how to use the Input System: - Using actions, which is the recommended workflow. - Using both actions and the PlayerInput component, which provides features for callbacks and multiplayer. diff --git a/Packages/com.unity.inputsystem/Documentation~/introduction-virtual-mouse.md b/Packages/com.unity.inputsystem/Documentation~/introduction-virtual-mouse.md index 6442b1cd3e..9534d366e6 100644 --- a/Packages/com.unity.inputsystem/Documentation~/introduction-virtual-mouse.md +++ b/Packages/com.unity.inputsystem/Documentation~/introduction-virtual-mouse.md @@ -12,4 +12,4 @@ At runtime, the component adds a virtual [Mouse](xref:UnityEngine.InputSystem.Mo Note that the resulting [Mouse](xref:UnityEngine.InputSystem.Mouse) input is visible in all code that picks up input from the mouse device. You can therefore use the component for mouse simulation elsewhere, not just with [InputSystemUIInputModule](xref:UnityEngine.InputSystem.UI.InputSystemUIInputModule). -To see an example of the Virtual Mouse in a project, see the [Gamepad Mouse Cursor sample](Installation.md#install-samples) included with the Input System package. +To see an example of the Virtual Mouse in a project, refer to the [Gamepad Mouse Cursor sample](Installation.md#import-samples-and-demos) included with the Input System package. diff --git a/Packages/com.unity.inputsystem/Documentation~/migrate-from-old-input-system.md b/Packages/com.unity.inputsystem/Documentation~/migrate-from-old-input-system.md index bed0490765..4db687db8a 100644 --- a/Packages/com.unity.inputsystem/Documentation~/migrate-from-old-input-system.md +++ b/Packages/com.unity.inputsystem/Documentation~/migrate-from-old-input-system.md @@ -8,6 +8,6 @@ This page is provided to help you match input-related API from Unity's old, buil ## Read the introductory documentation first -If you're new to the Input System package and have landed on this page looking for documentation, it's best to read the [QuickStart Guide](quick-start-guide.md), and the [Concepts](understanding-input.md) and [Workflows](workflows.md) pages from the introduction section of the documentation, so that you can make sure you're choosing the best workflow for your project's input requirements. +If you're new to the Input System package and have landed on this page looking for documentation, it's best to read the [QuickStart Guide](quick-start-guide.md), and the [Concepts](understanding-input.md) and [Workflows](Workflows.md) pages from the introduction section of the documentation, so that you can make sure you're choosing the best workflow for your project's input requirements. This is because there are a number of different ways to read input using the Input System, and some of the directly corresponding API methods on this page might give you the quickest - but least flexible - solution, and may not be suitable for a project with more complex requirements. diff --git a/Packages/com.unity.inputsystem/Documentation~/optimize-controls.md b/Packages/com.unity.inputsystem/Documentation~/optimize-controls.md index 4fb7877fc6..b4df4bdc23 100644 --- a/Packages/com.unity.inputsystem/Documentation~/optimize-controls.md +++ b/Packages/com.unity.inputsystem/Documentation~/optimize-controls.md @@ -4,7 +4,7 @@ uid: input-system-optimize-controls # Optimize controls -The [recommended workflow](workflows.md) is sufficiently optimized for most scenarios. However in some specialized situations when reading values directly from controls, you can make small performance gains by implementing some of the following techniques. +The [recommended workflow](Workflows.md) is sufficiently optimized for most scenarios. However in some specialized situations when reading values directly from controls, you can make small performance gains by implementing some of the following techniques. ## Avoiding defensive copies diff --git a/Packages/com.unity.inputsystem/Documentation~/quick-start-guide.md b/Packages/com.unity.inputsystem/Documentation~/quick-start-guide.md index a507d941b8..b6fb4e5cbe 100644 --- a/Packages/com.unity.inputsystem/Documentation~/quick-start-guide.md +++ b/Packages/com.unity.inputsystem/Documentation~/quick-start-guide.md @@ -3,9 +3,9 @@ uid: quickstart-guide --- # Quickstart Guide -This page has a brief description of how to quickly start using the Input System. The Input System has [multiple workflows](workflows.md) which you might prefer that offer different benefits. This quickstart guide shows a workflow which suits most common scenarios. +This page has a brief description of how to quickly start using the Input System. The Input System has [multiple workflows](Workflows.md) which you might prefer that offer different benefits. This quickstart guide shows a workflow which suits most common scenarios. -First, install the Input System package. For information on how to install the new Input System, refer to [Installation](Installation.md). +First, install the Input System package. For information on how to install the new Input System, refer to [Install the Input System package](Installation.md). ## Create and assign the default project-wide actions diff --git a/Packages/com.unity.inputsystem/Documentation~/use-mobile-device-input-editor-unity-remote.md b/Packages/com.unity.inputsystem/Documentation~/use-mobile-device-input-editor-unity-remote.md index 11d3b79e43..24b0783bc1 100644 --- a/Packages/com.unity.inputsystem/Documentation~/use-mobile-device-input-editor-unity-remote.md +++ b/Packages/com.unity.inputsystem/Documentation~/use-mobile-device-input-editor-unity-remote.md @@ -6,7 +6,7 @@ uid: input-system-unity-remote The Unity Remote is an app available for iOS and Android which allows using a mobile device for input while running in the Unity Editor. You can find details about the app and how to install it in the [Unity manual](https://docs.unity3d.com/Manual/UnityRemote5.html). -If you would like to try out the Unity Remote app, you can [install](Installation.md#install-samples) the "Unity Remote" sample that is provided with the Input System package. +If you would like to try out the Unity Remote app, you can [install](Installation.md#import-samples-and-demos) the "Unity Remote" sample that is provided with the Input System package. > [!NOTE] > Joysticks/gamepads are not yet supported over the Unity Remote. No joystick/gamepad input from the mobile device will come through in the editor. diff --git a/Packages/com.unity.inputsystem/Documentation~/visualizers.md b/Packages/com.unity.inputsystem/Documentation~/visualizers.md index 036aded921..ccb47f00df 100644 --- a/Packages/com.unity.inputsystem/Documentation~/visualizers.md +++ b/Packages/com.unity.inputsystem/Documentation~/visualizers.md @@ -8,7 +8,7 @@ The Input System package comes with a __Visualizers__ sample, which provides com To install the sample: -1. Navigate to the Input System package in the Package Manager window (refer to [Installation](Installation.md)). +1. Navigate to the Input System package in the Package Manager window (refer to [Install the Input System package](Installation.md)). 1. Next to the __Visualizers__ sample, select __Import in project__. The sample provides two visualizer components: From 82c5afcc87dd1b553152c82a4777fee6ab9d5b4d Mon Sep 17 00:00:00 2001 From: Sue Arkin <85237015+suearkinunity@users.noreply.github.com> Date: Wed, 12 Aug 2026 08:48:11 +0100 Subject: [PATCH 07/10] Apply suggestion from @suearkinunity --- Packages/com.unity.inputsystem/Documentation~/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Packages/com.unity.inputsystem/Documentation~/index.md b/Packages/com.unity.inputsystem/Documentation~/index.md index 9e9dd22812..e4f62c5f00 100644 --- a/Packages/com.unity.inputsystem/Documentation~/index.md +++ b/Packages/com.unity.inputsystem/Documentation~/index.md @@ -11,7 +11,7 @@ The **Input System** allows your users to control your game or app using a devic Unity supports input through two systems: - The [Input Manager](https://docs.unity3d.com/Manual/class-InputManager.html), documented in the main Unity manual. This system is available for backward compatibility. For new projects, use the Input System. -- The Input System package described in this documentation. This is a more flexible system than the Input Manager, supporting +- The Input System package described in this documentation. This is a more flexible system than the Input Manager. The Unity Editor 6.7 and newer installs the Input System package for projects created from a template. For empty projects and for older versions of the Editor, please install the package [using the Package Manager](Installation.md). From 9704905cfd25b9938c5452b51bf179d66437498d Mon Sep 17 00:00:00 2001 From: Sue Arkin <85237015+suearkinunity@users.noreply.github.com> Date: Wed, 12 Aug 2026 14:07:45 +0100 Subject: [PATCH 08/10] Update Installation.md --- .../Documentation~/Installation.md | 13 +++---------- 1 file changed, 3 insertions(+), 10 deletions(-) diff --git a/Packages/com.unity.inputsystem/Documentation~/Installation.md b/Packages/com.unity.inputsystem/Documentation~/Installation.md index 0708e55589..dc859a6230 100644 --- a/Packages/com.unity.inputsystem/Documentation~/Installation.md +++ b/Packages/com.unity.inputsystem/Documentation~/Installation.md @@ -5,18 +5,11 @@ uid: input-system-installation Install the Input System package and enable the input back end for your project. -## Compatibility notes for existing projects - -Before you upgrade an existing project, check the following requirements: - -- You're using .NET 4 runtime or newer. -- You're using an Editor version of 2021.3 or newer. For older versions, match the package version to the Editor version as indicated by the **Release** tag in the [Unity Package Manager](https://docs.unity3d.com/Manual/upm-ui.html) window. - ## Install the package -Unity 6.7 and later include the Input System package in projects created from templates. +Unity 6.1 and later include the Input System package in projects created from some templates. -If you've created an empty project, or are upgrading an existing project's input, install the Input System package: +If your project doesn't include the Input System package, you can install it: 1. In the main menu, go to **Window** > **Package Manager**. 1. Go to **Unity Registry**. @@ -58,4 +51,4 @@ For a more comprehensive demo, use the [Warriors](https://github.com/UnityTechno * [Quickstart guide](quick-start-guide.md) * [Migrate from the old input system](migrate-from-old-input-system.md) -* [Input System workflows](Workflows.md) \ No newline at end of file +* [Input System workflows](Workflows.md) From 0ca60f2a9942e523cca445dfc34ed57150faabf2 Mon Sep 17 00:00:00 2001 From: Sue Arkin <85237015+suearkinunity@users.noreply.github.com> Date: Wed, 12 Aug 2026 14:08:13 +0100 Subject: [PATCH 09/10] Apply suggestion from @suearkinunity --- Packages/com.unity.inputsystem/Documentation~/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Packages/com.unity.inputsystem/Documentation~/index.md b/Packages/com.unity.inputsystem/Documentation~/index.md index e4f62c5f00..d1f5db9174 100644 --- a/Packages/com.unity.inputsystem/Documentation~/index.md +++ b/Packages/com.unity.inputsystem/Documentation~/index.md @@ -13,7 +13,7 @@ Unity supports input through two systems: - The [Input Manager](https://docs.unity3d.com/Manual/class-InputManager.html), documented in the main Unity manual. This system is available for backward compatibility. For new projects, use the Input System. - The Input System package described in this documentation. This is a more flexible system than the Input Manager. -The Unity Editor 6.7 and newer installs the Input System package for projects created from a template. For empty projects and for older versions of the Editor, please install the package [using the Package Manager](Installation.md). +The Unity Editor 6.7 and newer installs the Input System package for projects created from some of the template. For empty projects and for older versions of the Editor, please install the package [using the Package Manager](Installation.md). > [!TIP] > During the installation process for the **Input System** package, the installer offers to automatically deactivate the older built-in system. From 5c5041ee6b17310905bdb269dafbe6a0285ff9ae Mon Sep 17 00:00:00 2001 From: Sue Arkin <85237015+suearkinunity@users.noreply.github.com> Date: Wed, 12 Aug 2026 14:09:03 +0100 Subject: [PATCH 10/10] Update Packages/com.unity.inputsystem/Documentation~/index.md --- Packages/com.unity.inputsystem/Documentation~/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Packages/com.unity.inputsystem/Documentation~/index.md b/Packages/com.unity.inputsystem/Documentation~/index.md index d1f5db9174..a58457230f 100644 --- a/Packages/com.unity.inputsystem/Documentation~/index.md +++ b/Packages/com.unity.inputsystem/Documentation~/index.md @@ -11,7 +11,7 @@ The **Input System** allows your users to control your game or app using a devic Unity supports input through two systems: - The [Input Manager](https://docs.unity3d.com/Manual/class-InputManager.html), documented in the main Unity manual. This system is available for backward compatibility. For new projects, use the Input System. -- The Input System package described in this documentation. This is a more flexible system than the Input Manager. +- The Input System package described in this documentation. This is a more flexible system than the Input Manager and replaces it for new projects. The Unity Editor 6.7 and newer installs the Input System package for projects created from some of the template. For empty projects and for older versions of the Editor, please install the package [using the Package Manager](Installation.md).