Feed template merge-tag contract

Feed templates render one item in an archive, listing or faceted result. They expose post/product fields, media, taxonomy/meta, conditional blocks and supported nested components.

Common tags include post_id, title, permalink, author, author_url, comments, post_content, excerpt, featured_image, meta, taxonomy_terms, gallery, video_from_url, button_from_meta and feed_from_meta, plus WooCommerce-specific values where a product context exists.

Keep the card’s outer markup valid when an optional value is empty. A missing image, excerpt, taxonomy term, price, or author must not leave an empty link, heading, separator, or inaccessible control. Use the documented conditions around the complete optional fragment.

Avoid recursively embedding a feed from a field that can refer back to the same content path. When feed_from_meta is appropriate, bound the relationship in the content model and test empty, one-item, and multiple-item cases.

Review the template in its real archive context with pagination or facets enabled. A correct standalone card can still fail when repeated IDs, expensive per-item work, or oversized media are multiplied across a result page.

Do not query arbitrary database values from a template. Add the needed structured field to the content model/index and use its documented tag. See Feed template merge tags for the full current catalog and attributes.