{"id":1755,"date":"2024-10-10T18:45:28","date_gmt":"2024-10-10T15:45:28","guid":{"rendered":"https:\/\/plumrocket.com\/learn\/?p=1755"},"modified":"2026-09-03T15:30:40","modified_gmt":"2026-09-03T12:30:40","slug":"how-to-change-order-status-in-magento-2","status":"publish","type":"post","link":"https:\/\/plumrocket.com\/learn\/change-magento-2-order-status","title":{"rendered":"How to Change Order Status in Magento 2"},"content":{"rendered":"\n
\"How<\/figure>\n\n\n\n

Magento 2 provides a set of default statuses, which may vary depending on version and installed payment modules (e.g., PayPal adds additional statuses): Received, Suspected Fraud, Processing, Pending Payment, Payment Review, Pending, On Hold, Complete, Closed, Canceled, Rejected, PayPal Canceled Reversal, Pending PayPal, PayPal Reversed.<\/em><\/p>\n\n\n\n

These statuses help merchants track the progress of each order through the fulfillment process.<\/p>\n\n\n\n

There are several ways to change order status in Magento 2<\/strong>, depending on your requirements:<\/p>\n\n\n\n

    \n
  1. Manually <\/strong>through the Magento Admin panel<\/a><\/li>\n\n\n\n
  2. Programmatically <\/strong>using custom code<\/a><\/li>\n\n\n\n
  3. Via Magento REST API<\/a><\/li>\n\n\n\n
  4. Automatically <\/strong>using Magento 2 extensions<\/a><\/li>\n<\/ol>\n\n\n\n

    In this article, we will walk you through each of these methods. Choose the method that best aligns with your specific needs and technical capabilities.<\/p>\n\n\n\n

    Improve order processing speed with automatic invoicing, shipping creation, and status updates using our Auto Invoice & Shipment Extension<\/a>.<\/p>\n\n\n\n

    How to Change Order Status in Magento 2 Manually in the Admin Panel<\/h2>\n\n\n\n

    In the Magento 2 admin panel, you can only manually change the order status to On Hold<\/em> or Canceled<\/em>. All other statuses depend on payment method, payment status, shipping, and refunds.<\/p>\n\n\n\n

    Steps to change order status to Canceled <\/em>or On hold <\/em>status:<\/p>\n\n\n\n

    \n

    Step-by-step guide:<\/p>\n\n\n\n

      \n
    1. Open the Magento 2 Orders grid page.<\/li>\n\n\n\n
    2. Use checkboxes to select the orders you want to change the status of.<\/li>\n\n\n\n
    3. Choose the Cancel<\/em> or Hold <\/em>option from the Actions drop-down.<\/li>\n<\/ol>\n\n\n\n

      <\/p>\n<\/div><\/div>\n\n\n\n

      \"Change<\/figure>\n\n\n\n

      How to Change Order Status in Magento 2 Programmatically<\/h2>\n\n\n\n

      Magento provides the OrderManagementInterface for performing standard order management actions.<\/p>\n\n\n\n

      In this example, we will create a Magento 2 model called ManageOrder that can hold, unhold, or cancel an order programmatically<\/strong>.<\/p>\n\n\n\n

      <?php\n\ndeclare(strict_types=1);\n\nnamespace Vendor\\OrderManagement\\Model;\n\nuse Magento\\Sales\\Api\\OrderManagementInterface;\n\nclass ManageOrder\n{\n    public function __construct(\n        private readonly OrderManagementInterface $orderManagement\n    ) {\n    }\n\n    public function hold(int $orderId): void\n    {\n        $this->orderManagement->hold($orderId);\n    }\n\n    public function unhold(int $orderId): void\n    {\n        $this->orderManagement->unHold($orderId);\n    }\n\n    public function cancel(int $orderId): void\n    {\n        $this->orderManagement->cancel($orderId);\n    }\n}<\/code><\/pre>\n\n\n\n
      The following example shows how to use the ManageOrder model. Simply pass the order ID to the appropriate method depending on the action you pAGEwant to perform.<\/p>\n\n\n\n
      <?php\n\ndeclare(strict_types=1);\n\nnamespace Vendor\\OrderManagement\\Console\\Command;\n\nuse Vendor\\OrderManagement\\Model\\ManageOrder;\n\nclass Example\n{\n    public function __construct(\n        private readonly ManageOrder $manageOrder\n    ) {\n    }\n\n    public function execute(): void\n    {\n        $this->manageOrder->hold(123);\n    }\n}<\/code><\/pre>\n\n\n\n
      Here, the order with ID 123 will be placed on hold. In the same way, you can call unhold() or cancel() to perform the corresponding action.<\/p>\n\n\n\n
      How to Change Order Status in Magento 2 via REST API<\/h2>\n\n\n\n
      To cancel an order through the Magento 2 REST API, obtain an access token and then call the dedicated cancel endpoint.<\/p>\n\n\n\n
        \n
      1. Get an Admin Access Token<\/strong><\/li>\n<\/ol>\n\n\n\n
        If two-factor authentication is not enabled for the admin account, use:<\/p>\n\n\n\n
        curl -X POST \\\n  "https:\/\/magento-store.com\/rest\/V1\/integration\/admin\/token" \\\n  -H "Content-Type: application\/json" \\\n  -d '{\n    "username": "admin_username",\n    "password": "admin_password"\n  }'<\/code><\/pre>\n\n\n\n
        If 2FA with Google Authenticator is enabled, send the current six-digit one-time password using the 2FA endpoint:<\/p>\n\n\n\n
        curl -X POST \\\n  "https:\/\/magento-store.com\/rest\/V1\/tfa\/provider\/google\/authenticate" \\\n  -H "Content-Type: application\/json" \\\n  -d '{\n    "username": "admin_username",\n    "password": "admin_password",\n    "otp": "123456"\n  }'<\/code><\/pre>\n\n\n\n
        A successful request returns an admin access token. The endpoint may differ if another 2FA provider is configured.<\/p>\n\n\n\n
          \n
        1. Cancel the Order<\/strong><\/li>\n<\/ol>\n\n\n\n
          Replace <access-token><\/code> with the returned token and <orderId><\/code> with the internal Magento order entity ID:<\/p>\n\n\n\n
          curl -X POST \\\n  "https:\/\/magento-store.com\/rest\/V1\/orders\/<orderId>\/cancel" \\\n  -H "Content-Type: application\/json" \\\n  -H "Authorization: Bearer <access-token>"<\/code><\/pre>\n\n\n\n
          Magento validates whether the order can be canceled and processes the cancellation using its standard order management logic.<\/p>\n\n\n\n
          Similar REST API endpoints are available for other order operations, such as placing an order on hold or releasing it from hold:<\/p>\n\n\n\n
          POST \/rest\/V1\/orders\/<orderId>\/hold\nPOST \/rest\/V1\/orders\/<orderId>\/unhold\nPOST \/rest\/V1\/orders\/<orderId>\/cancel<\/code><\/pre>\n\n\n\n
          For operations such as invoicing or shipping, Magento provides separate REST API endpoints and request payloads.<\/p>\n\n\n\n
          How to Change Order Status in Magento 2 Automatically<\/h2>\n\n\n\n
          One efficient way to automate order status updates in Magento 2 is by using the Magento 2 Auto Invoice & Shipment Extension<\/a>. This extension can automatically generate invoices and shipments, which triggers an automatic change in the order status to Processing<\/em> or Complete<\/em>, depending on the fulfillment stage.<\/p>\n\n\n\n
          Key features of this extension include:<\/h3>\n\n\n\n
          \n
          \n
          Bulk Invoice and Shipment<\/strong>
          The extension enables store admins to generate Magento invoices and shipments in bulk, saving time and streamlining order processing.<\/p>\n<\/div>\n\n\n\n
          <\/div>\n\n\n\n
          \n
          \"\"<\/figure>\n<\/div>\n<\/div>\n\n\n\n
          \n
          \n
          \"\"<\/figure>\n<\/div>\n\n\n\n
          <\/div>\n\n\n\n
          \n
          Flexible Rules<\/strong>
          You can configure specific rules to specify when and how invoices and shipments are created automatically. These rules allow you to set conditions based on payment methods, order status, or other criteria, ensuring that your workflow aligns with your business needs.<\/p>\n<\/div>\n<\/div>\n\n\n\n
          \n
          \n
          Support for Partial Invoices and Shipments<\/strong>
          If your business deals with partial shipments or split orders, the extension allows you to create partial invoices and shipments. This ensures that order statuses are updated correctly for each portion of the order that is fulfilled.<\/p>\n<\/div>\n\n\n\n
          <\/div>\n\n\n\n
          \n
          \"\"<\/figure>\n<\/div>\n<\/div>\n\n\n\n
          \n
          \n
          <\/div><\/span>
          \n
          Automate the invoicing and shipping process to ensure order management efficiency and timely status updates.<\/span><\/p>\n\n\n\n
          \n
          Try Auto Invoice & Shipment Extension<\/a><\/div>\n<\/div>\n<\/div><\/div>\n<\/div>\n<\/div>\n\n\n\n
          Frequently Asked Questions (FAQ)<\/h2>\n\n\n\n
          Why can\u2019t I change the order status directly to Complete?<\/strong><\/strong> 
          Magento restricts the Complete<\/strong> status because it should only be applied when an order has been fully invoiced and shipped. To set it programmatically, you must do it through custom code or an integration.<\/p> <\/div> 
          Can I force an order status update through the API?<\/strong><\/strong> 
          Yes, but Magento requires that the state<\/code> and status<\/code> pair be valid.
          For example, you cannot set status = complete<\/code> unless the order state supports it or workflow rules are bypassed programmatically.<\/p> <\/div> 
          How can I automate order status changes in Magento 2?<\/strong><\/strong> 
          You can use automation tools such as the Auto Invoice & Shipment Extension for Magento 2<\/a>, which automatically generates invoices and shipments. This triggers automatic status changes and reduces manual admin work.<\/p> <\/div> <\/div>\n","protected":false},"excerpt":{"rendered":"
          Magento 2 offers a comprehensive order management system with 14 predefined order statuses, which help merchants track the progress of each order through the fulfillment process. There are several ways to change order status in Magento 2<\/strong>, depending on your requirements:
          \n<\/p>\n
          <\/p>\n
            \n
          1. Manually <\/strong>through the Magento Admin panel<\/li>\n
          2. Programmatically <\/strong>using custom code<\/li>\n
          3. Via Magento REST API<\/li>\n
          4. Automatically <\/strong> using Magento 2 extensions<\/li>\n<\/ol>\n
            <\/p>\n
            In this article, we will walk you through each of these methods. Choose the method that best aligns with your specific needs and technical capabilities.<\/p>\n","protected":false},"author":7,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"footnotes":""},"categories":[122],"tags":[],"class_list":["post-1755","post","type-post","status-publish","format-standard","hentry","category-magento-management","entry"],"yoast_head":"\nChange Order Status in Magento 2 (Programmatically, Rest API)<\/title>\n<meta name=\"description\" content=\"A step-by-step guide on different ways to change order status in Magento 2 - programmatically, via Rest API, or automatically using extensions.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/plumrocket.com\/learn\/change-magento-2-order-status\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Change Order Status in Magento 2 (Programmatically, Rest API)\" \/>\n<meta property=\"og:description\" content=\"A step-by-step guide on different ways to change order status in Magento 2 - programmatically, via Rest API, or automatically using extensions.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/plumrocket.com\/learn\/change-magento-2-order-status\" \/>\n<meta property=\"og:site_name\" content=\"Magento Tutorials for Beginners & Professionals\" \/>\n<meta property=\"article:published_time\" content=\"2024-10-10T15:45:28+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-09-03T12:30:40+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/plumrocket.com\/learn\/wp-content\/uploads\/2024\/10\/change-magento-order-status.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1600\" \/>\n\t<meta property=\"og:image:height\" content=\"600\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Volodymyr Holovatskiy\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Volodymyr Holovatskiy\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"5 minutes\" \/>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Change Order Status in Magento 2 (Programmatically, Rest API)","description":"A step-by-step guide on different ways to change order status in Magento 2 - programmatically, via Rest API, or automatically using extensions.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/plumrocket.com\/learn\/change-magento-2-order-status","og_locale":"en_US","og_type":"article","og_title":"Change Order Status in Magento 2 (Programmatically, Rest API)","og_description":"A step-by-step guide on different ways to change order status in Magento 2 - programmatically, via Rest API, or automatically using extensions.","og_url":"https:\/\/plumrocket.com\/learn\/change-magento-2-order-status","og_site_name":"Magento Tutorials for Beginners & Professionals","article_published_time":"2024-10-10T15:45:28+00:00","article_modified_time":"2026-09-03T12:30:40+00:00","og_image":[{"width":1600,"height":600,"url":"https:\/\/plumrocket.com\/learn\/wp-content\/uploads\/2024\/10\/change-magento-order-status.png","type":"image\/png"}],"author":"Volodymyr Holovatskiy","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Volodymyr Holovatskiy","Est. reading time":"5 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/plumrocket.com\/learn\/change-magento-2-order-status#article","isPartOf":{"@id":"https:\/\/plumrocket.com\/learn\/change-magento-2-order-status"},"author":{"name":"Volodymyr Holovatskiy","@id":"https:\/\/plumrocket.com\/learn\/#\/schema\/person\/161911374678c2f70335dd5a1efac69f"},"headline":"How to Change Order Status in Magento 2","datePublished":"2024-10-10T15:45:28+00:00","dateModified":"2026-09-03T12:30:40+00:00","mainEntityOfPage":{"@id":"https:\/\/plumrocket.com\/learn\/change-magento-2-order-status"},"wordCount":785,"commentCount":0,"image":{"@id":"https:\/\/plumrocket.com\/learn\/change-magento-2-order-status#primaryimage"},"thumbnailUrl":"https:\/\/plumrocket.com\/learn\/wp-content\/uploads\/2024\/10\/change-magento-order-status.png","articleSection":["Managing Magento"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/plumrocket.com\/learn\/change-magento-2-order-status#respond"]}]},{"@type":["WebPage","FAQPage"],"@id":"https:\/\/plumrocket.com\/learn\/change-magento-2-order-status","url":"https:\/\/plumrocket.com\/learn\/change-magento-2-order-status","name":"Change Order Status in Magento 2 (Programmatically, Rest API)","isPartOf":{"@id":"https:\/\/plumrocket.com\/learn\/#website"},"primaryImageOfPage":{"@id":"https:\/\/plumrocket.com\/learn\/change-magento-2-order-status#primaryimage"},"image":{"@id":"https:\/\/plumrocket.com\/learn\/change-magento-2-order-status#primaryimage"},"thumbnailUrl":"https:\/\/plumrocket.com\/learn\/wp-content\/uploads\/2024\/10\/change-magento-order-status.png","datePublished":"2024-10-10T15:45:28+00:00","dateModified":"2026-09-03T12:30:40+00:00","author":{"@id":"https:\/\/plumrocket.com\/learn\/#\/schema\/person\/161911374678c2f70335dd5a1efac69f"},"description":"A step-by-step guide on different ways to change order status in Magento 2 - programmatically, via Rest API, or automatically using extensions.","breadcrumb":{"@id":"https:\/\/plumrocket.com\/learn\/change-magento-2-order-status#breadcrumb"},"mainEntity":[{"@id":"https:\/\/plumrocket.com\/learn\/change-magento-2-order-status#faq-question-1788438433644"},{"@id":"https:\/\/plumrocket.com\/learn\/change-magento-2-order-status#faq-question-1788438440816"},{"@id":"https:\/\/plumrocket.com\/learn\/change-magento-2-order-status#faq-question-1788438467560"}],"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/plumrocket.com\/learn\/change-magento-2-order-status"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/plumrocket.com\/learn\/change-magento-2-order-status#primaryimage","url":"https:\/\/plumrocket.com\/learn\/wp-content\/uploads\/2024\/10\/change-magento-order-status.png","contentUrl":"https:\/\/plumrocket.com\/learn\/wp-content\/uploads\/2024\/10\/change-magento-order-status.png","width":1600,"height":600},{"@type":"BreadcrumbList","@id":"https:\/\/plumrocket.com\/learn\/change-magento-2-order-status#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Learn","item":"https:\/\/plumrocket.com\/learn"},{"@type":"ListItem","position":2,"name":"How to Change Order Status in Magento 2"}]},{"@type":"WebSite","@id":"https:\/\/plumrocket.com\/learn\/#website","url":"https:\/\/plumrocket.com\/learn\/","name":"Magento Tutorials for Beginners & Professionals","description":"Plumrocket Inc","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/plumrocket.com\/learn\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/plumrocket.com\/learn\/#\/schema\/person\/161911374678c2f70335dd5a1efac69f","name":"Volodymyr Holovatskiy","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/plumrocket.com\/learn\/wp-content\/uploads\/2024\/10\/avatar_user_7_1729774175-96x96.png","url":"https:\/\/plumrocket.com\/learn\/wp-content\/uploads\/2024\/10\/avatar_user_7_1729774175-96x96.png","contentUrl":"https:\/\/plumrocket.com\/learn\/wp-content\/uploads\/2024\/10\/avatar_user_7_1729774175-96x96.png","caption":"Volodymyr Holovatskiy"},"description":"Magento 2 developer passionate about creating efficient and functional ecommerce solutions. Loves skiing and hiking in the mountains, finding inspiration for new ideas and solutions in web development.","url":"https:\/\/plumrocket.com\/learn\/author\/volodymyr-holovatskiy"},{"@type":"Question","@id":"https:\/\/plumrocket.com\/learn\/change-magento-2-order-status#faq-question-1788438433644","position":1,"url":"https:\/\/plumrocket.com\/learn\/change-magento-2-order-status#faq-question-1788438433644","name":"Why can\u2019t I change the order status directly to Complete?","answerCount":1,"acceptedAnswer":{"@type":"Answer","text":"Magento restricts the <strong>Complete<\/strong> status because it should only be applied when an order has been fully invoiced and shipped. To set it programmatically, you must do it through custom code or an integration.","inLanguage":"en-US"},"inLanguage":"en-US"},{"@type":"Question","@id":"https:\/\/plumrocket.com\/learn\/change-magento-2-order-status#faq-question-1788438440816","position":2,"url":"https:\/\/plumrocket.com\/learn\/change-magento-2-order-status#faq-question-1788438440816","name":"Can I force an order status update through the API?","answerCount":1,"acceptedAnswer":{"@type":"Answer","text":"Yes, but Magento requires that the state and status pair be valid.<br>For example, you cannot set status = complete unless the order state supports it or workflow rules are bypassed programmatically.","inLanguage":"en-US"},"inLanguage":"en-US"},{"@type":"Question","@id":"https:\/\/plumrocket.com\/learn\/change-magento-2-order-status#faq-question-1788438467560","position":3,"url":"https:\/\/plumrocket.com\/learn\/change-magento-2-order-status#faq-question-1788438467560","name":"How can I automate order status changes in Magento 2?","answerCount":1,"acceptedAnswer":{"@type":"Answer","text":"You can use automation tools such as the <a href=\"\/magento-auto-invoice-shipment\" target=\"_blank\" rel=\"noopener\">Auto Invoice & Shipment Extension for Magento 2<\/a>, which automatically generates invoices and shipments. This triggers automatic status changes and reduces manual admin work.","inLanguage":"en-US"},"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/plumrocket.com\/learn\/wp-json\/wp\/v2\/posts\/1755","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/plumrocket.com\/learn\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/plumrocket.com\/learn\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/plumrocket.com\/learn\/wp-json\/wp\/v2\/users\/7"}],"replies":[{"embeddable":true,"href":"https:\/\/plumrocket.com\/learn\/wp-json\/wp\/v2\/comments?post=1755"}],"version-history":[{"count":49,"href":"https:\/\/plumrocket.com\/learn\/wp-json\/wp\/v2\/posts\/1755\/revisions"}],"predecessor-version":[{"id":3051,"href":"https:\/\/plumrocket.com\/learn\/wp-json\/wp\/v2\/posts\/1755\/revisions\/3051"}],"wp:attachment":[{"href":"https:\/\/plumrocket.com\/learn\/wp-json\/wp\/v2\/media?parent=1755"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/plumrocket.com\/learn\/wp-json\/wp\/v2\/categories?post=1755"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/plumrocket.com\/learn\/wp-json\/wp\/v2\/tags?post=1755"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}