diff --git a/core/base-service/openapi.js b/core/base-service/openapi.js
index d9ae973c82ded..d87302a94fff4 100644
--- a/core/base-service/openapi.js
+++ b/core/base-service/openapi.js
@@ -241,7 +241,9 @@ function category2openapi(category, services) {
           name: 'style',
           in: 'query',
           required: false,
-          description: 'If not specified, the default style is "flat".',
+          description: `If not specified, the default style for this badge is "${
+            category.name.toLowerCase() === 'social' ? 'social' : 'flat'
+          }".`,
           schema: {
             type: 'string',
             enum: ['flat', 'flat-square', 'plastic', 'for-the-badge', 'social'],
diff --git a/core/base-service/openapi.spec.js b/core/base-service/openapi.spec.js
index 04b01cca65877..1ed1c1e9da38b 100644
--- a/core/base-service/openapi.spec.js
+++ b/core/base-service/openapi.spec.js
@@ -88,7 +88,8 @@ const expected = {
         name: 'style',
         in: 'query',
         required: false,
-        description: 'If not specified, the default style is "flat".',
+        description:
+          'If not specified, the default style for this badge is "flat".',
         schema: {
           enum: ['flat', 'flat-square', 'plastic', 'for-the-badge', 'social'],
           type: 'string',