id,page,ref,title,content,breadcrumbs,references
facets:facets-metadata,facets,facets-metadata,Facets in metadata,"You can turn facets on by default for specific tables by adding them to a  ""facets""  key in a Datasette  Metadata  file. 
             Here's an example that turns on faceting by default for the  qLegalStatus  column in the  Street_Tree_List  table in the  sf-trees  database: 
             [[[cog
from metadata_doc import metadata_example
metadata_example(cog, {
  ""databases"": {
    ""sf-trees"": {
      ""tables"": {
        ""Street_Tree_List"": {
          ""facets"": [""qLegalStatus""]
        }
      }
    }
  }
}) 
             ]]] 
             [[[end]]] 
             Facets defined in this way will always be shown in the interface and returned in the API, regardless of the  _facet  arguments passed to the view. 
             You can specify  array  or  date  facets in metadata using JSON objects with a single key of  array  or  date  and a value specifying the column, like this: 
             [[[cog
metadata_example(cog, {
  ""facets"": [
    {""array"": ""tags""},
    {""date"": ""created""}
  ]
}) 
             ]]] 
             [[[end]]] 
             You can change the default facet size (the number of results shown for each facet) for a table using  facet_size : 
             [[[cog
metadata_example(cog, {
  ""databases"": {
    ""sf-trees"": {
      ""tables"": {
        ""Street_Tree_List"": {
          ""facets"": [""qLegalStatus""],
          ""facet_size"": 10
        }
      }
    }
  }
}) 
             ]]] 
             [[[end]]]","[""Facets""]",[]