Skip to content

feat: add dynamic open graph metadata for link previews #5348

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
imrja8 wants to merge 9 commits into
base: canary
Choose a base branch
from
Open

feat: add dynamic open graph metadata for link previews #5348

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
b5c3d86
feat: add dynamic open graph metadata for enterprise whitelabeling
imrja8 Sep 4, 2026
b6c83e0
chore: use compressed open graph image
imrja8 Sep 4, 2026
62e948a
Merge branch 'Dokploy:canary' into feat/open-graph-metadata
imrja8 Sep 4, 2026
48dfb2b
[autofix.ci] apply automated fixes
autofix-ci[bot] Sep 4, 2026
13b043e
fix: replace metaTitle with ogImageUrl in reset payloads
imrja8 Sep 4, 2026
15bf663
fix: make fallback og image url absolute for social scrapers
imrja8 Sep 4, 2026
41251b4
[autofix.ci] apply automated fixes
autofix-ci[bot] Sep 4, 2026
29e5940
chore: revert accidental package.json changes
imrja8 Sep 4, 2026
e962311
Merge canary and resolve conflicts by regenerating migration
imrja8 Sep 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion apps/dokploy/__test__/traefik/server/update-server-config.test.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ const baseSettings: WebServerSettings = {
docsUrl: null,
errorPageTitle: null,
errorPageDescription: null,
metaTitle: null,
ogImageUrl: null,
footerText: null,
},
cleanupCacheApplications: false,
Expand Down
52 changes: 28 additions & 24 deletions apps/dokploy/components/proprietary/whitelabeling/whitelabeling-settings.tsx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -47,8 +47,8 @@ const formSchema = z.object({
docsUrl: safeUrlField,
errorPageTitle: z.string(),
errorPageDescription: z.string(),
metaTitle: z.string(),
footerText: z.string(),
ogImageUrl: safeUrlField,
});

type FormSchema = z.infer<typeof formSchema>;
Expand Down Expand Up @@ -193,8 +193,8 @@ export function WhitelabelingSettings() {
docsUrl: "",
errorPageTitle: "",
errorPageDescription: "",
metaTitle: "",
footerText: "",
ogImageUrl: "",
},
resolver: zodResolver(formSchema),
});
Expand All @@ -212,8 +212,8 @@ export function WhitelabelingSettings() {
docsUrl: data.docsUrl ?? "",
errorPageTitle: data.errorPageTitle ?? "",
errorPageDescription: data.errorPageDescription ?? "",
metaTitle: data.metaTitle ?? "",
footerText: data.footerText ?? "",
ogImageUrl: data.ogImageUrl ?? "",
});
}
}, [data, form]);
Expand Down Expand Up @@ -242,8 +242,8 @@ export function WhitelabelingSettings() {
docsUrl: values.docsUrl || null,
errorPageTitle: values.errorPageTitle || null,
errorPageDescription: values.errorPageDescription || null,
metaTitle: values.metaTitle || null,
footerText: values.footerText || null,
ogImageUrl: values.ogImageUrl || null,
},
})
.then(async () => {
Expand Down Expand Up @@ -388,6 +388,27 @@ export function WhitelabelingSettings() {
</FormItem>
)}
/>

<FormField
control={form.control}
name="ogImageUrl"
render={({ field }) => (
<FormItem>
<FormLabel>OG Image URL</FormLabel>
<FormControl>
<Input
placeholder="https://example.com/og.png"
{...field}
/>
</FormControl>
<FormDescription>
Open Graph image used for link previews on social media
and messaging platforms. Recommended size: 1200x630px.
</FormDescription>
<FormMessage />
</FormItem>
)}
/>
</CardContent>
</Card>

Expand Down Expand Up @@ -441,32 +462,15 @@ export function WhitelabelingSettings() {
</CardContent>
</Card>

{/* Metadata & Links Section */}
{/* Links Section */}
<Card className="bg-transparent">
<CardHeader>
<CardTitle>Metadata & Links</CardTitle>
<CardTitle>Links</CardTitle>
<CardDescription>
Customize the page title, footer text, and sidebar links.
Customize the footer text and sidebar links.
</CardDescription>
</CardHeader>
<CardContent className="flex flex-col gap-4">
<FormField
control={form.control}
name="metaTitle"
render={({ field }) => (
<FormItem>
<FormLabel>Page Title</FormLabel>
<FormControl>
<Input placeholder="Dokploy" {...field} />
</FormControl>
<FormDescription>
Browser tab title. Defaults to "Dokploy" if empty.
</FormDescription>
<FormMessage />
</FormItem>
)}
/>

<FormField
control={form.control}
name="footerText"
Expand Down
1 change: 1 addition & 0 deletions apps/dokploy/drizzle/0192_nappy_tempest.sql
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
ALTER TABLE "webServerSettings" ALTER COLUMN "whitelabelingConfig" SET DEFAULT '{"appName":null,"appDescription":null,"logoUrl":null,"faviconUrl":null,"customCss":null,"loginLogoUrl":null,"supportUrl":null,"docsUrl":null,"errorPageTitle":null,"errorPageDescription":null,"footerText":null,"ogImageUrl":null}'::jsonb;
Loading