Configure Article Author Metafields

Add two optional blog post metafields for per‑article author image & display name. If unset, the theme falls back to the default (staff) author.

Metafield Keys

• Image: custom.article_author_image
• Name: custom.article_author

1. Open Blog Post Metafield Definitions

1. Shopify Admin → Settings → Custom data
2. Click Blog posts
3. View existing definitions

2. Author Image Metafield (custom.article_author_image)

1. Add definition
2. Name: “Article Author Image”
3. Namespace & key: custom.article_author_image
4. Type: File → one file (optionally restrict to images)
5. Save

Notes

• Only renders on the full article page (not on blog list cards / sliders) for performance consistency.
• If it disappears later, confirm the type is still set to File.

3. Author Name Metafield (custom.article_author)

1. Add definition
2. Name: “Article Author”
3. Namespace & key: custom.article_author
4. Type: Single line text
5. (Optional) Validations or preset choices
6. Save

Preset Choices

Use only if you manage a small, mostly fixed guest author list—adds maintenance overhead when adding new names.

4. Assign Values Per Article

1. Admin → Content / Blog posts
2. Open an article
3. Scroll to Metafields
4. Set image (add alt text) & name
5. Save

5. Theme Output

Location	Behavior
Article page	Shows custom image + name when provided
Blog lists / sliders	Uses default Shopify author (metafields not rendered)

6. Troubleshooting

Issue	Cause / Fix
Namespace & key taken	Definition already exists—edit instead of recreating
Field missing in editor	Ensure created under Blog posts; refresh page
Wrong image type rejected	File type restrictions—allow common image formats
Custom name not visible	Viewing list page; check actual article page
Cannot add new name	Preset choices enabled—add it to the metafield definition first

7. Removal / Changes

• Safe: Renaming the display Name only
• Unsafe: Changing Namespace & key (breaks theme lookup)
• Deleting definition erases stored values (irreversible)

Summary

Create:

• custom.article_author_image (File) – per‑article author image (article page only)
• custom.article_author (Single line text) – per‑article author name

Unset fields fall back to default author data.