SmartCloud Flow – Block‑based Forms & Workflow Automation

SmartCloud Flow is a block-based forms and workflow plugin for WordPress.

It combines a modern Gutenberg editor experience with a React/Mantine runtime and an optional AWS backend, so site owners can design forms in WordPress while choosing where submissions should be posted and, in Pro, running submissions, templates, workflows, and integrations in their own AWS account.

Flow is part of the WPSuite family of plugins by Smart Cloud Solutions, Inc.

Free mode

Flow does not require a hosted SaaS backend or a WPSuite connection to render forms.
In Free mode, each form can post directly from the browser to a URL you define per form. That endpoint may be:

• your own custom endpoint,
• a WordPress-side endpoint you implement yourself, or
• the Flow backend submission endpoint, if you later deploy it.

Pro mode

Pro becomes available after connecting your WordPress site to a WPSuite.io workspace. It is designed to work especially well with the separately deployed WP Suite Flow Backend in your own AWS account.

A typical Pro setup is:

• deploy the Flow backend to AWS,
• add the published backend API base URL to Gatey as a separate API,
• choose the desired protection mode for that API (IAM or COGNITO, matching the backend deployment),
• then select that API in SmartCloud → Flow Settings → API Settings.

This lets Flow use Gatey-aware authenticated API access, while keeping the backend in your own AWS account.

Key features

• Gutenberg form builder — Build forms with a dedicated Form block, layout/container blocks, and rich field blocks.
• Single React runtime per form — Front-end forms run as one mounted React tree.
• Rich display & content blocks — Use styled content primitives such as blockquotes, marks, badges, code blocks, spoilers, lists, tables, timelines, and overflow lists alongside inputs.
• Conditional logic & validation — Show/hide, enable/disable, require/optional, and other rule-based field behavior.
• Theme overrides & design tokens — Theme both interactive controls and display/content blocks inside the Shadow DOM with Mantine variables and stable --flow-* CSS tokens.
• Shortcodes & Elementor support — Reuse forms via shortcode and Elementor integrations.
• Flexible submission target model — Submit directly from the browser to a per-form endpoint URL.
• Pro: backend-aware operation — Connect Flow to the AWS-hosted Flow backend for durable submissions, admin tooling, templates, workflows, and webhook-driven automation.
• Pro: backend form sync — Optionally sync Gutenberg-defined forms into canonical backend form definitions stored in AWS.
• Pro: admin application — Manage submissions, templates, workflows, and backend/API settings from WordPress admin.
• Pro: workflow automation — Event-driven automation for emails, webhooks, status changes, and related operational flows.
• Pro: security & ownership — Deploy into your own AWS account and choose auth modes such as IAM or COGNITO.

You can find continuously expanding documentation at:
https://wpsuite.io/docs/

This plugin is not affiliated with or endorsed by Amazon Web Services or the WordPress Foundation. All trademarks are property of their respective owners.

Free and Pro Usage Notice

Flow works in Free mode without registration or subscription.

In Free mode:

• forms are rendered in the browser,
• submissions are posted directly to the endpoint URL configured for the form,
• no WPSuite connection is required.

Flow does not inherently store submissions in WordPress. If you want submissions handled inside WordPress, you need to implement and expose your own receiving endpoint there.

Pro features are optional and become available after connecting your WordPress site to a WPSuite.io workspace.

The main Pro scenario is to use the separately deployed WP Suite Flow Backend in your own AWS account. In that setup:

• you publish the backend API,
• register that API in Gatey,
• choose its protection mode (IAM or COGNITO),
• and select that API in SmartCloud → Flow Settings → API Settings.

This simplifies secure communication between the WordPress-side Flow plugin and the AWS-hosted backend.

Machine-readable resources

• Plugin manifest: https://wpsuite.io/.well-known/flow-plugin.json
• OpenAPI spec (backend): https://wpsuite.io/.well-known/flow-openapi.yaml

External Services

This plugin may integrate with the following external services, depending on configuration:

1. Google reCAPTCHA v3 (optional)

   • What it is & what it’s used for: Client-side bot detection. If enabled, Flow can request reCAPTCHA tokens in the browser to protect submissions.
   • What data is sent & when: The browser may contact Google to retrieve a token. That token may then be included in submission requests.
   • How to configure: Enter your reCAPTCHA site key/secret in the relevant Flow or shared WP Suite settings.
   • Links:
     • About reCAPTCHA: https://www.google.com/recaptcha/about/
     • Google Terms: https://policies.google.com/terms
     • Google Privacy: https://policies.google.com/privacy

2. Customer-configured submission endpoint / Flow backend endpoint

   • What it is & what it’s used for: The endpoint URL configured for a form submission. In Free mode this may be any URL you control. In Pro, it is commonly the AWS-hosted Flow backend.
   • What data is sent & when: Form field values and, depending on your implementation, related submission metadata. For Pro backend flows, uploaded file references, template variables, and workflow/event metadata may also be sent.
   • Where it goes: Requests are sent directly from the browser to the configured endpoint URL, either through direct fetch calls or, in Pro, through a Gatey-integrated authenticated API flow.
   • How it’s called: Standard HTTPS requests. Authentication depends on your configuration and may be none, IAM, or Cognito-based.

