From cca8809aebe2e230085259e590e18edc707ccb7b Mon Sep 17 00:00:00 2001 From: Gilad Resisi Date: Sat, 31 Oct 2026 14:13:54 +0700 Subject: [PATCH] docs(dribbble): document the exact 400x300 / 800x600 image requirement Dribbble's shots API only accepts images that are exactly 400x300 or 800x600 pixels, one per shot, and Postiz enforces the same rule in the composer. The provider page used to recommend "800x600 or larger" and showed a two-image example, both of which Postiz rejects. Replace them with an Image Requirements section and fix the Media rules row in the platforms overview. Co-Authored-By: Claude Fable 5.1 --- general/platforms/overview.mdx | 2 +- public-api/providers/dribbble.mdx | 21 +++++++++++++++------ 2 files changed, 16 insertions(+), 7 deletions(-) diff --git a/general/platforms/overview.mdx b/general/platforms/overview.mdx index 6f7b4330..b5658475 100644 --- a/general/platforms/overview.mdx +++ b/general/platforms/overview.mdx @@ -99,7 +99,7 @@ platform. | YouTube | Exactly one attachment, and it must be a video | | TikTok | At least one attachment. One video **or** several pictures, never mixed | | Pinterest | At least one media, maximum 5 images. A video pin needs two attachments: the video and a cover image | -| Dribbble | Exactly one attachment, images only | +| Dribbble | Exactly one attachment, images only, and it must be exactly 400×300 or 800×600 pixels (a Dribbble API limit) | | Google My Business | Text-only or exactly one image. No video | | Farcaster | Images only | | Reddit | A media-type subreddit post needs exactly one attachment. Video posts need a thumbnail | diff --git a/public-api/providers/dribbble.mdx b/public-api/providers/dribbble.mdx index e17a128c..0db72080 100644 --- a/public-api/providers/dribbble.mdx +++ b/public-api/providers/dribbble.mdx @@ -121,15 +121,11 @@ Optional team URL. If you're part of a Dribbble team and want to post on behalf }, "value": [ { - "content": "Fitness tracking app concept with focus on clean data visualization and motivational design elements.\n\nSwipe to see all screens →\n\n#mobileapp #fitness #appdesign #ios", + "content": "Fitness tracking app concept with focus on clean data visualization and motivational design elements.\n\n#mobileapp #fitness #appdesign #ios", "image": [ { "id": "app-screen-1", "path": "https://uploads.postiz.com/fitness-1.png" - }, - { - "id": "app-screen-2", - "path": "https://uploads.postiz.com/fitness-2.png" } ] } @@ -144,9 +140,22 @@ Optional team URL. If you're part of a Dribbble team and want to post on behalf } ``` +## Image Requirements + +Dribbble's API only accepts shots that are **exactly 400×300 or 800×600 pixels**. Any other +dimensions are rejected before the post is scheduled, with the error +`Invalid image size. Requires 400x300 or 800x600 px images.` This is a limit of the +[Dribbble API](https://developer.dribbble.com/v2/shots/#create-a-shot), not of Postiz: +larger uploads are only possible through the Dribbble website itself. + +- Exactly one image per shot +- Exactly 400×300 or 800×600 pixels (800×600 is the larger option and is what Dribbble serves as its HiDPI image) +- GIF, JPG or PNG, up to 8 MB +- Videos are not supported + **Dribbble Tips:** -- Use high-quality images (800×600 or larger recommended) +- Export at 800×600 for the sharpest result - Include relevant tags in your description - Add context about your design process in the content