Powered by Adobe Commerce 2.4.3-p2


Custom Order Number



Back to top

Custom Order Number for Magento 2 by Mageplaza is developed to eliminate limitations of the default Magento 2 when it comes to setting the order numbers. Native Magento 2 sets increment IDs by a 9-digit string starting from 000000001, which somehow reveals the number of orders placed on an online store, but it has poor information about these orders.

Mageplaza Custom Order Number extension for Magento 2 can also help the admin to configure the increment IDs of related billing documents (such as invoices, shipments, and credit memos) to depend on the original order ID which makes order management easier for the admin and store owner. Some highlight features are as following:


  • Easy To Customize Order Numbers
  • Flexible Adjust Order Number Patterns
  • Invoice IDs Depend On Order Numbers
  • Compatible With Mageplaza PDF Invoice


The fact that stores can customize the number of orders and other billing documents can be applied in several cases, including: 

Hide order volumes

A brand new online store does not want its order number to start from 0 because it will be obvious that its products and services have been experienced by only a few buyers, which has a negative impact on new customers' purchasing decisions. In other cases, a store wants to keep sensitive information from rivals: because it will be too easy to learn how many orders have been placed and how much a store can sell by counting the default order numbers. Every store wants to hide them away from other competitors.

Example: the first-order number can be from 111111111 instead of 000000001

Read information instantly

A store wants to professionalize its order numbering system, which makes it easier for the store admin to read some basic information of each order through the number while giving a better impression to buyers.

Example: an order number can be configured to contain both characters and numbers as ORD-111-CAD-01

Follow numbering requirements

A store wants to meet the local invoice numbering requirements because in some countries, the order/invoice number format has to include the company's VAT number, which cannot be done without the Custom Order Number extension by Mageplaza.

Match the numbers

A store wants all billing documents of an order numbered the same: it will be easier to manage.

Example: an order which is ORD-2019-1111 can be configured to have an invoice number, shipment number, and credit memo number as INV-2019-1111, SHI-2019-1111, and CRE-2019-1111, respectively.

Record orders in financial years

Based on each store’s financial record strategy, if the order number is set with consistency, it is easier to record and manage. The order numbers can be set with patterns and automatically reset for the next period.

Problems & Solutions

Change Order ID's Patterns

In Magento 2 default configuration, the increment ID is set with an effortless 9-digit string, starting from 000000001. For several reasons, online stores want to vary this string structure. The customized string will contain a lot of useful information to shop owners but incomprehensive to competitors. An example is that the 15th order, which is made on 15th June 2018  in-store 03 can be structured as ORD-03-150618-015.

Such number strings have little meaning to customers and others, but it is totally understandable and useful to the store owner who creates the rule for it.

A More Professional Order Number System

Order numbers can affect visitors surfing your online shop. Caring more about the appearance of order numbers can make online stores more professional in a very sensible way. Imagine that this is the first time a customer has visited an online store and sees the order number as 000000011. The first thought in his/her mind is likely that this store’s sales are very poor, and he/she will tend to quit the purchase because the store is unpopular. That is why many store owners find a way to customize their order numbers to attract new customers. Mageplaza Customer Order Number is the complete solution to beautify the number string to impress your buyer effectively. 

Meet Local Invoice Number Requirements

Invoice numbers in some regions or countries which manage invoice systems seriously are required to follow particular regulations. As a result, businesses have to establish the increment ID to comply properly with legality. With Customer Order Number by Mageplaza, system number regulation is no longer the concern. Whatever required structures of invoice number are, the store owner can set up and customize them with ease. 

When Switching Platforms

There is the problem that when an online store switches from a platform to Magento, the numerical systems are not similar and cause some troubles. This transfer requires the admin to change increment IDs of billing documents to suit the enumeration rules of the previous platform. With Custom Order Number, the admin can set up the structures easily with proper suitability to any previous numbering requirements. 

Protect Business Data

In case the store owners use raw number strings for orders, it will be effortless for customers and competitors to guess how many orders have been transacted on your site then assess your business growth, which can put your business security at risk. Custom Order Number by Mageplaza is the proper solution that helps store owners create complicated strings with both effects. Firstly, IDs follow the rules set by store owners, so they can easily store and understand various information included in their customized number strings. Secondly, due to the complexity of the order number, the competitors are unable to guess the business data and keep it safe for security.

Highlight Features

Easy To Customize Order Numbers

The process of creating increment ID rules is so simple from the admin backend configuration. No complex codes or commands are required as in Magento default. With the Custom Order Number extension, the admin can easily change the pattern of the ID in the backend using syntax. 

Here is the example for a pattern with the rule:  ORD- [dd]-[mm]-[yy]-[3counter] will output ORD-110818104, which means the order was made on 11th August 2018 and is the 104th order. Besides, the first order number can be configured with any ID number; then, the next orders will move up numerically based on a counter step which is set by admin. In particular, the billing documents, including the order number, invoice number, credit memo, can be totally applied with the same settings.

Flexible Adjust Order Number Patterns

