Skip to main content
[StoryblokStoryID:15442356]

Live article: https://www.storyblok.com/faq/what-is-difference-between-story-id-and-uuid


What is the difference between the id, uuid, and _uid?

The story id is the legacy default ID. It is included in the API response to not introduce any breaking changes. It is strongly recommended to use the uuid in your projects. A story's uuid is unique throughout a Storyblok space.

Copy to clipboard
        
      {
  "story": {
    "name": "Home",
    "created_at": "2024-12-12T12:26:45.709Z",
    "published_at": "2024-12-12T16:58:56.117Z",
    "updated_at": "2024-12-12T16:58:56.131Z",
+    "id": 594732881,
+    "uuid": "1de2df45-6c23-4e86-b9c4-508a27f17df7",
    "content": {
    }
  },
  "cv": 1734022736,
  "rels": [],
  "links": []
}
    

What is the _uid?

The _uid constitutes the ID of each individual component within a story. It is required for certain functionality of the Visual Editor, i.e., opening components in the editor upon clicking on them in the preview environment. A component's _uid is only unique within the scope of a particular story.

Copy to clipboard
        
      {
  "story": {
    "name": "Home",
    "created_at": "2024-12-12T12:26:45.709Z",
    "published_at": "2024-12-12T16:58:56.117Z",
    "updated_at": "2024-12-12T16:58:56.131Z",
    "id": 594732881,
    "uuid": "1de2df45-6c23-4e86-b9c4-508a27f17df7",
    "content": {
+      "_uid": "efe14cd9-4023-44dd-b221-d2b63a5d3597",
      "body": [
        {
+          "_uid": "46dc611d-5f23-44fc-b4d8-36b28a82d1c2",
          "headline": "Hello world!",
          "component": "teaser"
        },
        {
+          "_uid": "e4a50a8c-3591-4a4c-a0d5-b81d10e0d8b7",
          "columns": [
            {
+              "_uid": "36061262-f935-44cd-b3ee-771957f2d91e",
              "name": "Feature 1",
              "component": "feature"
            },
            {
+              "_uid": "7577e22f-754e-4112-b42b-cb7d38ea64ac",
              "name": "Feature 2",
              "component": "feature"
            },
            {
+              "_uid": "7e6d281f-3fc8-46d1-87ce-6f9fd889a3b3",
              "name": "Feature 3",
              "component": "feature"
            }
          ],
          "component": "grid"
        }
      ],
      "component": "page"
    }
  },
  "cv": 1734022736,
  "rels": [],
  "links": []
}