3. WPSuite platform connection (optional; workspace linking and shared features)

   • When it applies: When you connect the site to a WPSuite.io workspace to enable Pro features and shared admin capabilities.
   • What it’s used for: Workspace linking, shared admin capabilities, license/subscription handling, and related WP Suite platform features.
   • What data may be sent: Minimal site/workspace identifiers and authentication/session data required for linking and management.
   • Where it goes: Secure HTTPS requests to WPSuite.io services such as wpsuite.io and api.wpsuite.io.
   • Links:
     • WPSuite.io Privacy Policy: https://wpsuite.io/privacy-policy
     • WPSuite.io Terms of Use: https://wpsuite.io/terms-of-use

4. Amazon Cognito (optional; authentication for protected APIs)

   • When it applies: When your Flow backend API or related WP Suite services are protected with Cognito and the site uses Cognito-based authentication.
   • What it’s used for: User authentication and token-based authorization for protected API calls.
   • Links:
     • AWS Service Terms: https://aws.amazon.com/service-terms/
     • AWS Privacy: https://aws.amazon.com/privacy/

5. Stripe (optional; subscription/purchase flow)

   • When it applies: Only when the user opens the optional WPSuite subscription / purchase flow in the shared admin component.
   • What it’s used for: Displaying hosted pricing/subscription UI for optional paid features.
   • What data may be sent: Browser/session data required by Stripe to render the hosted purchase UI and process the purchase flow.
   • Links:
     • Terms: https://stripe.com/legal/consumer
     • Privacy: https://stripe.com/privacy

Trademark Notice

Amazon Web Services, AWS, Amazon EventBridge, Amazon DynamoDB, Amazon SES, and Amazon Cognito are trademarks of Amazon.com, Inc. or its affiliates.
Google reCAPTCHA is a trademark of Google LLC.
WordPress is a trademark of the WordPress Foundation.

SmartCloud Flow is an independent project and is not affiliated with, sponsored by, or endorsed by Amazon Web Services, Google, or the WordPress Foundation.

Source & Build

Public (free) source code:
All code that ships in the public (free) version of Flow is available here: https://github.com/smartcloudsol/flow

Build & distribution:
Flow is shipped to WordPress.org as a pre-built distribution. Build steps and developer notes are maintained in the GitHub repository documentation.

Shared WPSuite components:
Some admin UI modules may originate from shared WP Suite components to support workspace linking, license validation, and subscription management across WP Suite plugins.

Pro-only features (source availability):
Flow Pro includes additional functionality such as backend-powered submissions management, templates, workflows, and webhook dispatching. The code that enables these paid features is distributed to Pro users but is not published in the public repository.

1. Upload the plugin ZIP (or install from the WordPress plugin repository).
2. Activate the plugin through the “Plugins” screen in WordPress.
3. Go to WP Admin → SmartCloud → Flow Settings, review the configuration.
4. Build a form in Gutenberg and configure its submission target.
5. Optionally, for Pro:
   • connect the site to a WPSuite workspace,
   • deploy the WP Suite Flow Backend into AWS,
   • add the backend API to Gatey,
   • then select that API in SmartCloud → Flow Settings → API Settings.

1. 

   Form builder in Gutenberg (container and field blocks)

2. 

   Front-end form rendered with Mantine styling

3. 

   Conditional logic editor for a field

4. 

   Flow Settings → API Settings

5. 

   Pro: Email templates editor with preview

6. 

   Pro: Workflow builder (trigger, steps, webhook)

7. 

   Elementor Flow widget with preview

1.1.2

• Fix: Admin-side form sync now resolves the correct source entity in WordPress 7.0 Site Editor, including template and template-part contexts.
• Fix: Validation now uses the current field values on submit, including minimal or unlabeled text/email fields.
• Fix: Custom submit endpoints now handle absolute URLs correctly and support runtime interpolation tokens from WordPress, location, query string and host-page globals.
• Fix: Flow design token selectors now align with the emitted runtime class names, so theme overrides apply more reliably to submit buttons and field controls.

1.1.1

• Fix: Backend form sync now resolves the correct numeric source ID in WordPress 7.0 Site Editor and template part contexts.
• Fix: Sync metadata requests now guard against invalid source IDs and use the current editor entity metadata more reliably.
• Fix: Flow design token selectors now align with the runtime class names, so theme overrides apply more reliably to action buttons and field controls.

1.1.0

• Maintenance: Updated the admin UI dependency stack, including the shared UI React packages used by WPSuite admin screens.
• Maintenance: Updated shared Gatey Core and WPSuite Core dependencies used by Flow integrations.
• Compatibility: Updated the “Tested up to” value for WordPress 7.0.
• Internal cleanup: Refreshed related frontend and shared runtime dependencies for better alignment across WPSuite plugins.

1.0.1

• Fix: The optional “Powered by” attribution now renders correctly below the Flow content root / form when enablePoweredBy is enabled in the admin settings.

1.0.0

• Initial release.
• Gutenberg form builder with React/Mantine runtime.
• Conditional logic, shortcode support, and Elementor integration.
• Flexible per-form submission target model.
• Optional Pro integration with the WP Suite Flow Backend and Gatey-aware authenticated API access.