Skip to content

Beautiful Open-Source Form Builder

Include custom SEO and link previews in Pro (#1362)

Julien Nahum3a0178856c3b
diff --git a/api/config/plans.php b/api/config/plans.php
index 04ad1080c..a8e81b9e6 100644
--- a/api/config/plans.php
+++ b/api/config/plans.php
@@ -57,7 +57,7 @@ return [
// Business
- 'branding.advanced' => 'business', // CSS, fonts, favicons
+ 'branding.advanced' => 'business', // CSS, fonts
'custom_code' => 'business',
'custom_domain.wildcard' => 'business',
'multi_user.roles' => 'business',
@@ -115,10 +115,10 @@ return [
'redirect_url' => 'pro',
'secret_input' => 'pro',
'analytics' => 'pro',
+ 'seo_meta' => 'pro',
// Business tier features
'custom_css' => 'business',
- 'seo_meta' => 'business',
'enable_partial_submissions' => 'business',
'editable_submissions' => 'pro',
'database_fields_update' => 'business',
diff --git a/api/tests/Feature/Forms/FormSeoMetadataTest.php b/api/tests/Feature/Forms/FormSeoMetadataTest.php
new file mode 100644
index 000000000..2ec7a5cda
--- /dev/null
+++ b/api/tests/Feature/Forms/FormSeoMetadataTest.php
@@ -0,0 +1,55 @@
+<?php
+
+use App\Http\Resources\FormResource;
+use Illuminate\Support\Str;
+
+it('publishes saved SEO metadata according to the workspace plan', function (string $tier, ?string $customDomain, bool $canPublishSeo) {
+ $user = $this->createUser();
+ if ($tier !== 'free') {
+ $user->subscriptions()->create([
+ 'type' => $tier,
+ 'stripe_id' => (string) Str::uuid(),
+ 'stripe_status' => 'active',
+ 'stripe_price' => (string) Str::uuid(),
+ 'quantity' => 1,
+ ]);
+ }
+
+ $this->actingAsUser($user);
+ $workspace = $this->createUserWorkspace($user);
+ if ($customDomain) {
+ $workspace->update(['custom_domains' => [$customDomain]]);
+ }
+ $form = $this->createForm($user, $workspace, [
+ 'visibility' => 'public',
+ 'custom_domain' => $customDomain,
+ ]);
+ $seoMeta = [
+ 'page_title' => 'Contact our team',
+ 'page_description' => 'Send us your questions.',
+ 'page_thumbnail' => 'https://example.com/form-preview.png',
+ 'page_favicon' => 'https://example.com/favicon.png',
+ ];
+ $payload = (new FormResource($form))->toArray(request());
+ $payload['seo_meta'] = $seoMeta;
+
+ $this->putJson(route('open.forms.update', $form->id), $payload)
+ ->assertSuccessful()
+ ->assertJsonPath('form.seo_meta', $seoMeta);
+
+ $this->actingAsGuest();
+ $this->getJson(route('forms.show', $form->slug))
+ ->assertSuccessful()
+ ->assertJsonPath('seo_meta', $canPublishSeo ? $seoMeta : []);
+
+ // Public filtering must never erase the owner's saved metadata.
+ expect((array) $form->fresh()->seo_meta)->toBe($seoMeta);
+})->with([
+ 'free' => ['free', null, false],
+ 'pro on OpnForm' => ['pro', null, true],
+ 'pro on a custom domain' => ['pro', 'forms.example.com', true],
+ 'business on OpnForm' => ['business', null, true],
+ 'business on a custom domain' => ['business', 'forms.example.com', true],
+ 'enterprise on OpnForm' => ['enterprise', null, true],
+ 'enterprise on a custom domain' => ['enterprise', 'forms.example.com', true],
+]);
diff --git a/api/tests/Unit/Service/PlanServiceTest.php b/api/tests/Unit/Service/PlanServiceTest.php
index 72ea3d642..16050416a 100644
--- a/api/tests/Unit/Service/PlanServiceTest.php
+++ b/api/tests/Unit/Service/PlanServiceTest.php
@@ -473,12 +473,13 @@ describe('Form Feature Checks', function () {
expect($this->planService->tierHasFeature('free', 'no_branding'))->toBeFalse();
expect($this->planService->tierHasFeature('pro', 'no_branding'))->toBeTrue();
expect($this->planService->tierHasFeature('free', 'seo_meta'))->toBeFalse();
+ expect($this->planService->tierHasFeature('pro', 'seo_meta'))->toBeTrue();
expect($this->planService->tierHasFeature('business', 'seo_meta'))->toBeTrue();
});
it('getRequiredTier looks up both features and form_features', function () {
expect($this->planService->getRequiredTier('custom_smtp'))->toBe('pro');
- expect($this->planService->getRequiredTier('seo_meta'))->toBe('business');
+ expect($this->planService->getRequiredTier('seo_meta'))->toBe('pro');
expect($this->planService->getRequiredTier('no_branding'))->toBe('pro');
expect($this->planService->getRequiredTier('nonexistent'))->toBeNull();
});
diff --git a/client/components/open/forms/components/form-components/FormCustomSeo.vue b/client/components/open/forms/components/form-components/FormCustomSeo.vue
index 9c267660f..849fcd96f 100644
--- a/client/components/open/forms/components/form-components/FormCustomSeo.vue
+++ b/client/components/open/forms/components/form-components/FormCustomSeo.vue
@@ -7,12 +7,12 @@
SEO & Social Sharing - Meta <PlanTag
class="ml-2"
feature="seo_meta"
- upgrade-modal-title="Upgrade to Enhance Your Form's SEO"
- upgrade-modal-description="Explore advanced SEO features in the editor on our Free plan. Upgrade to fully implement custom meta tags, Open Graph data, and improved search visibility. Boost your form's online presence and attract more respondents with our premium SEO toolkit."
+ upgrade-modal-title="Customize SEO and Link Previews with Pro"
+ upgrade-modal-description="Upgrade to Pro to publish your own page title, description, link preview image, and favicon. These settings are available on Pro and higher plans."
/>
</h3>
<p class="mt-1 text-sm text-neutral-500">
- Customize the image and text that appear when you share your form on other sites (Open Graph).
+ On Pro and higher plans, customize your page title, description, link preview image, and favicon.
</p>
</div>
<UButton
diff --git a/client/components/pages/pricing/FeatureComparison.vue b/client/components/pages/pricing/FeatureComparison.vue
index 758160cf6..5e117a3c5 100644
--- a/client/components/pages/pricing/FeatureComparison.vue
+++ b/client/components/pages/pricing/FeatureComparison.vue
@@ -221,6 +221,10 @@ const sections = [
label: "Custom domain",
values: [false, true, true, true],
},
+ {
+ label: "Custom SEO, link previews & favicon",
+ values: [false, true, true, true],
+ },
{
label: "Advanced branding (CSS/fonts)",
values: [false, false, true, true],
diff --git a/client/components/pages/pricing/SubscriptionModal.vue b/client/components/pages/pricing/SubscriptionModal.vue
index 3acad9683..38ef48a59 100644
--- a/client/components/pages/pricing/SubscriptionModal.vue
+++ b/client/components/pages/pricing/SubscriptionModal.vue
@@ -258,16 +258,17 @@ const PLAN_VISUALS = {
const PLAN_DETAILS = {
pro: {
- subtitle: 'Branding control, custom domains, analytics, notifications, and core premium form tools.',
+ subtitle: 'Branding control, custom domains, SEO, analytics, notifications, and core premium form tools.',
highlights: [
'Remove OpnForm branding',
'Use one custom domain',
+ 'Customize SEO, link previews, and favicon',
'Unlock analytics, summaries, and premium integrations',
],
summaryLine: 'Best when you need premium publishing and conversion features.',
features: [
{ icon: 'mdi:star-outline', title: 'Remove OpnForm branding', description: 'Publish forms without the OpnForm watermark and make the experience feel truly yours.' },
- { icon: 'heroicons:globe-alt', title: '1 custom domain', description: 'Put forms on your own domain for a polished, trustworthy handoff.' },
+ { icon: 'heroicons:globe-alt', title: 'Custom domain & SEO', description: 'Publish on one custom domain with your own page title, description, link preview image, and favicon.' },
{ icon: 'heroicons:bell', title: 'Pro integrations', description: 'Send alerts to Slack, Discord, Telegram, and unlock the rest of the Pro workflow tools.' },
],
},
diff --git a/client/pages/pricing.vue b/client/pages/pricing.vue
index 0441351fe..b0abad11e 100644
--- a/client/pages/pricing.vue
+++ b/client/pages/pricing.vue
@@ -238,6 +238,13 @@
/>
Custom domains
</li>
+ <li class="flex items-center gap-2.5">
+ <Icon
+ class="w-4 h-5 text-emerald-600"
+ name="heroicons:check-20-solid"
+ />
+ Custom SEO, link previews &amp; favicon
+ </li>
<li class="flex items-center gap-2.5">
<Icon
class="w-4 h-5 text-emerald-600"
@@ -379,7 +386,7 @@
class="w-4 h-5 text-emerald-600"
name="heroicons:check-20-solid"
/>
- Advanced branding (CSS, fonts, favicons)
+ Advanced branding (CSS, fonts)
</li>
<li class="flex items-center gap-2.5">
<Icon
@@ -867,6 +874,11 @@ const faqs = [
answer:
"Yes. You can remove the “Made with OpnForm” footer and add your own branding on the Pro plan or higher.",
},
+ {
+ question: "Can I customize my form's SEO and link preview?",
+ answer:
+ "Yes. Pro and higher plans include a custom page title, description, link preview image, and favicon. These settings work on both OpnForm URLs and custom domains.",
+ },
{
question: "Is there a difference between monthly and yearly billing?",
answer:
diff --git a/docs/api-reference/changelog.mdx b/docs/api-reference/changelog.mdx
index 9fc8c48bf..6cade3354 100644
--- a/docs/api-reference/changelog.mdx
+++ b/docs/api-reference/changelog.mdx
@@ -3,6 +3,12 @@ title: "Changelog"
description: "Notable updates to the OpnForm API."
---
+## 2026-10-28 – Custom SEO and link previews on Pro
+
+OpnForm Cloud Pro workspaces can now publish custom page titles, descriptions, link preview images, and favicons through `seo_meta`. These settings previously required Business. They apply to both OpnForm URLs and custom domains.
+
+Existing saved settings become available when the workspace has a Pro or higher plan; no form update is required. Free workspaces can still save these settings for preview, but public responses omit them.
+
## 2026-10-07 – Export status polling with API tokens
Personal Access Tokens with `forms-read` can now poll asynchronous exports at
diff --git a/docs/api-reference/forms/create-form.mdx b/docs/api-reference/forms/create-form.mdx
index 110b33b65..76b2a3d8c 100644
--- a/docs/api-reference/forms/create-form.mdx
+++ b/docs/api-reference/forms/create-form.mdx
@@ -28,8 +28,11 @@ Authorization: Bearer <token>
| visibility | string | Yes | One of `public`, `draft`, or `closed`. |
| language | string | Yes | Two-letter ISO language code (e.g. `en`). |
| properties | array | Yes | Array of form blocks (see `FormProperty` schema). |
+| seo_meta | object | No | Custom page title, description, link preview image, and favicon. Requires Pro or higher on OpnForm Cloud. |
| …other fields | mixed | No | See the `Form` schema for the full list of attributes. |
+The `seo_meta` object accepts `page_title`, `page_description`, `page_thumbnail`, and `page_favicon`. On OpnForm Cloud, these settings are published on Pro and higher plans, on both OpnForm URLs and custom domains. Free workspaces can save them for preview, but they are omitted from the public form until the workspace upgrades.
+
Example request:
```json
@@ -63,4 +66,4 @@ Example request:
}
```
-`403 Forbidden` – The token does not include the `forms-write` ability.
\ No newline at end of file
+`403 Forbidden` – The token does not include the `forms-write` ability.
diff --git a/docs/api-reference/forms/update-form.mdx b/docs/api-reference/forms/update-form.mdx
index 8418c7b0e..7b2e39417 100644
--- a/docs/api-reference/forms/update-form.mdx
+++ b/docs/api-reference/forms/update-form.mdx
@@ -69,6 +69,23 @@ This ensures you retain all existing form fields and don't accidentally overwrit
**Best Practice Example:** If you only want to change form visibility, fetch the form first, update only the `visibility` field locally, then send the complete form back with all its properties intact.
</Tip>
+### Custom SEO and link previews
+
+On OpnForm Cloud, Pro and higher plans can publish a custom page title, description, link preview image, and favicon on both OpnForm URLs and custom domains. Supply these settings in `seo_meta`:
+
+```json
+{
+ "seo_meta": {
+ "page_title": "Contact our team",
+ "page_description": "Send us your questions and we will get back to you.",
+ "page_thumbnail": "https://example.com/form-preview.png",
+ "page_favicon": "https://example.com/favicon.png"
+ }
+}
+```
+
+Include the required form fields described above alongside `seo_meta`. Free workspaces can save these settings for preview, but they are omitted from the public form until the workspace upgrades.
+
### Automatically delete old submissions
Set `submission_retention_value` and `submission_retention_unit` together to permanently delete submissions after a retention period. The period is measured from each submission's last update, and the cleanup runs hourly.
diff --git a/docs/api-reference/openapi.yaml b/docs/api-reference/openapi.yaml
index cd3ddf8c8..9cc56a7ee 100644
--- a/docs/api-reference/openapi.yaml
+++ b/docs/api-reference/openapi.yaml
@@ -1438,6 +1438,7 @@ components:
seo_meta:
type: object
nullable: true
+ description: Custom page title (page_title), description (page_description), link preview image (page_thumbnail), and favicon (page_favicon). Published on cloud Pro and higher plans, on both OpnForm URLs and custom domains.
# Advanced features
custom_code:
diff --git a/scripts/npm-exceptions.json b/scripts/npm-exceptions.json
index beeeab151..e064b8da8 100644
--- a/scripts/npm-exceptions.json
+++ b/scripts/npm-exceptions.json
@@ -1,10 +1,13 @@
{
"affectedPackages": [
+ "@janniks/vue3-katex",
"@nuxt/nitro-server",
"@nuxt/vite-builder",
"@nuxt/vite-server",
"@nuxtjs/sitemap",
+ "@rollup/plugin-node-resolve",
"braces",
+ "deepmerge",
"fast-glob",
"globby",
"listhen",
@@ -13,9 +16,23 @@
"nuxt",
"nuxt-site-config",
"nuxtseo-shared",
- "quill"
+ "quill",
+ "vue-notion"
],
"exceptions": [
+ {
+ "package": "deepmerge",
+ "advisory": "https://github.com/advisories/GHSA-gcqx-w48m-w2h4",
+ "version": "4.3.1",
+ "severity": "low",
+ "nodes": [
+ "node_modules/deepmerge"
+ ],
+ "reviewed": "2026-10-28",
+ "expires": "2026-11-06",
+ "reason": "Rollup's node-resolve merges only package-owned defaults. vue-notion is used for first-party legal pages with KaTeX disabled and no user-supplied merge options. No patched upstream release; review again before expiry.",
+ "upstreamLatest": "4.3.1"
+ },
{
"package": "braces",
"advisory": "https://github.com/advisories/GHSA-vfj7-8cjw-p6xm",
diff --git a/scripts/tests/dependency-security.test.mjs b/scripts/tests/dependency-security.test.mjs
index eecc73ef3..943fd3643 100644
--- a/scripts/tests/dependency-security.test.mjs
+++ b/scripts/tests/dependency-security.test.mjs
@@ -138,6 +138,39 @@ test('rejects the retired node-forge advisory instead of accepting its former ex
assert.throws(() => evaluateNpmAudit(report, vulnerableLock, policy, '2026-10-27'), /Unreviewed affected package: node-forge/)
})
+test('scopes the deepmerge review to its exact advisory, installed version, path and expiry', () => {
+ const exception = policy.exceptions.find(entry => entry.package === 'deepmerge')
+ const report = {
+ auditReportVersion: 2,
+ metadata: { vulnerabilities: { total: 6 } },
+ vulnerabilities: {
+ deepmerge: {
+ severity: 'low',
+ nodes: ['node_modules/deepmerge'],
+ via: [{ name: 'deepmerge', severity: 'low', url: exception.advisory }],
+ },
+ '@janniks/vue3-katex': { severity: 'low', nodes: ['node_modules/@janniks/vue3-katex'], via: ['deepmerge'] },
+ 'vue-notion': { severity: 'low', nodes: ['node_modules/vue-notion'], via: ['@janniks/vue3-katex'] },
+ '@rollup/plugin-node-resolve': { severity: 'low', nodes: ['node_modules/@rollup/plugin-node-resolve'], via: ['deepmerge'] },
+ nitropack: { severity: 'low', nodes: ['node_modules/nitropack'], via: ['@rollup/plugin-node-resolve'] },
+ nuxt: { severity: 'low', nodes: ['node_modules/nuxt'], via: ['nitropack'] },
+ },
+ }
+ const reviewedLock = { packages: { 'node_modules/deepmerge': { version: '4.3.1' } } }
+ const result = evaluateNpmAudit(report, reviewedLock, policy, '2026-10-28')
+ assert.deepEqual(result.acceptedAdvisories, [exception.advisory])
+ assert.equal(result.affectedPackages, 6)
+ assert.throws(() => evaluateNpmAudit(report, reviewedLock, policy, '2026-11-07'), /Expired security exception: deepmerge/)
+ const changedLock = { packages: { 'node_modules/deepmerge': { version: '4.3.2' } } }
+ assert.throws(() => evaluateNpmAudit(report, changedLock, policy, '2026-10-28'), /Unreviewed vulnerable version/)
+ const changedPath = structuredClone(report)
+ changedPath.vulnerabilities.deepmerge.nodes = ['node_modules/other/node_modules/deepmerge']
+ assert.throws(() => evaluateNpmAudit(changedPath, reviewedLock, policy, '2026-10-28'), /Unreviewed advisory path/)
+ const changedAdvisory = structuredClone(report)
+ changedAdvisory.vulnerabilities.deepmerge.via[0].url = 'https://github.com/advisories/NEW'
+ assert.throws(() => evaluateNpmAudit(changedAdvisory, reviewedLock, policy, '2026-10-28'), /Unreviewed advisory/)
+})
+
test('Amplify also audits both scopes before building, including direct cloud builds', () => {
const amplify = parse(readFileSync(new URL('../../amplify.yml', import.meta.url), 'utf8'))
const preBuild = amplify.frontend.phases.preBuild.commands