Developer guides

These guides explain the behavior that a generated GraphQL schema cannot show on its own: how search strings are interpreted, how cursors and typed IDs should be handled, how commerce predicates are evaluated, and how discounts and media delivery work.

“Developer guides” is a better description than “Concepts” because these pages are implementation-oriented references with syntax, field tables, recipes, and operational advice. The URLs remain under /concepts so existing links do not break.

GraphQL foundations

  • Search query language — field filters, boolean logic, prefixes, date and price ranges, metadata, and metafields.
  • Pagination — forward and backward cursor pagination, page information, and stable traversal.
  • Typed IDs — resource prefixes, validation, storage, and passing IDs between APIs.

Commerce rules

  • Predicate language — shared syntax and the differences between cart, line-item, and product-price contexts.
  • Discounts — product discounts, cart discounts, codes, groups, priorities, and evaluation order.
  • Cart predicate language — every cart field, null behavior, units, and checkout-rule recipes.
  • Product predicate language — fields available while matching product price records and practical targeting recipes.

Media

  • Image optimization — responsive variants, formats, fitting, quality, DPR, and URL normalization.