Getting Started with Edge Functions (Dashboard)

Supabase allows you to create Supabase Edge Functions directly from the Supabase Dashboard, making it easy to deploy functions without needing to set up a local development environment. The Edge Functions editor in the Dashboard has built-in syntax highlighting and type-checking for Deno and Supabase-specific APIs.

This guide will walk you through creating, testing, and deploying your first Edge Function using the Supabase Dashboard. You'll have a working function running globally in under 10 minutes.

You can also create and deploy functions using the Supabase CLI. Check out our CLI Quickstart guide.

You'll need a Supabase project to get started. If you don't have one yet, create a new project at database.new.

Step 1: Navigate to the Edge Functions tab

Navigate to your Supabase project dashboard and locate the Edge Functions section:

1. Go to your Supabase Dashboard
2. Select your project
3. In the left sidebar, click on Edge Functions

You'll see the Edge Functions overview page where you can manage all your functions.

Step 2: Create your first function

Click the "Deploy a new function" button and select "Via Editor" to create a function directly in the dashboard.

<Image alt="Scaffold functions through the dashboard editor" src={{ light: '/docs/img/guides/functions/dashboard/create-edge-function--light.png', dark: '/docs/img/guides/functions/dashboard/create-edge-function--dark.png', }}

width={2338} height={926} />

The dashboard offers several pre-built templates for common use cases, such as Stripe Webhooks, OpenAI proxying, uploading files to Supabase Storage, and sending emails.

For this guide, we’ll select the "Hello World" template. If you’d rather start from scratch, you can ignore the pre-built templates.

Step 3: Customize your function code

The dashboard will load your chosen template in the code editor. Here's what the "Hello World" template looks like:

<Image alt="Hello World template" src={{ light: '/docs/img/guides/functions/dashboard/edge-function-template--light.png', dark: '/docs/img/guides/functions/dashboard/edge-function-template--dark.png', }}

width={2430} height={1248} />

If needed, you can modify this code directly in the browser editor. The function accepts a JSON payload with a name field and returns a greeting message.

Step 4: Deploy your function

Once you're happy with your function code:

1. Click the "Deploy function" button at the bottom of the editor
2. Wait for the deployment to complete (usually takes 10-30 seconds)
3. You'll see a success message when deployment is finished

🚀 Your function is now automatically distributed to edge locations worldwide, running at https://YOUR_PROJECT_ID.supabase.co/functions/v1/hello-world

Step 5: Test your function

Supabase has built-in tools for testing your Edge Functions from the Dashboard. You can execute your Edge Function with different request payloads, headers, and query parameters. The built-in tester returns the response status, headers, and body.

On your function's details page:

1. Click the "Test" button
2. Configure your test request:
   • HTTP Method: POST (or whatever your function expects)
   • Headers: Add any required headers like Content-Type: application/json
   • Query Parameters: Add URL parameters if needed
   • Request Body: Add your JSON payload
   • Authorization: Change the authorization token (anon key or user key)

Click "Send Request" to test your function.

<Image alt="Test your function" src={{ light: '/docs/img/guides/functions/dashboard/edge-function-test--light.png', dark: '/docs/img/guides/functions/dashboard/edge-function-test--dark.png', }}

width={2430} height={1350} />

In this example, we successfully tested our Hello World function by sending a JSON payload with a name field, and received the expected greeting message back.

Step 6: Get your function URL and keys

Your function is now live at:

https://YOUR_PROJECT_ID.supabase.co/functions/v1/hello-world

To invoke this Edge Function from within your application, you'll need API keys. Navigate to Settings > API Keys in your dashboard to find:

• Anon Key - For client-side requests (safe to use in browsers with RLS enabled)
• Service Role Key - For server-side requests (keep this secret! bypasses RLS)

If you’d like to update the deployed function code, click on the function you want to edit, modify the code as needed, then click Deploy updates. This will overwrite the existing deployment with the newly edited function code.

There is currently no version control for edits! The Dashboard's Edge Function editor currently does not support version control, versioning, or rollbacks. We recommend using it only for quick testing and prototypes.

Usage

Now that your function is deployed, you can invoke it from within your app:

<Tabs scrollable size="small" type="underlined" defaultActiveId="supabase-js"

import { createClient } from '@supabase/supabase-js'

const supabase = createClient('https://[YOUR_PROJECT_ID].supabase.co', 'YOUR_ANON_KEY')

const { data, error } = await supabase.functions.invoke('hello-world', {
  body: { name: 'JavaScript' },
})

console.log(data) // { message: "Hello JavaScript!" }

const response = await fetch('https://[YOUR_PROJECT_ID].supabase.co/functions/v1/hello-world', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_ANON_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ name: 'Fetch' }),
})

const data = await response.json()
console.log(data) // { message: "Hello Fetch!" }

Deploy via Assistant

You can also use Supabase's AI Assistant to generate and deploy functions automatically.

Go to your project > Deploy a new function > Via AI Assistant.

<Image alt="Create Edge Function via AI Assistant" src={{ light: '/docs/img/guides/functions/dashboard/create-ai-edge-function--light.png', dark: '/docs/img/guides/functions/dashboard/create-ai-edge-function--dark.png', }}

width={2604} height={926} />

Describe what you want your function to do in the prompt

<Image alt="Create Edge Function via AI Assistant" src={{ light: '/docs/img/guides/functions/dashboard/ai-edge-function--light.png', dark: '/docs/img/guides/functions/dashboard/ai-edge-function--dark.png', }}

width={2768} height={1836} />

Click Deploy and the Assistant will create and deploy the function for you.

Download Edge Functions

Now that your function is deployed, you can access it from your local development environment. To use your Edge Function code within your local development environment, you can download your function source code either through the dashboard, or the CLI.

Dashboard

1. Go to your function's page
2. In the top right corner, click the "Download" button

CLI

Before getting started, make sure you have the Supabase CLI installed. Check out the CLI installation guide for installation methods and troubleshooting.

# Link your project to your local environment
supabase link --project-ref [project-ref]

# List all functions in the linked project
supabase functions list

# Download a function
supabase functions download hello-world

At this point, your function has been downloaded to your local environment. Make the required changes, and redeploy when you're ready.

# Run a function locally
supabase functions serve hello-world

# Redeploy when you're ready with your changes
supabase functions deploy hello-world