world vs scene metadata

creator/scene-editor/configure/scene-settings.md

@@ -20,34 +20,37 @@ The **Details** tab lets you configure several fields about your scene. These fi
 
 The following fields are available:
 
-* **Name**
-* **Description**
-*   **Thumbnail**
-
-    {% hint style="info" %} 
-    **💡 Tip**: If no thumbnail is provided, it uses the automatic capture you see on the scene's card. We recommend uploading a more attractive image 
-    {% endhint %}
-* **Categories**
-* **Creator name** (optional)
-* **Creator contact email** (optional)
-* **Creator wallet address** (optional)
+- **Name**
+- **Description**
+- **Thumbnail**
+
+  {% hint style="info" %}
+  **💡 Tip**: If no thumbnail is provided, it uses the automatic capture you see on the scene's card. We recommend uploading a more attractive image
+  {% endhint %}
+
+- **Categories**
+- **Creator name** (optional)
+- **Creator contact email** (optional)
+- **Creator wallet address** (optional)
 
 The thumbnail should be a .png image of a recommended size of 228x160 pixels. The minimum supported size is 196x143 pixels. The image may be stretched if the width-to-height proportions don’t match 228x160.
 
 See [scene metadata](../../sdk7/projects/scene-metadata.md) for more details on these fields.
 
