id,page,ref,title,content,breadcrumbs,references
configuration:configuration-reference,configuration,configuration-reference,,"The following example shows some of the valid configuration options that can exist inside  datasette.yaml . 
             [[[cog
from metadata_doc import config_example
import textwrap
config_example(cog, textwrap.dedent(
  """"""
    # Datasette settings block
    settings:
      default_page_size: 50
      sql_time_limit_ms: 3500
      max_returned_rows: 2000

    # top-level plugin configuration
    plugins:
      datasette-my-plugin:
        key: valueA

    # Database and table-level configuration
    databases:
      your_db_name:
        # plugin configuration for the your_db_name database
        plugins:
          datasette-my-plugin:
            key: valueA
        tables:
          your_table_name:
            allow:
              # Only the root user can access this table
              id: root
            # plugin configuration for the your_table_name table
            # inside your_db_name database
            plugins:
              datasette-my-plugin:
                key: valueB
    """""")
  ) 
             ]]] 
             [[[end]]]","[""Configuration""]",[]
configuration:configuration-reference-canned-queries,configuration,configuration-reference-canned-queries,Canned queries configuration,"Canned queries  are named SQL queries that appear in the Datasette interface. They can be configured in  datasette.yaml  using the  queries  key at the database level: 
                 [[[cog
from metadata_doc import config_example, config_example
config_example(cog, {
    ""databases"": {
       ""sf-trees"": {
           ""queries"": {
               ""just_species"": {
                   ""sql"": ""select qSpecies from Street_Tree_List""
               }
           }
       }
    }
}) 
                 ]]] 
                 [[[end]]] 
                 See the  canned queries documentation  for more, including how to configure  writable canned queries .","[""Configuration"", null]",[]
configuration:configuration-reference-permissions,configuration,configuration-reference-permissions,Permissions configuration,"Datasette's  authentication and permissions  system can also be configured using  datasette.yaml . 
                 Here is a simple example: 
                 [[[cog
from metadata_doc import config_example
import textwrap
config_example(cog, textwrap.dedent(
  """"""
    # Instance is only available to users 'sharon' and 'percy':
    allow:
      id:
      - sharon
      - percy

    # Only 'percy' is allowed access to the accounting database:
    databases:
      accounting:
        allow:
          id: percy
  """""").strip()
  ) 
                 ]]] 
                 [[[end]]] 
                 Access permissions in datasette.yaml  has the full details.","[""Configuration"", null]",[]
configuration:configuration-reference-plugins,configuration,configuration-reference-plugins,Plugin configuration,"Datasette plugins  often require configuration. This plugin configuration should be placed in  plugins  keys inside  datasette.yaml . 
                 Most plugins are configured at the top-level of the file, using the  plugins  key: 
                 [[[cog
from metadata_doc import config_example
import textwrap
config_example(cog, textwrap.dedent(
  """"""
    # inside datasette.yaml
    plugins:
      datasette-my-plugin:
        key: my_value
    """""").strip()
  ) 
                 ]]] 
                 [[[end]]] 
                 Some plugins can be configured at the database or table level. These should use a  plugins  key nested under the appropriate place within the  databases  object: 
                 [[[cog
from metadata_doc import config_example
import textwrap
config_example(cog, textwrap.dedent(
  """"""
    # inside datasette.yaml
    databases:
      my_database:
        # plugin configuration for the my_database database
        plugins:
          datasette-my-plugin:
            key: my_value
      my_other_database:
        tables:
          my_table:
            # plugin configuration for the my_table table inside the my_other_database database
            plugins:
              datasette-my-plugin:
                key: my_value
  """""").strip()
  ) 
                 ]]] 
                 [[[end]]]","[""Configuration"", null]",[]
configuration:configuration-reference-settings,configuration,configuration-reference-settings,Settings,"Settings  can be configured in  datasette.yaml  with the  settings  key: 
                 [[[cog
from metadata_doc import config_example
import textwrap
config_example(cog, textwrap.dedent(
  """"""
    # inside datasette.yaml
    settings:
      default_allow_sql: off
      default_page_size: 50
    """""").strip()
  ) 
                 ]]] 
                 [[[end]]] 
                 The full list of settings is available in the  settings documentation . Settings can also be passed to Datasette using one or more  --setting name value  command line options.`","[""Configuration"", null]",[]