# Sharing with your team and publicly

Tiles can be shared with your team or with the entire internet. This is controlled by the `private` field in your tile's [`tile.json`](https://docs.tessl.io/distribute/pages/wpdogFLQtCeEnXfbelvK#tile.json) file.

## Understanding public vs private tiles

### Private tiles (`"private": true`) - Default

**Shared only with your team:**

* Only accessible to workspace members
* Not discoverable in public searches
* Useful for proprietary code, internal standards, company-specific content
* **Team sharing:** [Add members to your workspace](/reference/workspaces.md#add-member) to give them access

If you don't specify the `private` field in your `tile.json`, it defaults to `true` (private).

### Public tiles (`"private": false`)

**Shared with the entire internet:**

* Anyone can discover and install them via the Tessl Registry
* Appear in search results and on your workspace's public profile
* Useful for open source libraries, shared standards, community resources
* **Cannot be made private again once published**

## Making a tile public

**Warning:** Once you make a tile public, you cannot make it private again. Use this with caution.

To make a tile publicly discoverable, set `"private": false` in your [`tile.json`](https://docs.tessl.io/distribute/pages/wpdogFLQtCeEnXfbelvK#tile.json):

```json
{
  "name": "myworkspace/my-tile",
  "version": "1.0.0",
  "summary": "My public tile",
  "private": false,
  "docs": "docs/index.md"
}
```

Then publish (or republish) your tile:

```sh
tessl tile publish
```

Your tile is now publicly discoverable in the [Tessl Registry](https://tessl.io/registry) and accessible to anyone on the internet.

## Best practices

* **Start private** - Develop and test tiles privately before making them public
* **Use semantic versioning** - Especially important for public tiles that others depend on
* **Document thoroughly** - Include clear README files and usage examples
* **Validate before publishing** - Run `tessl tile lint` to check for issues

## Related documentation

* [Distributing via registry](/distribute/distributing-via-registry.md) - How to publish tiles
* [Configuration files](/reference/configuration.md) - tile.json field reference
* [Creating tiles](/create/creating-tiles.md) - How to create your own tiles


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tessl.io/distribute/sharing-tiles-publicly.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.