Skip to content

The Postgres development platform. Supabase gives you a dedicated Postgres database to build your web, mobile, and AI applications.

docs: Update documentation from SDK changes (Jan 2026) (#42085)

Guilherme Souzae51f24448d22
diff --git a/apps/docs/content/guides/auth/social-login/auth-twitter.mdx b/apps/docs/content/guides/auth/social-login/auth-twitter.mdx
index fde1411b01e..085ab650f51 100644
--- a/apps/docs/content/guides/auth/social-login/auth-twitter.mdx
+++ b/apps/docs/content/guides/auth/social-login/auth-twitter.mdx
@@ -120,6 +120,19 @@ Future<void> signInWithX() async {
```
</TabPanel>
+<$Show if="sdk:swift">
+<TabPanel id="swift" label="Swift">
+
+When your user signs in, call [`signInWithOAuth(provider:)`](/docs/reference/swift/auth-signinwithoauth) with `.x` as the `provider`:
+
+```swift
+func signInWithX() async throws {
+ try await supabase.auth.signInWithOAuth(provider: .x)
+}
+```
+
+</TabPanel>
+</$Show>
<$Show if="sdk:kotlin">
<TabPanel id="kotlin" label="Kotlin">
@@ -173,6 +186,19 @@ Future<void> signOut() async {
```
</TabPanel>
+<$Show if="sdk:swift">
+<TabPanel id="swift" label="Swift">
+
+When your user signs out, call [signOut()](/docs/reference/swift/auth-signout) to remove them from the browser session:
+
+```swift
+func signOut() async throws {
+ try await supabase.auth.signOut()
+}
+```
+
+</TabPanel>
+</$Show>
<$Show if="sdk:kotlin">
<TabPanel id="kotlin" label="Kotlin">
diff --git a/apps/docs/content/guides/storage/debugging/error-codes.mdx b/apps/docs/content/guides/storage/debugging/error-codes.mdx
index 6a962f11e91..ff7f809531c 100644
--- a/apps/docs/content/guides/storage/debugging/error-codes.mdx
+++ b/apps/docs/content/guides/storage/debugging/error-codes.mdx
@@ -6,6 +6,52 @@ subtitle: 'Learn about the Storage error codes and how to resolve them'
sidebar_label: 'Debugging'
---
+## Handling Storage errors in SDKs
+
+When using the Supabase SDKs, storage errors provide detailed information to help you debug issues:
+
+<Tabs
+ scrollable
+ size="small"
+ type="underlined"
+ defaultActiveId="js"
+ queryGroup="language"
+>
+<TabPanel id="js" label="JavaScript">
+
+```js
+try {
+ const { data, error } = await supabase.storage.from('avatars').download('avatar.png')
+
+ if (error) {
+ // Access error details
+ console.log('Error code:', error.error)
+ console.log('Error message:', error.message)
+ console.log('HTTP status:', error.status)
+ console.log('Status code:', error.statusCode)
+ }
+} catch (err) {
+ console.error('Unexpected error:', err)
+}
+```
+
+</TabPanel>
+<$Show if="sdk:python">
+<TabPanel id="python" label="Python">
+
+```python
+try:
+ response = supabase.storage.from_('avatars').download('avatar.png')
+except Exception as error:
+ # Access error details
+ print(f'Error: {error}')
+ # The SDK now handles bad responses from the server gracefully
+```
+
+</TabPanel>
+</$Show>
+</Tabs>
+
## Storage error codes
<Admonition type="note">
diff --git a/apps/docs/content/guides/storage/serving/downloads.mdx b/apps/docs/content/guides/storage/serving/downloads.mdx
index 6f2c891c066..4bf08585f65 100644
--- a/apps/docs/content/guides/storage/serving/downloads.mdx
+++ b/apps/docs/content/guides/storage/serving/downloads.mdx
@@ -35,6 +35,71 @@ If you want the browser to start an automatic download of the asset instead of t
By default it will use the asset name to save the file on disk. You can optionally pass a custom name to the `download` parameter as following: `?download=customname.jpg`
+#### Programmatic downloads with query parameters
+
+When using the SDK's `download()` method, you can pass additional query parameters to customize the download behavior:
+
+<Tabs
+ scrollable
+ size="small"
+ type="underlined"
+ defaultActiveId="js"
+ queryGroup="language"
+>
+<TabPanel id="js" label="JavaScript">
+
+```js
+import { createClient } from '@supabase/supabase-js'
+const supabase = createClient('your_project_url', 'your_supabase_api_key')
+
+// ---cut---
+// Download with custom filename
+const { data, error } = await supabase.storage.from('avatars').download('avatar1.png', {
+ download: 'my-custom-name.png',
+})
+```
+
+</TabPanel>
+<$Show if="sdk:dart">
+<TabPanel id="dart" label="Dart">
+
+```dart
+// Download with additional query parameters
+final response = await supabase.storage
+ .from('avatars')
+ .download(
+ 'avatar1.png',
+ queryParams: {
+ 'download': 'my-custom-name.png',
+ },
+ );
+```
+
+[Reference.](/docs/reference/dart/storage-from-download)
+
+</TabPanel>
+</$Show>
+<$Show if="sdk:swift">
+<TabPanel id="swift" label="Swift">
+
+```swift
+// Download with additional query parameters
+let response = try await supabase.storage
+ .from("avatars")
+ .download(
+ path: "avatar1.png",
+ queryItems: [
+ URLQueryItem(name: "download", value: "my-custom-name.png")
+ ]
+ )
+```
+
+[Reference.](/docs/reference/swift/storage-from-download)
+
+</TabPanel>
+</$Show>
+</Tabs>
+
## Private buckets
Assets stored in a non-public bucket are considered private and are not accessible via a public URL like the public buckets.