---
title: Merchant notes on store credit transactions - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/posts/merchant-notes-on-store-credit-transactions
  md: >-
    https://shopify.dev/changelog/posts/merchant-notes-on-store-credit-transactions.md
metadata:
  effectiveApiVersion: 2027-01
  affectedApi:
    - displayName: GraphQL Admin API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2026-09-29T07:40:29-04:00'
  postedAt: '2026-11-06T04:00:00-05:00'
  updatedAt: '2026-11-05T16:45:45-05:00'
  effectiveAt: '2026-10-09T12:00:00-04:00'
---

November 6, 2026

# Merchant notes on store credit transactions

DateNovember 6, 2026

Version[2027-01](https://shopify.dev/changelog?api_version=2027-01)

FlagsNew

Tags[GraphQL Admin API](https://shopify.dev/changelog?api_type=admin-graphql)

As of GraphQL Admin API version `2027-01`, you can attach a merchant-only note when crediting or debiting a store credit account and read those notes on store credit transactions. Notes are optional, so existing integrations continue to work without changes or required updates.

## What changed

* [`StoreCreditAccountCreditInput`](https://shopify.dev/docs/api/admin-graphql/2027-01/input-objects/StoreCreditAccountCreditInput) and [`StoreCreditAccountDebitInput`](https://shopify.dev/docs/api/admin-graphql/2027-01/input-objects/StoreCreditAccountDebitInput) accept an optional `note` string.
* `StoreCreditAccountTransaction.note` returns the stored note for credit, debit, and debit-revert transactions, or `null` when no note is set. Expiration transactions always return `null`.
* Notes support up to 5,000 characters. Longer notes return a `NOTE_TOO_LONG` user error and the API doesn’t create the transaction.
* Notes are for merchants only and aren't visible to customers. You can set a note when you create a transaction, but you can’t edit a note on an existing transaction.

## Who's affected

This change applies to apps that manage store credit using GraphQL Admin API version `2027-01` or later. Versions `2026-10` and earlier don’t expose these fields.

Existing `read_store_credit_account_transactions` and `write_store_credit_account_transactions` access scopes and permission requirements still apply. No new scope is required.

## What to do

You don’t need to change existing integrations. To start using notes:

1. Target GraphQL Admin API version `2027-01` or later in your app.
2. When you create a credit or debit, include `note` in the input.
3. Select `note` on the returned `StoreCreditAccountTransaction` to read the stored value.
4. Test in a dev store by creating a transaction with a note and verifying that the response includes the expected `note` string.

## Related docs

* [`storeCreditAccountCredit` mutation reference](https://shopify.dev/docs/api/admin-graphql/2027-01/mutations/storeCreditAccountCredit)
* [`storeCreditAccountDebit` mutation reference](https://shopify.dev/docs/api/admin-graphql/2027-01/mutations/storeCreditAccountDebit)