update Open Source Docs from Roblox internal teams

Author: rbx-open-source-docs[bot]

content/common/navigation/engine/reference.yaml

@@ -4252,6 +4252,11 @@ navigation:
         type: engineapi
         source: /reference/engine/enums/CreateAssetResult.yaml
         ignoreTranslation: true
+      - title: CreateContentResult
+        path: /reference/engine/enums/CreateContentResult
+        type: engineapi
+        source: /reference/engine/enums/CreateContentResult.yaml
+        ignoreTranslation: true
       - title: CreateOutfitFailure
         path: /reference/engine/enums/CreateOutfitFailure
         type: engineapi

content/en-us/production/analytics/index.md

@@ -118,3 +118,15 @@ Avatar items you've sold automatically appear within the **Avatar Items** tab. H
 ### Track user acquisition
 
 The **Share Links** tab provides information about the **Link Visits** metric, which tracks how many users have arrived on your experience details page by clicking on the share link you created.
+
+## Access analytics in-experience
+
+The `Class.AnalyticsService.GetPlayerSegmentsAsync|AnalyticsService:GetPlayerSegmentsAsync()` method lets you query player analytics data directly in your experience at runtime. This enables you to tailor gameplay, onboarding, and monetization opportunities for each individual player based on characteristics, or **segments**, such as their spending behavior or overall length of time spent in your experience.
+
+By retrieving a player's segment information in-experience, you can dynamically adjust UI, offers, and gameplay systems to better match the player's profile and stage of engagement. For example, you can:
+
+- **Adjust store offerings by payer status** - Present store items that better match a player's purchase history and stage of progression. For example, players who haven't spent Robux yet might see lower-cost items that support early gameplay, while players who have previously purchased may see bundle options or broader upgrades.
+
+- **Adapt onboarding and progression using account age** - Newer players, such as those within their first 30 days of playing your experience, can receive additional tutorials, tooltips, and simplified content. You can also direct more experienced players toward advanced systems such as events, PvP areas, or end-game content.
+
+For implementation details, code samples, and the full list of available segment dimensions, see `Class.AnalyticsService:GetPlayerSegmentsAsync`.

content/en-us/reference/engine/classes/AnimationConstraint.yaml

@@ -11,63 +11,17 @@ summary: |
 description: |
   An `AnimationConstraint` constrains its `Class.Attachment|Attachments` so that
   they're offset by `Class.AnimationConstraint.Transform|Transform`.
+
+  For backwards compatibility with `Class.Motor6D`, `AnimationConstraint`
+  exposes read-only `C0`, `C1`, `Part0`, and `Part1` properties to help adopt
+  the `Class.StarterPlayer.AvatarJointUpgrade|AvatarJointUpgrade`.
 code_samples: []
 inherits:
   - Constraint
 descendants: []
 tags: []
 deprecation_message: ''
 properties:
-  - name: AnimationConstraint.C0
-    summary: ''
-    description: |
-      The `Class.AnimationConstraint.Attachment0|Attachment0`
-      `Class.Attachment.CFrame|CFrame` for backwards compatibility with
-      `Class.Motor6D.C0`.
-    code_samples: []
-    type: CFrame
-    tags:
-      - Hidden
-      - ReadOnly
-      - NotReplicated
-      - Deprecated
-    deprecation_message: ''
-    security:
-      read: None
-      write: None
-    thread_safety: ReadSafe
-    category: Data
-    serialization:
-      can_load: false
-      can_save: false
-    capabilities:
-      - Physics
-      - Animation
-  - name: AnimationConstraint.C1
-    summary: ''
-    description: |
-      The `Class.AnimationConstraint.Attachment1|Attachment1`
-      `Class.Attachment.CFrame|CFrame` for backwards compatibility with
-      `Class.Motor6D.C1`.
-    code_samples: []
-    type: CFrame
-    tags:
-      - Hidden
-      - ReadOnly
-      - NotReplicated
-      - Deprecated
-    deprecation_message: ''
-    security:
-      read: None
-      write: None
-    thread_safety: ReadSafe
-    category: Data
-    serialization:
-      can_load: false
-      can_save: false
-    capabilities:
-      - Physics
-      - Animation
   - name: AnimationConstraint.IsKinematic
     summary: |
       Toggles whether the constraint is kinematic or physically simulated.
@@ -135,56 +89,6 @@ properties:
     capabilities:
       - Physics
       - Animation
