AEM Architecture Notes

Technical articles on Adobe Experience Manager, AEM migration, and Edge Delivery Services by Alberto Zarza Martín.

AEM Architecture

Why AEM Architects Should Care About Structured Data and GEO

How structured data and generative engine optimization (GEO) are becoming part of the content architect's job, not just marketing's.

May 25, 2026 · 6 min read
AEM Migration

Planning a Zero-Downtime AEM LTS Cutover: A Migration Runbook

A cutover runbook template for moving from AEM 6.5.x to 6.5 LTS in production without a maintenance window.

May 18, 2026 · 8 min read
Performance

AEM Clientlibs Optimization for Faster Page Loads

Practical techniques for reducing clientlib payload and improving Core Web Vitals on traditional AEM Sites pages.

May 11, 2026 · 5 min read
Adobe Integrations

Adobe Target / Web SDK (Alloy) Integration with AEM: Common Pitfalls

The most frequent misconfigurations when wiring Adobe Target through the Web SDK (Alloy) into an AEM front end.

May 4, 2026 · 6 min read
Performance

Building a CDN + Dispatcher Strategy for High-Traffic AEM Sites

How to layer a CDN in front of AEM Dispatcher for high-traffic sites, covering cache invalidation, origin shielding, and failover.

April 27, 2026 · 7 min read
AEM Architecture

AEM Authentication Patterns: Encapsulated Tokens vs CUG

Comparing Encapsulated Token authentication and Closed User Groups for gating AEM content, with guidance on when to use each.

April 20, 2026 · 6 min read
Operations

Replication and Publish Queue Troubleshooting in AEM

A methodical approach to diagnosing stuck or growing replication queues between AEM author and publish instances.

April 13, 2026 · 6 min read
AEM Architecture

AEM GraphQL Persisted Queries: A Practical Guide

How persisted GraphQL queries work in AEM, why they matter for headless delivery, and how to organize them for maintainability at scale.

April 6, 2026 · 6 min read
AEM Architecture

Designing a Content Fragment Model for Multi-Brand Sites

How to structure Content Fragment Models so a single AEM instance can serve multiple brands without duplicating content or logic.

March 30, 2026 · 7 min read
AEM Development

AEM Dynamic Media / Scene7 Asset Naming and Deduplication Explained

Why Dynamic Media appends suffixes like -1 to asset names, how deduplication works internally, and how to design a naming convention that avoids it.

March 23, 2026 · 5 min read
AI & Automation

Adobe GenStudio for AEM Marketers: What Architects Should Know

A technical overview of Adobe GenStudio's role alongside AEM, and the integration points architects need to plan for before rollout.

March 16, 2026 · 6 min read
AI & Automation

Integrating Adobe Firefly Services into an AEM Content Pipeline

How to architect an image generation pipeline with Adobe Firefly Services feeding assets into AEM DAM, including domain whitelisting and API considerations.

March 9, 2026 · 7 min read
AEM Development

Sling Models Best Practices for Maintainable AEM Code

Patterns that keep Sling Models testable and resilient as an AEM codebase grows, including injector ordering, adapter caching, and exporter design.

March 2, 2026 · 7 min read
AEM Development

Debugging Common OSGi Bundle Startup Failures in AEM

A troubleshooting checklist for OSGi bundles stuck in Installed or Resolved state, covering package imports, service references, and cyclic dependencies.

February 23, 2026 · 6 min read
Performance

AEM Dispatcher Configuration Mistakes That Cause Cache Misses

The most common Dispatcher rule and cache header mistakes that silently kill cache hit ratio on AEM publish farms.

February 16, 2026 · 6 min read
Edge Delivery Services

Getting Started with Universal Editor and Content Fragments

An architect's introduction to authoring with the Universal Editor on top of Content Fragments, and where it fits versus classic component authoring.

February 9, 2026 · 7 min read
Edge Delivery Services

AEM Classic Sites vs Edge Delivery Services: Architecture Comparison

Comparing traditional AEM Sites rendering with Edge Delivery Services (EDS) across performance, authoring experience, and infrastructure cost.

February 2, 2026 · 8 min read
AEM Migration

javax to jakarta Namespace Migration in AEM LTS

A step-by-step approach to migrating Servlet and JCR API imports from javax.* to jakarta.* during an AEM 6.5 LTS upgrade.

January 26, 2026 · 5 min read
AEM Migration

Java 17 Migration Guide for AEM 6.5 LTS Bundles

How to prepare OSGi bundles and Maven builds for the jump to Java 17 required by AEM 6.5 LTS, including common compilation and reflection errors.

January 19, 2026 · 7 min read
AEM Migration

AEM 6.5 to 6.5 LTS Migration: What Actually Breaks in Custom Code

A practical breakdown of what commonly fails when migrating AEM 6.5.x custom code to 6.5 LTS: OSGi bundles, deprecated APIs, and dependency conflicts.

January 12, 2026 · 6 min read