{"id": "writing_plugins:writing-plugins-designing-urls", "page": "writing_plugins", "ref": "writing-plugins-designing-urls", "title": "Designing URLs for your plugin", "content": "You can register new URL routes within Datasette using the  register_routes(datasette)  plugin hook. \n             Datasette's default URLs include these: \n             \n                 \n                     /dbname  - database page \n                 \n                 \n                     /dbname/tablename  - table page \n                 \n                 \n                     /dbname/tablename/pk  - row page \n                 \n             \n             See  Pages and API endpoints  and  Introspection  for more default URL routes. \n             To avoid accidentally conflicting with a database file that may be loaded into Datasette, plugins should register URLs using a  /-/  prefix. For example, if your plugin adds a new interface for uploading Excel files you might register a URL route like this one: \n             \n                 \n                     /-/upload-excel \n                 \n             \n             Try to avoid registering URLs that clash with other plugins that your users might have installed. There is no central repository of reserved URL paths (yet) but you can review existing plugins by browsing the  plugins directory . \n             If your plugin includes functionality that relates to a specific database you could also register a URL route like this: \n             \n                 \n                     /dbname/-/upload-excel \n                 \n             \n             Or for a specific table like this: \n             \n                 \n                     /dbname/tablename/-/modify-table-schema \n                 \n             \n             Note that a row could have a primary key of  -  and this URL scheme will still work, because Datasette row pages do not ever have a trailing slash followed by additional path components.", "breadcrumbs": "[\"Writing plugins\"]", "references": "[{\"href\": \"https://datasette.io/plugins\", \"label\": \"plugins directory\"}]"}