Replace the Order ID Generated by Circuly With the Shopify Order ID
Introduction
By default, circuly generates its own Order ID when a customer completes checkout. However, if you’re using Shopify as your shop system, each order also has a separate Shopify Order Name (often referred to as Shopify’s order ID).
To avoid confusion—especially in email communication or when syncing data across platforms—you can choose to replace circuly’s Order ID with the Shopify Order Name.
Why replace the circuly Order ID?
There are two common reasons to use the Shopify Order Name instead of the circuly-generated Order ID:
- Cross-referencing in communication
If you're referencing the Order ID in emails sent via Shopify or other tools (outside circuly), using the same value helps ensure consistency. - Avoiding confusion for customers
When customers see different IDs across emails and portals, it may lead to unnecessary support requests. Replacing the circuly Order ID with Shopify’s Order Name ensures your customers only see one consistent identifier.
Technical background: Order ID vs order name
- circuly Order ID
Automatically generated when an order is placed via your circuly white-label checkout. Used internally and displayed in circuly’s email templates and Self-Service Portal. - Shopify Order Name
Generated by Shopify and assigned to every new order. This is what customers typically see in Shopify-based communications.
Where the Order ID is used in circuly
The circuly-generated Order ID appears in:
- The Order confirmation email
- The Customer self-service portal
If not changed, this is the value customers will see by default.
When should you replace Iit?
You should consider replacing circuly’s Order ID with Shopify’s Order Name if:
- You send additional emails to customers outside of circuly’s templates (e.g., directly via Shopify)
- You want consistent identifiers across your shop system, email templates, and Self-Service Portal
- You want to reduce confusion caused by customers seeing two different order numbers
How to replace the Order ID in circuly
To use the Shopify Order Name instead of circuly’s Order ID:
- Go to your Email Templates in the circuly Hub.
- For each relevant email (e.g. Order Confirmation), replace the variable
{{order_ID}}
with the Shopify order name variable. - Save your changes.
Once updated, customers will see the Shopify Order Name in their emails and in the Self-Service Portal.