Skip to content

Commit 54aade4

Browse files
github-actions[bot]github-actions[bot]
committed
sync: update documentation sources (2026-04-02 18:58 UTC)
1 parent b723834 commit 54aade4

1 file changed

Lines changed: 171 additions & 0 deletions

File tree

‎roblox/en-us/projects/assets/manager.md‎

Lines changed: 171 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -488,3 +488,174 @@ Quick actions are accessible by right‑clicking an asset name/tile and selectin
488488

489489
</TabItem>
490490
</Tabs>
491+
492+
### Search query language
493+
494+
Use search query language to refine how you find assets in your Asset Manager inventory. You can combine keywords, operators, and tags to filter, prioritize, or exclude results.
495+
496+
When combining multiple features, search terms are processed in the following order (highest to lowest priority): Exact search → Excluded terms → Optional terms → Asset ID tag → Created before → Created after → Updated before → Updated after → Numeric asset ID → Audio type.
497+
498+
<h5 style={{marginTop: '36px'}}>Query syntax</h5>
499+
500+
Use the following syntax to control how search terms are interpreted:
501+
502+
<table>
503+
<thead>
504+
<tr>
505+
<th>Feature</th>
506+
<th>Syntax</th>
507+
<th>Description</th>
508+
<th>Example</th>
509+
</tr>
510+
</thead>
511+
<tbody>
512+
<tr>
513+
<td>Exact phrase</td>
514+
<td>`"exact phrase"`</td>
515+
<td>Matches the phrase exactly.</td>
516+
<td>`"explosion sound"`</td>
517+
</tr>
518+
<tr>
519+
<td>Exclude term</td>
520+
<td>`-term` or `exclude:term`</td>
521+
<td>Removes results containing the term. You can use multiple `-` prefixes in one query to exclude more than one term.</td>
522+
<td>`sword -rusty`</td>
523+
</tr>
524+
<tr>
525+
<td>Optional term</td>
526+
<td>`term!` or `optional:term`</td>
527+
<td>Boosts results but doesn't require the term.</td>
528+
<td>`sword glowing!`</td>
529+
</tr>
530+
<tr>
531+
<td>Asset ID</td>
532+
<td>`1234567890` or `asset_id:123456`</td>
533+
<td>Pins matching assets to the top of the search results.</td>
534+
<td>`asset_id:123456`</td>
535+
</tr>
536+
<tr>
537+
<td>Date filter</td>
538+
<td>`created_after:YYYY-MM-DD`</td>
539+
<td>Filters by creation or update date.</td>
540+
<td>`created_after:2024-01-01`</td>
541+
</tr>
542+
<tr>
543+
<td>Audio type</td>
544+
<td>`music`, `sfx`, `sound effects`</td>
545+
<td>Filters audio assets by type. You must append the audio type at the **end** of your query.</td>
546+
<td>`explosion sfx`</td>
547+
</tr>
548+
</tbody>
549+
</table>
550+
551+
<h5 style={{marginTop: '36px'}}>Tags</h5>
552+
553+
Tags modify how search works, but aren't treated like search terms themselves. They only filter or rank your results. If a tag has a typo or an invalid date, it's treated as a regular search term instead.
554+
555+
Tags can use the formats `tag:value` or `tag=value`, and are not case-sensitive.
556+
557+
<table>
558+
<thead>
559+
<tr>
560+
<th>Tag</th>
561+
<th>Alternative syntax</th>
562+
<th>Description</th>
563+
<th>Example</th>
564+
</tr>
565+
</thead>
566+
<tbody>
567+
<tr>
568+
<td>`exclude`</td>
569+
<td>`excluded`</td>
570+
<td>Excludes one or more terms.</td>
571+
<td>`exclude:rusty`</td>
572+
</tr>
573+
<tr>
574+
<td>`optional`</td>
575+
<td>N/A</td>
576+
<td>Marks terms as optional.</td>
577+
<td>`optional:glowing`</td>
578+
</tr>
579+
<tr>
580+
<td>`asset_id`</td>
581+
<td>`assetId`</td>
582+
<td>Pins assets by ID.</td>
583+
<td>`asset_id:123456`</td>
584+
</tr>
585+
<tr>
586+
<td>`created_before`</td>
587+
<td>`createdBefore`</td>
588+
<td>Created on or before the specified date.</td>
589+
<td>`created_before:2024-01-01`</td>
590+
</tr>
591+
<tr>
592+
<td>`created_after`</td>
593+
<td>`createdAfter`</td>
594+
<td>Created after the specified date.</td>
595+
<td>`created_after:2024-01-01`</td>
596+
</tr>
597+
<tr>
598+
<td>`updated_before`</td>
599+
<td>`updatedBefore`</td>
600+
<td>Updated on or before the specified date.</td>
601+
<td>`updated_before:2024-01-01`</td>
602+
</tr>
603+
<tr>
604+
<td>`updated_after`</td>
605+
<td>`updatedAfter`</td>
606+
<td>Updated after the specified date.</td>
607+
<td>`updated_after:2024-01-01`</td>
608+
</tr>
609+
</tbody>
610+
</table>
611+
612+
<Alert severity="info">
613+
Some tags accept multiple values when you use brackets. For example, `exclude:[rusty, broken]` and `asset_id[123, 456]`.
614+
</Alert>
615+
616+
<h5 style={{marginTop: '36px'}}>Date formats</h5>
617+
618+
Date filters support multiple formats. Make sure to:
619+
620+
- Wrap dates in brackets if they have spaces (for example, `[March 10, 2026]`)
621+
- Use the US format `MM/DD/YYYY`
622+
- **Not** use natural language (for example, `yesterday` or `last week`)
623+
624+
<table>
625+
<thead>
626+
<tr>
627+
<th>Format</th>
628+
<th>Example</th>
629+
</tr>
630+
</thead>
631+
<tbody>
632+
<tr>
633+
<td>ISO 8601</td>
634+
<td>`2026-03-10`</td>
635+
</tr>
636+
<tr>
637+
<td>ISO with time</td>
638+
<td>`2026-03-10T14:30:00Z`</td>
639+
</tr>
640+
<tr>
641+
<td>US format</td>
642+
<td>`03/10/2026`</td>
643+
</tr>
644+
<tr>
645+
<td>Long form (requires brackets)</td>
646+
<td>`[March 10, 2026]`</td>
647+
</tr>
648+
<tr>
649+
<td>With time</td>
650+
<td>`[03/10/2026 2:30 PM]`</td>
651+
</tr>
652+
</tbody>
653+
</table>
654+
655+
<h5 style={{marginTop: '36px'}}>Example queries</h5>
656+
657+
- `"wooden crate" asset_id:99887766 created_after:2023-06-01 -damaged optional:painted`: Exactly matches "wooden crate", pins a specific asset by ID, filters by date, excludes "damaged", and ranks "painted" results higher.
658+
659+
- `explosion sfx -loop created_before:[December 31, 2023]`: Filters sound effects named "explosion", excludes looping variants, and limits the results by date.
660+
661+
- `125447393891114 sword glowing! -rusty`: Pins a specific asset by ID, searches for "sword", boosts "glowing", and excludes "rusty".

0 commit comments

Comments
 (0)