-  - name: AnimationConstraint.Part0
-    summary: ''
-    description: |
-      The `Class.AnimationConstraint.Attachment0|Attachment0`
-      `Class.Instance.Parent|Parent` for backwards compatibility with
-      `Class.Motor6D.Part0`.
-    code_samples: []
-    type: BasePart
-    tags:
-      - Hidden
-      - ReadOnly
-      - NotReplicated
-      - Deprecated
-    deprecation_message: ''
-    security:
-      read: None
-      write: None
-    thread_safety: ReadSafe
-    category: Data
-    serialization:
-      can_load: false
-      can_save: false
-    capabilities:
-      - Physics
-      - Animation
-  - name: AnimationConstraint.Part1
-    summary: ''
-    description: |
-      The `Class.AnimationConstraint.Attachment1|Attachment1`
-      `Class.Instance.Parent|Parent` for backwards compatibility with
-      `Class.Motor6D.Part1`.
-    code_samples: []
-    type: BasePart
-    tags:
-      - Hidden
-      - ReadOnly
-      - NotReplicated
-      - Deprecated
-    deprecation_message: ''
-    security:
-      read: None
-      write: None
-    thread_safety: ReadSafe
-    category: Data
-    serialization:
-      can_load: false
-      can_save: false
-    capabilities:
-      - Physics
-      - Animation
   - name: AnimationConstraint.Transform
     summary: |
       Describes the current animation offset of the constraint joint.

content/en-us/reference/engine/classes/AssetService.yaml

@@ -227,6 +227,48 @@ methods:
     thread_safety: Unsafe
     capabilities:
       - AssetCreateUpdate
+  - name: AssetService:CreateDataModelContentAsync
+    summary: |
+      Creates ephemeral, `Class.DataModel`-scoped content from the provided
+      content input.
+    description: |
+      Creates ephemeral, `Class.DataModel`-scoped content from the provided
+      content input.
+
+      If the server storage budget is exhausted during this call, the creation
+      will fail and the method will return
+      `Enum.CreateContentResult.StorageLimitExceeded` alongside an empty
+      `Datatype.Content` object.
+    code_samples: []
+    parameters:
+      - name: content
+        type: Content
+        default:
+        summary: |
+          Reference to the input content. Currently, this only supports
+          `Datatype.Content` wrapping a `Class.EditableMesh` or
+          `Class.EditableImage`.
+      - name: options
+        type: Dictionary?
+        default:
+        summary: |
+          Optional dictionary containing configuration controls for the created
+          `Class.DataModel` content. Currently no controls are surfaced and this
+          parameter exists for future functionality.
+    returns:
+      - type: Tuple
+        summary: |
+          A tuple containing an `Enum.CreateContentResult` indicating the
+          success or failure of the request, and the resulting
+          `Class.DataModel`-scoped `ContentSourceType.Opaque`
+          `Datatype.Content`.
+    tags:
+      - Yields
+    deprecation_message: ''
+    security: None
+    thread_safety: Unsafe
+    capabilities:
+      - DynamicGeneration
   - name: AssetService:CreateEditableImage
     summary: |
       Creates a new `Class.EditableImage`.
@@ -679,7 +721,12 @@ methods:
 
             - `Name` — Item name
 
-            - `Type` — Item type such as `"Asset"` .
+            - `Type` — Item type such as `"Asset"`
+
+            - `AssetType` — String representing the `Enum.AvatarAssetType`
+
+            - `SupportsHeadShapes` — Whether the asset supports head shape
+              swapping. Only present if `AssetType` is `"DynamicHead"`.
     tags:
       - Yields
     deprecation_message: ''

content/en-us/reference/engine/classes/AvatarEditorService.yaml

@@ -58,7 +58,9 @@ description: |
         "Id": 0,
         "Name": "string",
         "Type": "Asset",
-        "AssetType": 29
+        "AssetType": "string",
+        "SupportsHeadShapes": false,
+        "Owned": false
       }
     ],
     "IsRecolorable": false,
@@ -85,7 +87,9 @@ description: |
     "CreatorType": "User",
     "CreatorTargetId": 0,
     "CreatorName": "string",
