alt_media_text option doesn't apply to references on page.retrieve

[saltmade]

• We have a reference field on one of our page types called related_guides
  
• When I page.retrieve, adding alt_media_text to the PageRetrieveParams I don't see the expanded version of those fields in the nested reference
  

[ViolanteCodes]

@saltmade thank you for opening this and providing the images

@LenardMarcin do you want me to open a ticket via trello, or do you have someone you want to assign this to directly?

[marcin-pece]

I think it would be good to create a task as it could complex task
CC @LenardMarcin

[ViolanteCodes]

alt_media_text option doesn't apply to references on page.retrieve

[ViolanteCodes]

cc @mtrono I don't know if this ticket moved to new workflow, so I wanted to highlight it

[saltmade]

Just checking in, is this still in-progress?

[ViolanteCodes]

@saltmade Thank you for your patience on this late reply; I was out on vacation for a week, and then I knew we had some planning meetings, and I wanted to make sure to confirm intended date before I gave you a reply.

In short, yes, this is still in-progress. Unfortunately, it did get bumped a quarter on the roadmap, so the tentative intended date of completion is by end of year this year. Please let us know if you have further questions!

[ViolanteCodes]

@saltmade I'm investigating this issue, and unfortunately, I'm not able to replicate it based on the current information.

using a page.retrieve call with params of {'alt_media_text': 1}, where the test-page has a reference field called reference_to_media_page, where the field is a reference to page type media that has a media object with alt text:

try { const newData = await butterCMS.page.retrieve( "*", "test-page", {"alt_media_text": 1} ) console.log(newData.data.data.fields);

I get:
{ reference_to_media_page: [ { slug: 'media-page', name: 'media page', published: '2025-11-13T15:57:59.521133Z', updated: '2025-11-13T15:57:59.521133Z', scheduled: null, status: 'published', page_type: 'media_page', fields: [Object] } ] }

When I expand that object:

console.log(newData.data.data.fields.reference_to_media_page[0]);

I see the alt text in the response:

{
  slug: 'media-page',
  name: 'media page',
  published: '2025-11-13T15:57:59.521133Z',
  updated: '2025-11-13T15:57:59.521133Z',
  scheduled: null,
  status: 'published',
  page_type: 'media_page',
  fields: {
    image_field: {
      alt: 'Alt text goes here',
      url: 'https://d2wzhk7xhrnk1x.cloudfront.net/f9Sen4QQcyVHSDZzI75w_butter-blog-post.jpg'
    }
  }
}

Are you able to provide more context? If you use the intercom bubble when you log in, you can let our customer success team know that you are working with Maria on a github issue and I've requested more information. If you could provide the customer success team with the page you're trying to fetch and an example of the call you're making (e.g., the exact page.retrieve call), we should be able to debug further.