coder · ssncferreira · Jul 28, 2025 · Jul 21, 2025 · Jul 28, 2025 · Jul 28, 2025
diff --git a/cli/testdata/coder_provisioner_list_--output_json.golden b/cli/testdata/coder_provisioner_list_--output_json.golden
@@ -7,7 +7,7 @@
     "last_seen_at": "====[timestamp]=====",
     "name": "test-daemon",
     "version": "v0.0.0-devel",
-    "api_version": "1.7",
+    "api_version": "1.8",
     "provisioners": [
       "echo"
     ],

diff --git a/coderd/apidoc/docs.go b/coderd/apidoc/docs.go
diff --git a/coderd/apidoc/swagger.json b/coderd/apidoc/swagger.json
diff --git a/coderd/database/dbfake/dbfake.go b/coderd/database/dbfake/dbfake.go
@@ -417,6 +417,8 @@ func (t TemplateVersionBuilder) Do() TemplateVersionResponse {
 			InvalidateAfterSecs: preset.InvalidateAfterSecs,
 			SchedulingTimezone:  preset.SchedulingTimezone,
 			IsDefault:           false,
+			Description:         preset.Description,
+			Icon:                preset.Icon,
 		})
 	}
 

diff --git a/coderd/database/dbgen/dbgen.go b/coderd/database/dbgen/dbgen.go
@@ -1392,6 +1392,8 @@ func Preset(t testing.TB, db database.Store, seed database.InsertPresetParams) d
 		InvalidateAfterSecs: seed.InvalidateAfterSecs,
 		SchedulingTimezone:  seed.SchedulingTimezone,
 		IsDefault:           seed.IsDefault,
+		Description:         seed.Description,
+		Icon:                seed.Icon,
 	})
 	require.NoError(t, err, "insert preset")
 	return preset

diff --git a/coderd/database/dump.sql b/coderd/database/dump.sql
diff --git a/coderd/database/migrations/000351_add_icon_and_description_template_version_presets.down.sql b/coderd/database/migrations/000351_add_icon_and_description_template_version_presets.down.sql
@@ -0,0 +1,3 @@
+ALTER TABLE template_version_presets
+	DROP COLUMN IF EXISTS description,
+	DROP COLUMN IF EXISTS icon;
diff --git a/coderd/database/migrations/000351_add_icon_and_description_template_version_presets.up.sql b/coderd/database/migrations/000351_add_icon_and_description_template_version_presets.up.sql
@@ -0,0 +1,6 @@
+ALTER TABLE template_version_presets
+	ADD COLUMN IF NOT EXISTS description VARCHAR(128) NOT NULL DEFAULT '',
+	ADD COLUMN IF NOT EXISTS icon VARCHAR(256) NOT NULL DEFAULT '';
+
+COMMENT ON COLUMN template_version_presets.description IS 'Short text describing the preset (max 128 characters).';
+COMMENT ON COLUMN template_version_presets.icon IS 'URL or path to an icon representing the preset (max 256 characters).';
diff --git a/coderd/database/models.go b/coderd/database/models.go
diff --git a/coderd/database/queries.sql.go b/coderd/database/queries.sql.go
diff --git a/coderd/database/queries/presets.sql b/coderd/database/queries/presets.sql
@@ -7,7 +7,9 @@ INSERT INTO template_version_presets (
 	desired_instances,
 	invalidate_after_secs,
 	scheduling_timezone,
-	is_default
+	is_default,
+	description,
+	icon
 )
 VALUES (
 	@id,
@@ -17,7 +19,9 @@ VALUES (
 	@desired_instances,
 	@invalidate_after_secs,
 	@scheduling_timezone,
-	@is_default
+	@is_default,
+	@description,
+	@icon
 ) RETURNING *;
 
 -- name: InsertPresetParameters :many

diff --git a/coderd/presets.go b/coderd/presets.go
@@ -54,6 +54,8 @@ func (api *API) templateVersionPresets(rw http.ResponseWriter, r *http.Request)
 			Name:                     preset.Name,
 			Default:                  preset.IsDefault,
 			DesiredPrebuildInstances: convertPrebuildInstances(preset.DesiredInstances),
+			Description:              preset.Description,
+			Icon:                     preset.Icon,
 		}
 		for _, presetParam := range presetParams {
 			if presetParam.TemplateVersionPresetID != preset.ID {

diff --git a/coderd/provisionerdserver/provisionerdserver.go b/coderd/provisionerdserver/provisionerdserver.go
@@ -2264,6 +2264,7 @@ func InsertWorkspacePresetAndParameters(ctx context.Context, db database.Store,
 				prebuildSchedules = protoPreset.Prebuild.Scheduling.Schedule
 			}
 		}
+
 		dbPreset, err := tx.InsertPreset(ctx, database.InsertPresetParams{
 			ID:                  uuid.New(),
 			TemplateVersionID:   templateVersionID,
@@ -2273,6 +2274,8 @@ func InsertWorkspacePresetAndParameters(ctx context.Context, db database.Store,
 			InvalidateAfterSecs: ttl,
 			SchedulingTimezone:  schedulingTimezone,
 			IsDefault:           protoPreset.GetDefault(),
+			Description:         protoPreset.Description,
+			Icon:                protoPreset.Icon,
 		})
 		if err != nil {
 			return xerrors.Errorf("insert preset: %w", err)

diff --git a/codersdk/presets.go b/codersdk/presets.go
@@ -16,6 +16,8 @@ type Preset struct {
 	Parameters               []PresetParameter
 	Default                  bool
 	DesiredPrebuildInstances *int
+	Description              string
+	Icon                     string
 }
 
 type PresetParameter struct {

diff --git a/docs/reference/api/schemas.md b/docs/reference/api/schemas.md
diff --git a/docs/reference/api/templates.md b/docs/reference/api/templates.md
diff --git a/provisioner/terraform/resources.go b/provisioner/terraform/resources.go
@@ -965,7 +965,9 @@ func ConvertState(ctx context.Context, modules []*tfjson.StateModule, rawGraph s
 				ExpirationPolicy: expirationPolicy,
 				Scheduling:       scheduling,
 			},
-			Default: preset.Default,
+			Default:     preset.Default,
+			Description: preset.Description,
+			Icon:        preset.Icon,
 		}
 
 		if slice.Contains(duplicatedPresetNames, preset.Name) {

@@ -44,9 +44,12 @@ import "github.com/coder/coder/v2/apiversion"
 //     -> `has_ai_tasks` in `CompleteJob.TemplateImport`
 //     -> `has_ai_tasks` and `ai_tasks` in `PlanComplete`
 //     -> new message types `AITaskSidebarApp` and `AITask`
+//
+// API v1.8:
+//   - Add new fields `description` and `icon` to `Preset`.
 const (
 	CurrentMajor = 1
-	CurrentMinor = 7
+	CurrentMinor = 8
 )
 
 // CurrentVersion is the current provisionerd API version.