With the pattern adjusted by syntax, tracking the order becomes easy and effective. Order number patterns can be customized sequentially and chronologically by customer number or project number. Besides, the date information of orders can be included with different formats such as [d], [dd], [D], [m], [mm], [y], [yy], [yyyy]. This also supports tracking orders by the placement date. In addition, the order number at the end of the string can be set optionally by how many counters.

Invoice IDs Depend On Order Numbers

Custom Order Number allows the admin to create invoice numbers, shipment numbers, credit memo numbers to depend on the rules already set for order numbers.  Just by replacing the prefix of the order number while keeping the rest unchanged, a new invoice number or other billing documents are created quickly and systematically. This helps the store owners can manage and track the billing system easily.

Compatible With Mageplaza PDF Invoice

The store owner can be relieved that  Magento 2 Custom Order Number is properly compatible with  PDF Invoice by Mageplaza. All the order numbers, invoice numbers, shipment numbers, and other billing documents can be displayed on PDF Invoice accurately.

More Features

Restrict Order Number Padding

Custom Order Number by Mageplaza allows the admins to customize formats of billing document numbers easily. Hence the padding of number strings can be limited to a certain length. 

Set The Counter By Store

The counter can be set separately for each store. It means that the sequence number will rise by counter steps in each store independently.

Reset The Counter

Just by one simple click, the counter can be reset easily and turn back to the counter start.

Customize By Syntax

The structure of order numbers can be customized easily by using syntax. For example: ORD-[3AN]-[3A]-[3N]-[5counter]-[yy]-[mm]-[dd]-[storeId]-[orderId].

Customize Order Number Prefix

The order number prefix is customized in the pattern. Besides, the admins need to change the prefix to create new billing document numbers while keeping the rest of the structure unchanged. 

Hide real order number ID

In some cases, stores may want to hide the real order number IDs from customers, but they still want to understand. Mageplaza Custom Order Number extension can help admins add extra numbers/symbols in the patterns so that as long as they understand the pattern rules, they can still spot the necessary information. 

Full Features List

General Configuration

  • Enabling or disabling the module
  • Enabling or disabling custom order number, invoice number, credit memo number, and shipment number
  • Well compatible with Mageplaza PDF Invoice extension

Invoice/Credit Memo/Shipment Number Configuration

  • Replace the prefix of Invoice/Credit Memo/Shipment number
  • Able to create Invoice/Credit memo/Shipment number depending on the Order number
  • Set the numerical system by using the syntax
  • Set the counter start
  • Set the counter step
  • Able to set the counter step to run independently in each store
  • Able to reset the counter to start point
  • Able to reset the counter after a configured period


Q1: I want my order IDs to be increased regardless of which stores it is generated. Can I configure this?

A: It is possible to choose whether to increase order IDs separately for each store or increase order IDs in succession in all stores. You can easily configure this by following this user guide.

Q2: Will the order information change after I edit the order number pattern?

A: No, only the IDs of billing documents such as orders, shipments, invoices, and credit memos change. Other information stays the same.

Q3: I want to add text to the order number. Is it possible to do so?

A: You can do it by using syntax. Store ID or store code can also be added.

Q4: I want the credit memo to share the same number as the order number, just with a different prefix. How can I do it?

A: In the backend, you need to go to the Credit memo section, select the ‘Same as order number’ option, then fill in the prefix you want to replace.

Q5: If there is more than one invoice, how does the extension handle the invoice number?

A: In that case, a suffix of 2, 3,... will be added to the number. For instance: INV2021061612-2.

Q6: Can I reset the order numbers regularly?

A: Yes, you can choose to reset the order numbers daily, weekly, or monthly in the backend. You can even reset instantly by clicking on the ‘Reset Now’ button.


Frontend | Backend


User Guide | Installation Guide 

Technical Specifications

Back to top

Seller profile


Seller contact



Current Version


Adobe Commerce platform compatibility

Open Source (CE): 2.3 (current), 2.4 (current), 2.2 (obsolete)

Commerce on prem (EE): 2.3 (current), 2.4 (current), 2.2 (obsolete)


Stable Build


21 June, 2021


Extensions, Shipping & Fulfillment, Order Management (OMS)

Quality Report

Back to top

Installation & Varnish Tests


Coding Standard


Plagiarism Check


Malware Check


Marketing Review


Manual Testing


All tests were conducted on the latest versions of Adobe Commerce that existed for the compatible release lines at the moment of the extension submission. Latest versions of all other software were used, as applicable.

Release Notes

Back to top


  • Compatible with Open Source (CE) : 2.4
  • Compatible with Commerce on prem (EE) : 2.4
  • Stability: Stable Build
  • Description:

    Supported Magento v2.4


  • Compatible with Open Source (CE) : 2.2 2.3
  • Compatible with Commerce on prem (EE) : 2.2 2.3
  • Stability: Stable Build
  • Description:

    - Fixed error with Invoice ID when Invoiced was created automatically
    - Compatible with Magento 2.3


Back to top

The best place to start if you need help with a specific extension is to contact the developer. All Adobe Commerce developers have both a contact email and a support email listed.

Contact Vendor

Q & A

Back to top


Back to top