---
updatedAt: 2025-11-11T16:38:41.000Z
agentTools:
  projectIndex: https://beamable2.readme.io/llms.txt
---

# Content - Filtering

<ul class="breadcrumb">
  <li><a href="/docs/">Docs</a></li>
  <li><a href="/docs/profile-storage">Profile & Storage</a></li>
  <li><a href="/docs/content-feature-overview">Content</a></li>
  <li>Content - Validation</li>
</ul>

<div class="links">
  <a class="link normal" href="/docs/content-feature-overview" style={{textDecoration: 'none'}}>Overview</a>
  <a class="link normal" href="/docs/content-guide" style={{textDecoration: 'none'}}>Guide</a>
  <a class="link normal" href="/docs/content-code" style={{textDecoration: 'none'}}>Code</a>
  <a class="link normal" href="/docs/content-custom-content" style={{textDecoration: 'none'}}>Custom Content</a>
  <a class="link normal" href="/docs/content-remote-configuration" style={{textDecoration: 'none'}}>Remote Configuration</a>
  <a class="link normal" href="/docs/content-validation" style={{textDecoration: 'none'}}>Validation</a>
  <a class="link active" href="/docs/content-filtering" target="_blank" style={{textDecoration: 'none'}}>Filtering</a>  
  <a class="link normal" href="/docs/content-manager-overview" target="_blank" style={{textDecoration: 'none'}}>Tool Window</a>  
</div>

## Content Filtering

Content can be filtered by tag, type, or id. The Content Manager Window can filter the viewable content. Content can be filtered from the SDK as well.

### Filter Strings

Content filter strings can be entered into the Content Manager's search box, or into the `GetManifest` function in the SDK. Filter strings follow the same conventions that Unity search strings do. The type of the filter is specified first, followed by a `:` character, and the query for the filter is specified last.

#### Type Filtering

To filter by content type, use the `t` filter constraint. The following table shows examples of type constraints.

| Filter String      | Description                                                         |
| ------------------ | ------------------------------------------------------------------- |
| `t:currency`       | returns all content elements that are of type "currency"            |
| `t:currency items` | returns all content elements that are of type "currency" or "items" |

#### Tag Filtering

To filter by content tag, use the `tag` filter constraint. The following table shows examples of tag constraints.

| Filter String | Description                                                        |
| ------------- | ------------------------------------------------------------------ |
| `tag:a`       | returns all content elements that have the "a" tag                 |
| `tag:a b`     | returns all content elements that have the "a" tag and the "b" tag |

#### Id Filtering

To filter by content id, use the `id` filter constraint, or use no constraint at all. The `id` filter constraint is the default constraint. The following table shows examples of id constraints.

| Filter String | Description                                                    |
| ------------- | -------------------------------------------------------------- |
| `gems`        | returns all content elements that contain "gems" in their name |
| `id:gems`     | returns all content elements that contain "gems" in their name |

#### Compound Filtering

Multiple filter constraints may be combined if separated by a `,` character. The following table shows examples of compound constraints.

| Filter String          | Description                                                                                |
| ---------------------- | ------------------------------------------------------------------------------------------ |
| `t:currency, gems`     | returns all content elements that are of type "currency", and contain "gems" in their name |
| `t:currency, tag:base` | returns all content elements that are of type "currency", and have the "base" tag          |
| `gems, tag:a`          | returns all content elements that contain "gems" in their name, and have the "a" tag       |

### Structured Filtering

In the SDK, the `GetManifest` function accepts a filter string, as shown in the example below.

```csharp
public async Promise<IList<IContentObject>> LoadMyTaggedContent(string tag)
{
    var ctx = BeamContext.Default;

    // load a manifest that only has content including the request tag
    var manifest = await ctx.Content.GetManifest($"tag:{tag}");

    // resolve all the content in that manifest
    var content =  await manifest.ResolveAll();

    return content;
}	
```

Filter strings do not grant type safety in the SDK, and are more prone to bugs and unintentional filtering. The above sample can be re-written with the `ContentQuery` class instead of the filter string. The `ContentQuery` allows the developer to specify constraints in a type safe way and will avoid filter serialization bugs.

```csharp
public async Promise<IList<IContentObject>> LoadMyTaggedContent(string tag)
{
   var ctx = BeamContext.Default;
   var manifest = await ctx.Content.GetManifest(new ContentQuery
   {
     TagConstraints = new HashSet<string>{ tag }
   });
   var content =  await manifest.ResolveAll();
   return content;
}
```

<HTMLBlock>{`
<style>
  .links {
    padding: 0 1em 1em 0;
    display: flex;
    flex-flow: row wrap;
  }

  .link {
    margin-right: 2em;
    margin-bottom: 0.75em;
    padding: 0.3em 1.5em;
    box-sizing: border-box;
  }

  .active {
    border: 1px solid #4274f6;
    background-color: #4274f6;
    color: white;
  }

  .normal {
    background-color: white;
    border: 1px solid gray;
    cursor:pointer;
    text-decoration: none;
  }

  .normal:active {
    background-color: #c4d4ff;
  }

  .normal:hover {
    background-color: #c4d4ff;
  }

  .active:active {
    color: white;
  }

  .active:hover {
    color: white;
  }
  
  ul.breadcrumb {
    padding: 10px 16px;
    list-style: none;
  }
  ul.breadcrumb li {
    display: inline;
    font-size: 18px;
  }
  ul.breadcrumb li+li:before {
    padding: 8px;
    color: black;
    content: "/\\00a0";
  }
  ul.breadcrumb li a {
    color: #0275d8;
    text-decoration: none;
  }
  ul.breadcrumb li a:hover {
    color: #01447e;
    text-decoration: underline;
  }
  
     @media only screen and (max-width:700px){
 		    ul.breadcrumb {
    padding-top:0;
          padding-left:0;
  }
      
       .link {
    margin-right: 1em;
         margin-bottom:1em;
  }
  }
</style>
`}</HTMLBlock>