Skip to main content

App Settings

Configure your application's settings and preferences.

Overview​

App Settings provides a centralized location for managing your application's configuration, general settings, and danger zone operations like deletion.

Concepts​

App Configuration​

Key-value settings that control application behavior. These can be accessed by your functions and used to customize app functionality.

App Metadata​

Basic information about your app including name, description, URLs, and status.

Access App Settings​

  1. Navigate to your App in the Dashboard.
  2. Click Settings in the sidebar.
  3. View and configure app settings.

General Settings​

App Information​

View and edit basic app details:

FieldDescriptionEditable
NameDisplay nameYes
SlugURL identifierNo
DescriptionApp purposeYes
TypeCustom or Built-inNo
CreatedCreation dateNo
UpdatedLast modificationNo

Update App Info​

  1. Navigate to Settings in your app.
  2. Edit the Name or Description fields.
  3. Click Save Changes.

URL Configuration​

Configure app URLs:

App URL​

The public URL where your application is accessible.

  1. Navigate to Settings.
  2. Find the App URL field.
  3. Enter the full URL (e.g., https://myapp.example.com).
  4. Click Save.

Editor URL​

The URL for the app's admin/editor interface.

  1. Navigate to Settings.
  2. Find the Editor URL field.
  3. Enter the editor URL.
  4. Click Save.

App Status​

View and manage app status:

StatusDescription
ActiveApp is running and accessible
InactiveApp is disabled

Activate/Deactivate App​

  1. Navigate to Settings.
  2. Toggle the Active switch.
  3. Confirm the status change.
note

Deactivating an app disables API access but preserves all data and configuration.

Environment Variables​

Configure environment variables available to functions:

  1. Navigate to Settings > Environment.
  2. Add key-value pairs:
    • Key: Variable name
    • Value: Variable value
  3. Click Save.

Environment variables are accessible in functions:

import os

def handler(request, context):
    api_key = os.environ.get("API_KEY")
    return {"api_key_set": api_key is not None}

Danger Zone​

warning

Actions in the Danger Zone are permanent and cannot be undone.

Delete App​

Permanently delete your application:

  1. Navigate to Settings.
  2. Scroll to Danger Zone.
  3. Click Delete App.
  4. Review the warning about what will be deleted:
    • All functions and their code
    • All policies and roles
    • All storage buckets and files
    • All database tables and records
    • All events and subscriptions
    • All analytics queries
  5. Type the app name to confirm.
  6. Click Delete App Permanently.

Configuration​

Setting Categories​

CategoryDescription
GeneralBasic app information
URLsApp and editor URLs
EnvironmentEnvironment variables
Danger ZoneDestructive operations

Troubleshooting​

Settings not saving​

Problem: Changes to settings aren't persisting.

Solution:

  1. Click the Save button after making changes.
  2. Check for validation errors.
  3. Ensure you have permission to edit settings.

Cannot delete app​

Problem: App deletion is blocked or fails.

Solution:

  1. Type the app name exactly as shown.
  2. Ensure you have admin permissions.
  3. Check for any active processes.

Environment variables not available​

Problem: Functions can't access environment variables.

Solution:

  1. Verify the variable is saved in settings.
  2. Check the variable name matches (case-sensitive).
  3. Redeploy functions after adding new variables.

Last Updated: January 2025