Rendering References

References are the sources the assistant cites with an answer. They arrive on each result as result.payload.references — an array you loop over in the response template, rendering one card (the highlighted template) per source.

What a Reference Holds

FieldWhat it is
idThe reference's unique ID.
titleIts heading.
urlA link to the source.
datasetThe dataset/source it came from.
summaryAn AI-generated summary (when available).
bodyThe full text (may be empty).
status, owner, parent, foundTime, keyMetadata about the item.
typeThe content type — drives which card renders it (see the next topic).
metaOgImageURLA preview image, when the source has one.
pagesPage indices for a multi-page document, used to open the preview.
reactionThe visitor's reaction on the answer, when set.

Looping and Displaying

{% for reference in result.payload.references %}
  <article class="skdwn-ref">
    <h4>{{ reference.title }}</h4>
    {% if reference.metaOgImageURL %}
      <img src="{{ reference.metaOgImageURL }}" alt="{{ reference.title }}"/>
    {% endif %}
    {% if reference.summary %}
      <p>{{ reference.summary | ellipsis: 160 }}</p>
    {% endif %}
    <a href="{{ reference.url }}" target="_blank">Open</a>
  </article>
{% endfor %}

{{ }} prints a value; {% %} is logic. The ellipsis filter trims long text — one of many built-in filters.

Go Deeper


Contact us

Still need help?

Tell us what you want your website assistant to answer. We will help you map the right content, controls, and launch path.