+{% hint style="info" %}
+**📔 Note**: If you publish your scene to a [World](../../sdk7/publishing/publishing-options.md#decentraland-worlds), the World has its own name, description, and thumbnail, separate from the scene's. If the World contains a single scene, the World's metadata is updated to match the scene's details on every publish, so this panel is all you need to edit. If the World contains multiple scenes, the World's metadata can only be edited in the **Manage** tab of the Creator Hub. See [World metadata vs scene metadata](../publish/publish-scene.md#world-metadata-vs-scene-metadata).
+{% endhint %}
+
 {% hint style="warning" %}
 **📔 Note**: The scene's **Age Rating** is not edited on this panel. You can set the `rating` field directly in the `scene.json` file, or, for scenes published to a World, change the **Content Rating** in the Creator Hub's World Settings after publishing. Decentraland is an 18+ platform, so the rating to set is `A` for Adults. See [Age Rating](../../sdk7/projects/scene-metadata.md#age-rating).
 {% endhint %}
 
-
 ### Tipping
 
 You can receive tips from players who visit your scene. To enable tipping, got to the **Details** tab on the scene settings and provide an Ethereum address under **Creator wallet address**.
 
 ![
](../../.gitbook/assets/creator-wallet-address.png)
 
-
 When a player visits your scene, they will see a piggy bank icon on the top-left of the screen. Clicking on it opens a modal where they can send you a tip. This menu can also be accessed by opening your scene's info on the map.
 
 ![
](../../.gitbook/assets/TipIcon.png)
@@ -56,7 +59,6 @@ The tip modal allows the player to select the amount of MANA they want to send.
 
 ![
](../../.gitbook/assets/tipping-modal.png)
 
-
 You will receive a notification on the Decentraland notifications tab whenever a player sends you a tip.
 
 ## Layout
@@ -99,9 +101,9 @@ You can disable certain functionalities on your scene if you chose, in case they
 
 ![
](../../images/editor/scene-restrictions.png)
 
-* **Silence Voice Chat**: Prevent players on your scene from using voice chat.
-* **Disable Nearby Voice Chat**: Prevent players on your scene from using the nearby (proximity-based) voice chat.
-* **Disable Smart Wearables & Portable Experiences**: Prevent players from using [Smart Wearables](../../sdk7/projects/smart-wearables.md) or [Portable Experiences](../../sdk7/projects/portable-experiences.md).
+- **Silence Voice Chat**: Prevent players on your scene from using voice chat.
+- **Disable Nearby Voice Chat**: Prevent players on your scene from using the nearby (proximity-based) voice chat.
+- **Disable Smart Wearables & Portable Experiences**: Prevent players from using [Smart Wearables](../../sdk7/projects/smart-wearables.md) or [Portable Experiences](../../sdk7/projects/portable-experiences.md).
 
 ## Skybox Control
 

creator/scene-editor/faq/README.md

@@ -179,3 +179,16 @@ See [Worlds size limits](/creator/sdk7/projects/kinds-of-project.md#size-limits)
 
 </details>
 
+<details>
+<summary><strong>I edited my World's name, description, or thumbnail in the Manage tab, but it changed back after I published. Why?</strong></summary>
+
+A World has its own metadata (name, description, and thumbnail), separate from the metadata of each scene published to it.
+
+If your World contains a single scene, the World's metadata is updated to match the scene's metadata every time you publish. Any changes made in the World's **Settings** in the **Manage** tab will be overwritten on the next publish. To make the changes stick, edit the scene's settings instead (the pencil icon in the Scene Editor).
+
+If your World contains multiple scenes, the World's metadata is independent from the scenes, and the **Manage** tab is the only place to edit it.
+
+See [World metadata vs scene metadata](/creator/scene-editor/publish/publish-scene.md#world-metadata-vs-scene-metadata) for details.
+
+</details>
+

creator/scene-editor/get-started/manage-scenes.md

@@ -46,6 +46,8 @@ By default, projects created via the Scene Editor are kept inside a `Scenes` fol
 
 If you own a Decentraland NAME or ENS domain, you can publish scenes to your [Decentraland World](../../sdk7/publishing/publishing-options.md#decentraland-worlds). Worlds appear in the Scene Editor just like regular scenes, and you can publish to them using the same **Publish** button.
 
+A World has its own metadata (name, description, and thumbnail), separate from the metadata of each scene published to it. In Worlds with a single scene it's kept in sync with the scene's metadata automatically, in Worlds with multiple scenes it can only be edited in the **Manage** tab. See [World metadata vs scene metadata](../publish/publish-scene.md#world-metadata-vs-scene-metadata).
+
 ### Visualizing storage space
 
 Scenes published to Worlds count against a storage budget that is shared across all the Worlds owned by your wallet. The budget is calculated from your holdings: each Decentraland NAME or LAND parcel you own grants 100 MB, and every 2,000 MANA held in your wallet grants an additional 100 MB.

creator/scene-editor/publish/publish-scene.md

@@ -78,7 +78,7 @@ A World Owner can edit its settings by going into the desired World **Settings**
   - Content Rating
   - Categories
 
-The information added in **Details** will be shown in Decentraland Places and in the in-world World information once it is published.
+The information added in **Details** will be shown in Decentraland Places and in the in-world World information once it is published. Keep in mind that if the World contains a single scene, these details are overwritten by the scene's metadata on every publish. See [World metadata vs scene metadata](#world-metadata-vs-scene-metadata) below.
 
 - **Layout**: Only accessible in Multi-Scene Worlds. Contains information about all the World's published scenes.
   - Remove individual scenes by clicking the three dots and selecting **Remove from World**.
@@ -94,6 +94,27 @@ The information added in **Details** will be shown in Decentraland Places and in
 **📔 Note**: World Settings are only accessible to the World Owner (the address that minted the NAME). For more details about how to obtain a NAME, check the [Marketplace NAMEs section](https://decentraland.org/marketplace/names/claim).
 {% endhint %}
 
+### World metadata vs scene metadata
+
+A World and each scene published to it have two separate sets of metadata. Both include a name, a description, and a thumbnail:
+
+- **Scene metadata**: Belongs to the scene project, stored in its `scene.json` file. You edit it via the [scene settings](../configure/scene-settings.md) in the Scene Editor, and it's uploaded together with the scene every time you publish.
+- **World metadata**: Belongs to the World itself. You edit it in the World's **Settings**, in the **Manage** tab of the Creator Hub. This is the information shown in Decentraland Places and in the in-world World information.
+
+How these two relate depends on how many scenes the World contains:
+
+- **Empty World**: When you publish a scene to an empty World, the World's metadata is filled in from the scene's metadata.
+- **Single-scene World**: Every time you publish the scene, the World's metadata is updated to match the scene's metadata.
+- **Multi-scene World**: The World's metadata is fully independent from the metadata of each of its scenes. Publishing a scene never changes the World's metadata. The only way to change it is through the World's **Settings** in the **Manage** tab.
+
+In practice, if your World contains a single scene, you don't need to think of the World's metadata as a separate thing: just edit your scene's settings and publish, and the World will always reflect them.
+
+{% hint style="warning" %}
+**📔 Note**: In a single-scene World, any changes you make to the World's **Settings** in the **Manage** tab will be overwritten by the scene's metadata the next time you publish the scene. To make those changes stick, edit the scene's settings instead.
+{% endhint %}
+
+In a Multi-Scene World, the World's **Settings** in the **Manage** tab is the only place to edit the World's metadata.
+
 ### Multi-Scene Worlds
 
 A World can have multiple scenes, published by the World Owner or by other creators. This enables a collaborative environment where each parcel can be managed by different Collaborators.

creator/sdk7/projects/scene-metadata.md

@@ -46,6 +46,10 @@ The image on `navmapThumbnail` should be a path to an image file in the project
 
 In case you want other developers to be able to reach out to you, you can also add contact information to your scene.
 
+{% hint style="info" %}
+**📔 Note**: Worlds keep their own name, description, and thumbnail, separate from the scene's metadata. If a World contains a single scene, the World's metadata is updated from the scene's metadata on every publish. If it contains multiple scenes, the World's metadata is independent and can only be edited in the **Manage** tab of the Creator Hub. See [World metadata vs scene metadata](../../scene-editor/publish/publish-scene.md#world-metadata-vs-scene-metadata).
+{% endhint %}
+
 ## Categories
 
 You can add categories to your scene to help players explore Decentraland. These are used in the [Decentraland Places dApp](https://places.decentraland.org) to categorize each place and make it easier for players to find what they're interested in.

creator/sdk7/publishing/publishing.md

@@ -103,6 +103,10 @@ Keep the following in mind:
 * The scene has no parcel limitations (since January 2023)
 * All Worlds are automatically listed on the Places page unless you opt out as detailed below
 
+### World metadata
+
+A World has its own name, description, and thumbnail, separate from the metadata of the scenes published to it. When you publish to an empty World, or to a World that contains a single scene, the World's metadata is updated to match the scene's metadata on every publish. If the World contains more than one scene, its metadata is independent: publishing a scene doesn't change it, and it can only be edited in the **Manage** section of the Creator Hub. See [World metadata vs scene metadata](../../scene-editor/publish/publish-scene.md#world-metadata-vs-scene-metadata).
+
 ### Worlds storage budget
 
 Scenes deployed to Worlds count against a storage budget that is shared across all the Worlds owned by your wallet. The budget grows with your Decentraland holdings: