Flow action extensions now support relative paths for endpoint URLs

Flow Action Extensions Add Relative Path Support for Endpoint URLs

Shopify now accepts relative paths for endpoint URLs in Flow action extension configurations. Developers can use paths starting with a single forward slash (such as /api/flow/actions/place-bid) instead of full HTTPS URLs for the runtime_url, validation_url, config_page_url, and config_page_preview_url properties.

How Path Resolution Works

When developers use relative paths, Shopify CLI automatically resolves them against the appropriate base URL depending on the environment. During local development with shopify app dev running, the CLI resolves paths against the development tunnel URL. In production, paths resolve against the app’s configured application URL.

Impact on Development Workflow

This change simplifies Flow action extension configuration by eliminating the need to maintain separate absolute URLs for different environments. Developers can now use the same relative path configuration across local development and production deployments, reducing configuration overhead and potential errors from URL mismatches.

The update applies to all four endpoint URL properties in Flow action extensions, covering the complete lifecycle from runtime execution to validation and configuration interfaces. Apps using absolute HTTPS URLs continue to work without modification, making this a backward-compatible enhancement.

Developers building or maintaining Flow action extensions can update their extension configuration files to use relative paths, particularly beneficial for teams managing multiple deployment environments or frequently switching between local and production testing.

Read the full announcement →