RFC: Headless WP Issues & Struggles #8

We want to create a living list of WP things that are difficult to use in a Headless architecture. These will fall into roughly 3 categories.

• Things that WP makes hard because it's not designed to be headless or whatever
• Things that are just complicated to integrate but aren't particularly an issue with WP
• Community issues that aren't technical in nature

I'm sorry to the public who don't have access to some internal things. Feel free to comment on what you find hard in Headless WP. We'll put the final list here for all to see.

Community Issues

• Content: WP Developers don't know where to turn for HWP docs and support.

WP Issues

• Absolute URLs: WP Often embeds Absolute URLs in content that doesn't correctly point to a headless front-end
• Content Previews: WP Post Previews are broken cause WP is no longer in control of the front-end (ACF specifically is extra impossible)
• RSS Feeds: WP native RSS feeds are unusable by default in the front end (adding /rss for every route doesn't just work).
• Application Access: some APIs could/should be authenticated but are often left public due to lack of auth methods
• Short Codes: Don't process in API responses
• Opinionated Routing: Unlike most headless CMSes WP has opinions on how routing should work via Permalinks. Keeping this in sync with the JS front-end can be cumbersome. For example, creating a new post type using JS routing would require adding a new route to your front-end app. Relying on WP for routing means that a new Post Type can use an existing template.
• Content Styling: Blocks especially provide a lot of power to layout content, but getting the styles/JS into the front-end app proves difficult. (this could be an integration issue too but gonna put it here too as it bridges between the categories)

Integration Issues

• Menus: must be enabled by a theme and locations configured
• Lack of front-end control
  • SEO: SEO plugins don't embed the goods cause they can't control the frontend and sitemaps are on the backend
  • Forms: lack of clarity and easy plug-n-play forms
  • Comments: they're hard implement
  • Redirects: plugins SEO/standalone redirects can't redirect
  • WP Head/Footer: These concepts don't exist in headless
• Private Content: WP auth system lets plugins control content to specific users based on payment/membership/etc
• Media in Content: Media embedded in content often needs custom parsing to optimize with modern frameworks like NextImage. Is media slow-serving because it is not on specialty CDNs?
• Muli WP Sites: Whether Multisite or not managing a JS client working across multiple rest/graphql APIs can be difficult
• Caching: Due to the potentially multiple layers of caching (WP, GraphQL, Next.js/etc., network, browser), folks often find caching confusing, unclear, and incorrect. (RFC: Headless WP Issues & Struggles #8 (comment))
• Meta Queries: Users often reach for meta queries to do advanced when they shouldn't. RFC: Headless WP Issues & Struggles #8 (comment)

Working Docs

• David Notes
• Colin Notes
• Iona Notes
• Current Faust Features