Replace the Order ID Generated by Circuly With the Shopify Order ID

Published on
July 28, 2023
Written by
written by Garima Singh
TABLE OF CONTENT

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:

  1. 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.
  2. 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:

  1. Go to your Email Templates in the circuly Hub.
  2. For each relevant email (e.g. Order Confirmation), replace the variable {{order_ID}} with the Shopify order name variable.
  3. Save your changes.

Once updated, customers will see the Shopify Order Name in their emails and in the Self-Service Portal.

missing the answer to your question?

Fields marked with an asterisk (*) are required.
Thank you! Your submission has been received!

We are now hitting the keys to produce the content you are looking for. We will inform you once we are finished.  
Oops! Something went wrong while submitting the form.

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:

  1. 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.
  2. 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:

  1. Go to your Email Templates in the circuly Hub.
  2. For each relevant email (e.g. Order Confirmation), replace the variable {{order_ID}} with the Shopify order name variable.
  3. Save your changes.

Once updated, customers will see the Shopify Order Name in their emails and in the Self-Service Portal.