-    "CreatorHasVerifiedBadge": false
+    "CreatorHasVerifiedBadge": false,
+
+    "SupportsHeadShapes": false
   }
   ```
 
@@ -115,6 +119,11 @@ description: |
       <td>string</td>
       <td>The asset type. Corresponds to <code>Enum.AvatarAssetType</code> values (e.g., <code>"Hat"</code>, <code>"Shirt"</code>). Only present if <code>ItemType</code> is <code>"Asset"</code>.</td>
     </tr>
+    <tr>
+      <td><code>SupportsHeadShapes</code></td>
+      <td>boolean</td>
+      <td>Whether the asset supports head shape swapping. Only present if <code>AssetType</code> is <code>"DynamicHead"</code>.</td>
+    </tr>
     <tr>
       <td><code>BundleType</code></td>
       <td>string</td>
@@ -178,11 +187,15 @@ description: |
     </tr>
     <tr>
       <td colspan="2"></td>
-      <td><code>AssetType</code>: The asset type as an integer. Corresponds to <code>Enum.AvatarAssetType</code>.</td>
+      <td><code>AssetType</code>: The asset type as a string. Corresponds to <code>Enum.AvatarAssetType</code> values (e.g., <code>"Hat"</code>, <code>"DynamicHead"</code>).</td>
     </tr>
     <tr>
       <td colspan="2"></td>
-      <td><code>Owned</code>: Whether the bundled item is owned by the current user. Only present in <code>Class.AvatarEditorService:GetItemDetailsAsync()</code>.</td>
+      <td><code>SupportsHeadShapes</code>: Whether the asset supports head shape swapping. Only present if <code>AssetType</code> is <code>"DynamicHead"</code>.</td>
+    </tr>
+    <tr>
+      <td colspan="2"></td>
+      <td><code>Owned</code>: Whether the bundled item is owned by the current user.</td>
     </tr>
     <tr>
       <td><code>IsRecolorable</code></td>
@@ -440,17 +453,26 @@ methods:
     capabilities:
       - AvatarAppearance
   - name: AvatarEditorService:ConformToAvatarRulesAsync
-    summary: ''
-    description: ''
+    summary: |
+      Returns a copy of the given `Class.HumanoidDescription` that conforms to
+      the platform Avatar rules.
+    description: |
+      This method also remaps classic face and classic head assets to their
+      corresponding Dynamic Head asset IDs, with the appropriate
+      `Class.BodyPartDescription.HeadShape|HeadShape` pre-applied. This
+      remapping happens automatically and requires no code changes.
     code_samples: []
     parameters:
       - name: humanoidDescription
         type: HumanoidDescription
         default:
-        summary: ''
+        summary: |
+          The `Class.HumanoidDescription` to conform.
     returns:
       - type: HumanoidDescription
-        summary: ''
+        summary: |
+          A new `Class.HumanoidDescription` that conforms to the platform Avatar
+          rules.
     tags:
       - Yields
     deprecation_message: ''
@@ -683,6 +705,37 @@ methods:
     capabilities:
       - Players
       - AssetRead
+  - name: AvatarEditorService:GetHeadShapesAsync
+    summary: |
+      Returns an array of head shape names that the `Class.Players.LocalPlayer`
+      owns.
+    description: |
+      Each head shape corresponds to a classic head owned by the user and can be
+      applied to any Dynamic Head that supports shape swapping (see
+      `Class.BodyPartDescription.HeadShape`).
+
+      This method requires the user to have accepted the
+      `Class.AvatarEditorService:PromptAllowInventoryReadAccess()` prompt.
+    code_samples:
+      - getting-owned-head-shapes
+    parameters: []
+    returns:
+      - type: Array
+        summary: |
+          An array of strings, each identifying a head shape owned by
+          `Class.Players.LocalPlayer`. Possible values include:
+          `"RobloxClassic"`, `"Blockhead"`, `"Cheeks"`, `"Chiseled"`,
+          `"CoolThing"`, `"EraserHead"`, `"FatHead"`, `"FlatTop"`,
+          `"GoldenKorbloxGeneral"`, `"GoldenMrRobot"`, `"KnightOfChivalry"`,
+          `"KnightOfCourage"`, `"ManHead"`, `"MercilessNinja"`, `"Narrow"`,
+          `"Paragon"`, `"Peabrain"`, `"Perfection"`, `"Roll"`, `"Roundy"`,
+          `"RoxBox"`, `"TheEngineer"`, `"Trim"`, `"WomanHead"`.
+    tags:
+      - Yields
+    deprecation_message: ''
+    security: None
+    thread_safety: Unsafe
+    capabilities: []
   - name: AvatarEditorService:GetInventory
     summary: |
       Returns an `Class.InventoryPages` object with information about owned
@@ -885,10 +938,11 @@ methods:
             "AssetType": {
               "Id": 31,
               "Name": "RightLeg"
-            }
+            },
             "CurrentVersionId": 16447385805,
             "Id": 11584239464,
-            "Name": "Anime Female - Right Leg"
+            "Name": "Anime Female - Right Leg",
+            "SupportsHeadShapes": false
           }
         ],
         "BodyColors": {
@@ -1172,7 +1226,9 @@ methods:
                 "Owned": true,
                 "Id": 0,
                 "Name": "string",
-                "Type": "string"
+                "Type": "string",
+                "AssetType": "string",
+                "SupportsHeadShapes": false
               }
             ],
             "Creator": {