{"id":26822,"date":"2019-10-09T16:22:58","date_gmt":"2019-10-09T20:22:58","guid":{"rendered":"https:\/\/mjtsai.com\/blog\/?p=26822"},"modified":"2022-10-27T15:59:09","modified_gmt":"2022-10-27T19:59:09","slug":"settings-urls-supported-by-ios-and-ipados-13-1","status":"publish","type":"post","link":"https:\/\/mjtsai.com\/blog\/2019\/10\/09\/settings-urls-supported-by-ios-and-ipados-13-1\/","title":{"rendered":"Settings URLs Supported by iOS and iPadOS 13.1"},"content":{"rendered":"<p><a href=\"https:\/\/www.macstories.net\/ios\/a-comprehensive-guide-to-all-120-settings-urls-supported-by-ios-and-ipados-13-1\/\">Federico Viticci<\/a> (<a href=\"https:\/\/twitter.com\/viticci\/status\/1179049447281627139\">tweet<\/a>):<\/p>\n<blockquote cite=\"https:\/\/www.macstories.net\/ios\/a-comprehensive-guide-to-all-120-settings-urls-supported-by-ios-and-ipados-13-1\/\"><p>A few weeks ago, I came across <a href=\"https:\/\/reddit.com\/r\/shortcuts\/comments\/d4fzyk\/you_can_currently_open_specific_pages_in_the\/\">a post on Reddit<\/a> claiming that Apple had restored the ability to launch specific sections of the Settings app via Shortcuts in iOS and iPadOS 13.1. I was inspired by that discovery to finish working on a project I had long been putting off: documenting <strong>all the URLs supported by the Settings app<\/strong> in iOS and iPadOS.<\/p><p>After <del>some<\/del> a <em>lot<\/em> of trial and error, I&rsquo;ve collected 120+ URLs that can open individual pages and sub-sections of the Settings app. In this post, I&rsquo;m going to share the complete list of URLs that are supported as of iOS and iPadOS 13.1 (specifically, iOS 13.1.2), as well as a custom shortcut to launch them.<\/p><\/blockquote>\n\n<p>For example, you can open the iCloud Backup settings using <code>prefs:root=CASTLE&amp;path=BACKUP<\/code>.<\/p>\n\n<p>The equivalent <a href=\"https:\/\/macosxautomation.com\/system-prefs-links.html\">Mac System Preferences URLs<\/a> start with <code>x-apple.systempreferences<\/code>.<\/p>\n\n<p><a href=\"https:\/\/twitter.com\/eternalstorms\/status\/1180379512489594880\">Matthias Gansrigler<\/a>:<\/p>\n<blockquote cite=\"https:\/\/twitter.com\/eternalstorms\/status\/1180379512489594880\">\n<p>So, using \n@viticci&rsquo;s iOS Settings URLs (<code>prefs:root<\/code>) <em>will<\/em> get your app rejected. Figures.<\/p>\n<p>Now, I&rsquo;m not sure if it&rsquo;s the <code>prefs:<\/code> url scheme itself, or if it&rsquo;s <code>prefs:root=<\/code> that they&rsquo;re having an issue with.<\/p>\n<p>I&rsquo;m guessing the latter, because before, I used <code>prefs:<\/code> to launch Settings.app, and that wasn&rsquo;t rejected.<\/p>\n<p>I&rsquo;d even argue using public APIs to open a URL constructed from a string doesn&rsquo;t really constitute using &ldquo;private API&rdquo;, but what do I know..<\/p>\n<\/blockquote>\n\n<p>Previously:<\/p>\n<ul>\n<li><a href=\"https:\/\/mjtsai.com\/blog\/2018\/08\/31\/aedeterminepermissiontoautomatetarget-added-but-aepocalyse-still-looms\/\">AEDeterminePermissionToAutomateTarget Added, But AEpocalyse Still Looms<\/a><\/li>\n<\/ul>\n\n<p id=\"settings-urls-supported-by-ios-and-ipados-13-1-update-2020-02-26\">Update (2020-02-26): <a href=\"https:\/\/twitter.com\/chockenberry\/status\/1232726833201680384\">Craig Hockenberry<\/a>:<\/p>\n<blockquote cite=\"https:\/\/twitter.com\/chockenberry\/status\/1232726833201680384\"><p>PSA: If you&rsquo;re using a URL that begins with &ldquo;prefs:&rdquo; or &ldquo;App-Prefs:&rdquo; you will be rejected.<\/p><p>It doesn&rsquo;t matter if you&rsquo;re trying to help a customer navigate a byzantine maze of switches and knobs to do the thing they want. You will be rejected.<\/p><\/blockquote>\n\n<p><a href=\"https:\/\/twitter.com\/chockenberry\/status\/1230212672848719872\">Craig Hockenberry<\/a>:<\/p>\n<blockquote cite=\"https:\/\/twitter.com\/chockenberry\/status\/1230212672848719872\">\n<p>In this specific case, I want someone to know that Dynamic Type settings can be adjusted to make the app work better for them.<\/p>\n<p>In a way, Apple is preventing me from making things more accessible for a customer.<\/p>\n<\/blockquote>\n\n<p id=\"settings-urls-supported-by-ios-and-ipados-13-1-update-2021-01-05\">Update (2021-01-05): <a href=\"https:\/\/github.com\/feedback-assistant\/reports\/issues\/184\">sindresorhus<\/a>:<\/p>\n<blockquote cite=\"https:\/\/github.com\/feedback-assistant\/reports\/issues\/184\"><p>Many apps need the ability to open a specific pane in System Preferences. The most common use is to direct users to manually enable some kind of privacy permission or to toggle an app extension. I also use it to help the user change some system settings, like in &ldquo;Language &amp; Region&rdquo;. Some panes support a URL scheme <code>x-apple.systempreferences:<\/code>, while for others we have to open <code>\/System\/Library\/PreferencePanes\/\\(name).prefPane<\/code>. And to open sub-panes of the Extensions system preferences, our only choice is to use an API which is now deprecated (<a href=\"https:\/\/github.com\/feedback-assistant\/reports\/issues\/179\">FB8910479<\/a>). This results in a large amount of boilerplate. It would be nice if the system provided a unified API to open System Preferences panes and sub-panes. This would save developers a lot of time and headache.<\/p><\/blockquote>\n\n<p id=\"settings-urls-supported-by-ios-and-ipados-13-1-update-2022-10-27\">Update (2022-10-27): <a href=\"https:\/\/derflounder.wordpress.com\/2022\/10\/25\/opening-macos-venturas-system-settings-to-desired-locations-via-the-command-line\/\">Rich Trouton<\/a>:<\/p>\n<blockquote cite=\"https:\/\/derflounder.wordpress.com\/2022\/10\/25\/opening-macos-venturas-system-settings-to-desired-locations-via-the-command-line\/\"><p>Along with this change [in macOS 13 Ventura], a number of previously-known commands for <a href=\"https:\/\/apple.stackexchange.com\/questions\/227002\/open-preference-pane-from-command-line-on-el-capitan-mac-os-x-10-11\">opening individual System Preferences preference panes from the command line<\/a> no longer work with System Settings.<\/p><p>However, it looks like the underlying command line functionality wasn&rsquo;t changed by Apple. You just need to know what the new options are to enter. For more details, please see below the jump.<\/p><\/blockquote>\n\n<p>Previously:<\/p>\n<ul>\n<li><a href=\"https:\/\/mjtsai.com\/blog\/2022\/06\/08\/system-settings\/\">System Settings<\/a><\/li>\n<\/ul>","protected":false},"excerpt":{"rendered":"<p>Federico Viticci (tweet): A few weeks ago, I came across a post on Reddit claiming that Apple had restored the ability to launch specific sections of the Settings app via Shortcuts in iOS and iPadOS 13.1. I was inspired by that discovery to finish working on a project I had long been putting off: documenting [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"apple_news_api_created_at":"2019-10-09T20:23:03Z","apple_news_api_id":"920d577c-4952-4297-a803-e39edff38a4d","apple_news_api_modified_at":"2022-10-27T19:59:12Z","apple_news_api_revision":"AAAAAAAAAAAAAAAAAAAABA==","apple_news_api_share_url":"https:\/\/apple.news\/Akg1XfElSQpeoA-Oe3_OKTQ","apple_news_coverimage":0,"apple_news_coverimage_caption":"","apple_news_is_hidden":false,"apple_news_is_paid":false,"apple_news_is_preview":false,"apple_news_is_sponsored":false,"apple_news_maturity_rating":"","apple_news_metadata":"\"\"","apple_news_pullquote":"","apple_news_pullquote_position":"","apple_news_slug":"","apple_news_sections":"\"\"","apple_news_suppress_video_url":false,"apple_news_use_image_component":false,"footnotes":""},"categories":[2],"tags":[1846,91,130,31,1667,30,1666,2223,1013,1686,1181,489],"class_list":["post-26822","post","type-post","status-publish","format-standard","hentry","category-technology","tag-app-review","tag-appstore","tag-rejection","tag-ios","tag-ios-13","tag-mac","tag-macos-10-15","tag-macos-13-ventura","tag-private-api","tag-shortcuts","tag-system-preferences","tag-url"],"apple_news_notices":[],"_links":{"self":[{"href":"https:\/\/mjtsai.com\/blog\/wp-json\/wp\/v2\/posts\/26822","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/mjtsai.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/mjtsai.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/mjtsai.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/mjtsai.com\/blog\/wp-json\/wp\/v2\/comments?post=26822"}],"version-history":[{"count":6,"href":"https:\/\/mjtsai.com\/blog\/wp-json\/wp\/v2\/posts\/26822\/revisions"}],"predecessor-version":[{"id":37475,"href":"https:\/\/mjtsai.com\/blog\/wp-json\/wp\/v2\/posts\/26822\/revisions\/37475"}],"wp:attachment":[{"href":"https:\/\/mjtsai.com\/blog\/wp-json\/wp\/v2\/media?parent=26822"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/mjtsai.com\/blog\/wp-json\/wp\/v2\/categories?post=26822"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/mjtsai.com\/blog\/wp-json\/wp\/v2\/tags?post=26822"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}