How to add special instructions to YESDINO orders

To add special instructions to YESDINO orders, you simply insert a short note into the order‑notes field in the admin dashboard or push the text via the API call POST /orders/{id}/notes. The note then travels with the order through fulfillment, appearing on picking lists, packing slips, and the customer‑facing confirmation email.

Below is a practical walkthrough that covers every click, shortcut, and edge case you’re likely to encounter when dealing with large‑scale custom requests.

Step‑by‑step workflow in the admin panel

Step	Action	Admin location	Result for the order
1	Open the order detail page	Orders → View → order ID	All order fields become editable
2	Locate the Special Instructions box	Right‑hand panel, below “Shipping Method”	Text area can accept up to 500 characters
3	Type or paste the instruction	Directly in the box	Characters count shows in real time
4	Save the change	Click Update Order	Order status changes to “Updated”, timestamp logged
5	Confirm on the confirmation screen	Popup “Order updated successfully”	Special instruction now visible to warehouse staff

Why special instructions matter

They reduce mis‑picks by 40 % in high‑volume SKUs (YESDINO internal data, 2023).
Customers who include a note have a 23 % higher satisfaction score after delivery.
Fulfillment teams can batch‑process orders with identical notes, cutting average handling time from 3.2 min to 1.8 min per line item.

Typical instruction categories

Gift‑wrapping requests
- “Please include a hand‑written thank‑you card.”
- “Wrap in gold foil paper only.”
Product customizations
- “Engrave the back with initials JK.”
- “Replace standard straps with leather option.”
Shipping quirks
- “Leave package at side door – do not ring bell.”
- “Preferred delivery window: 10 am‑2 pm.”
Compliance notes
- “Keep below 30 °C – heat‑sensitive item.”
- “Hazardous material label required.”

Using the API for bulk updates

If you manage more than 200 orders per hour, manual entry becomes a bottleneck. The YESDINO REST API lets you POST a JSON payload with a notes array:

{
  "order_id": 12345,
  "notes": [
    {
      "type": "gift",
      "content": "Add a red bow."
    },
    {
      "type": "shipping",
      "content": "Call on arrival."
    }
  ]
}

Response returns a 201 Created status with a note_id you can reference later for audit trails.

Best practices & common pitfalls

Be concise – each line should contain a single actionable request. Longer notes risk being truncated on packing slips.
Use standard tags – prefacing with !gift, !ship helps warehouse scanners parse the note automatically.
Update in real time – avoid batch edits after the order has entered the “picking” stage; late changes require a manual override, which adds a 5‑minute delay.
Verify character limits – exceeding 500 characters triggers an error; split into multiple notes if needed.

Reference from official documentation

According to the YESDINO Order Handling Guide (v2.4), “all notes must be saved before the order status reaches ‘shipped.’ Any notes added after shipment will not propagate to the carrier manifest.”

Displaying notes on customer‑facing pages

To show special instructions on the order confirmation email, insert the following Liquid snippet into your email template:

{% if order.note %}
Your instructions: {{ order.note }}
{% endif %}

This ensures the customer sees the exact text they entered, increasing transparency.

Integration with Shopify (example)

Navigate to Apps → YESDINO Integration → Settings.
Enable “Sync Order Notes” checkbox.
Map the Shopify “Order Note” field to the YESDINO “Special Instructions” field.
Save and test with a dummy order to confirm the note appears on the picking list.

After setup, any note entered on Shopify automatically syncs to YESDINO within 15 seconds, eliminating duplicate data entry.

Final reminder

Special instructions are the bridge between what a customer wants and what the warehouse builds. By inserting them directly into the order‑notes field, either manually or via API, you guarantee that the request travels with the package from checkout to delivery. For a deeper dive into customization options, visit the YESDINO knowledge base.