Explained: Tags and Tag Date
Introduction
Tags in the circuly Hub are internal tools that help you manage and track order statuses and actions efficiently. By attaching descriptive tags and relevant dates to orders, teams can collaborate better, maintain clarity, and streamline rental operations—without relying on memory or external documentation.
Tip: You can automate tag updates via circuly's Customer API. See API Docs
Feature overview
- Tag: A keyword that describes the current status or required action for an order.
- Tag Date: The date associated with the tag, often representing when the tagged action should occur.
- Tags are visible only in the circuly Hub and do not impact the customer experience, payment schedule, or subscription logic.
Tags provide visual and operational clarity. For instance, a tag can indicate whether a product has been delivered, picked up, or is lost. Used effectively, tags reduce ambiguity and improve team communication.
Common tags (examples)
The following tags are predefined but can be customised according to your internal processes:
- Delivered – Product has already been delivered.
- Delivery – Order should be delivered on the tag date.
- In clarification – Issues with customer data; action needed.
- Lost – Product is considered lost.
- Pick-up – Product is scheduled for pick-up.
- Picked up – Product has been picked up.
- Replaced – Product has been replaced.
- Replacement – Replacement is required or ongoing.
- Test-order – Internal or non-customer test order.
Note: Tags do not alter buffer times, delivery times, subscription start dates, or payment dates.
Step-by-step guide: How to Add or Edit Tags
- Go to Orders in the circuly Operations Backend.
- Locate and click on the relevant order.
- On the right side of the order detail view, find the tag section.
- Select a tag from the dropdown menu.
- Choose a Tag Date from the date picker.
- Click SAVE CHANGES.
If you use a "Delivery Date Picker" in your checkout process, the selected delivery date will automatically populate the tag date field.
Good to Know
- Tags are visible only internally—they do not affect the customer's experience.
- Tags do not override existing settings or system values (e.g. delivery time or order status).
- Tags are especially useful in multi-user environments to ensure alignment.
FAQ
Q: Can tags affect order processing logic or subscription activation?
A: No. Tags are only visual and for internal tracking. They do not impact any backend logic.
Q: Can we define our own tags?
A: While common tags are predefined, your team can adopt your own internal definitions.
Q: Can we automate tag assignments?
A: Yes. Use the circuly Customer API to update tags programmatically.
Tip: This process can be automated via our customer API. This is the PUT request you can use https://api-docs.circuly.io/docs/customers-api-docs/pgyucirl7m7fh-update-order-s-tag to update the order tag.
What Is a Tag?
A tag is a keyword assigned to a piece of information that helps describe it visually and allows it to be easily found. In the circuly operations backend a tag is a keyword assigned to an order. Accompanied with the tag date, a tag describes what action needs to be taken or is currently active and the date associated with that action. Every order can have a tag and a tag date attached to it.
Tags main purpose is to see the associated action of an order at first sight. In order to gain a better overview of the status of your orders you can add tags to each order. The additional information serves your team e.g. to assure everyone working in the system directly knows the handling status/fulfilment timeline regardless of an external additional document, a single person's memory or additional assumption being made based on other information. Tags are solely for internal use and do not change anything for the consumer. Using tags also does not influence the information and pre-set e.g. buffer time/delivery time, order date or subscription date started, payment date.
The different tags can be interpreted as follows - however can also be given a different definition within your team:
- Delivered: the product has been already delivered.
- Delivery: delivery, as the name suggests, means that the order is a delivery order that should be delivered to the customer by the date highlighted in the tag date.
- In clarification - there is an issue with the customer data - requires action/ see notes for further information.
- Lost: the product is lost and is not expected to come back.
- Pick-up: the order is to be picked up by the customer e.g. if you have a store or if it has to be picked up at the refurbisher
- Picked up: the order has been picked up.
- Replaced: the product has been replaced.
- Replacement: replacement means that the order has to be replaced or is in the process of replacement.
- Test-order: the order is a test order and not a real order.
What is a Tag Date?
A tag date simply represents the fulfilment timeline of the tag.
How to Add Tags and Tag date?
Tags can be added and edited for an order in the Order List. You can find the Order List by navigating to Orders in the left navigation bar. To add a tag follow the following steps:
- Locate an order in the Order List and click on it.
- in the Order detail view, the option to add/edit a tag is on the right side of the displayed view.

- Select a tag from the tag dropdown menu
- Select a tag date from the date picker.
- Click on SAVE CHANGES
Note: If you have a "Delivery Date Picker" in your checkout, the selected delivery date will be used for the Tag date value for the order in question.
Conclusion
Tags and tag date are meant to be used for internal operations. They do not have any affect on the order or customer data. If there are multiple users of the operations backend, tags can help in efficiently managing rentals by providing a visual aspect.