Release Notes for
              P4 for Visual Studio Code (P4 VS Code)

                           Version 2026.1

Introduction

        This document lists all user-visible changes in this P4 VS Code release.

        Perforce numbers releases YYYY.R/CCCCC, e.g. 2061.1/30547.
        YYYY is the year; R is the release of that year; CCCCC is the
        bug fix change level. Each bug fix in these release notes is
        marked by its change number. Any build includes (1) all bug fixes
        of all previous releases and (2) all bug fixes of the current
        release up to the bug fix change level.


Compatibility Statements

        Server Compatibility

          This release of P4 VS Code supports the 2026.1 P4 Server.
          Older releases might work but are not supported.

        Platform Compatibility

          This release is supported on the following platforms:

              Windows 10+
              macOS 12+
              Linux (Ubuntu 22.04+)

        Visual Studio Code Compatibility

          P4 VS Code requires Visual Studio Code 1.103 or later.

          It is important to make sure your Visual Studio Code installation
          is updated to the latest stable release.

        Native Perforce client

          P4 VS Code bundles the native P4Node library. No p4 command-line
          client installation is required on the user machine.

        Installation

          Install from the Visual Studio Code Marketplace:

              code --install-extension perforce.p4

          Or from the Extensions view, search for "P4 for Visual Studio
          Code" and click Install.

          The extension activates automatically when valid P4 connection
          settings are configured for the workspace — either a P4 client
          workspace or a P4CONFIG file detected at the folder root.

          To uninstall P4 VS Code, open the Extensions view, locate
          "P4 for Visual Studio Code", click the gear icon and choose
          Uninstall.

        P4 VS Code User's Guide
          https://help.perforce.com/helix-core/integrations-plugins/p4vscode/current/Content/P4VSCode/Home-p4vscode.html

        3rd party software

          This product includes software, libraries and components developed
          by third parties. Notices and license terms for the bundled
          third-party components are listed at:
          https://help.perforce.com/helix-core/release-notes/2026.1/p4vscode_third_party_license.txt

          The P4 VS Code extension's own license is at:
          https://help.perforce.com/helix-core/release-notes/2026.1/p4vscode_license.txt
          
---------------------------------------------------------------------------

Key to symbols used in change notes below.

          * -- requires new P4 VS Code
         ** -- requires new p4d server program

---------------------------------------------------------------------------

New Functionality in 2026.1 (2026/05/28)


            Connection and login. The P4 status bar item shows
            "P4: port | user: X | ws: Y" and its tooltip surfaces the
            Connected / Logged in / Logged out state. Click the status
            bar item to log in or re-authenticate when a ticket
            expires. Connection settings can come from a P4CONFIG
            file, environment variables, or the VS Code Settings UI.

            File operations. Open files for add, edit, and delete from
            the Explorer or SCM context menus. Move and rename are
            tracked as P4 move operations so history is preserved
            across the rename, with no manual cleanup required.

            Changelist management. Create, rename, edit the
            description, reorder, and delete pending changelists from
            the Source Control panel. Move files between changelists
            by drag-and-drop or context menu. Submit or revert a
            changelist with one click.

            Shelve and unshelve. Shelve pending work to the P4 Server
            from the changelist context menu and unshelve it later on
            the same machine or a different one.

            Reconcile Workspace. The "P4: Reconcile Workspace" command
            finds files edited, added, or deleted outside VS Code and
            opens them in P4 so offline work is captured in a
            changelist.

            File history and diff. View the full revision history of a
            file from the SCM context menu, then diff your working
            copy against any past revision in VS Code's side-by-side
            diff view. The Open Diff action is also available from
            the SCM context menus and the command palette.

            P4 Annotate. View per-line author and revision information
            for any tracked file, available from the editor tab
            context menu, the Explorer context menu, and the command
            palette.

            View Changelist panel. Right-click a changelist and choose
            "P4: View Changelist" to open a read-only summary tab
            showing the description, files, and linked jobs.

            Automatic file operations. Optional settings to open files
            for edit on save, mark new files for add on create, and
            mark files for delete when removed locally.

            Organised settings UI. All extension settings live under
            the "P4 for VSCode" namespace and are grouped into six
            logical sections — Connection, File Automation,
            Changelists & Workspace, Diff & Code Review, Explorer &
            UI, and Performance & Debug — for easy discovery.

            Auto-refresh. The p4.refreshInterval setting refreshes the
            SCM panel every N seconds (default 60; set to 0 to
            disable) so changelist state stays current without manual
            refresh.

---------------------------------------------------------------------------