Skip to main content

Content item name metadata update

Release date: 7th August 2024

This release includes a small but useful update for developers. The name field of a content item's metadata is now updated when the content item is renamed. A new version is also created in the content item revision history.

Renaming a content item and _meta.name
Link copied!

The JSON returned when a content item is retrieved from the CMS includes some useful metadata as part of the _meta object. This includes the content item's ID, schema and name. _meta.name is now updated with the new name provided when a content item is renamed, or when it is copied and renamed.

Previously _meta.name would still contain the original name even when the content item was renamed or copied.

This change in functionality should not affect developers, but you should check that your code does not assume that _meta.name is immutable.

Rename example
Link copied!

In this example we're renaming an item from "Summer Collection Banner" to "Summer 2024 Collection".

Renaming a content item

Once renamed, a new version is created in the content revision history. _meta.name is set to "Summer 2024 Collection" as shown in the JSON returned from the Content Delivery URL when the item is republished (or from the VSE URL for the unpublished, latest version).

{
  "content": {
    "_meta": {
      "name": "Summer 2024 Collection",
      "schema": "https://schema-examples.com/tutorial-banner-new",
      "deliveryId": "ab5d5477-d84a-4db4-b790-6cc33e193cc7"
    },
    "background": {
      "_meta": {
        "schema": "http://bigcontent.io/cms/schema/v1/core#/definitions/image-link"
      },
      "id": "880ecdc9-71ee-4284-a6b9-15a5b138323c",
      "name": "woman-orange-dress",
      "endpoint": "ampproduct",
      "defaultHost": "cdn.media.amplience.net"
    },
    "headline": "The Summer Collection",
    "strapline": "Coming Soon",
    "calltoactiontext": "Find Out More",
    "calltoactionurl": "http://example.com/sale"
  }
}

Content delivery concepts