Themes

Update theme

put

https://api.typeform.com/themes/{theme_id}

Updates a theme in your Typeform account. NOTE: You can't change Typeform's public themes (the built-in themes that are available in all accounts).

Request

Path Parameters

theme_id

string, required

Unique ID for the theme.

Request Body

background

object

Settings for the background.

brightness

number

Brightness for the background. -1 is least bright (minimum) and 1 is most bright (maximum).

href

string

Background image URL.

layout

string

Valid values:fullscreenrepeatno-repeat

Default:fullscreen

Layout for the background.

colors

object

Colors the theme will apply to answers, background, buttons, and questions.

answer

string, required

Default:#4FB0AE

Color the theme will apply to answers. Hexadecimal value.

background

string, required

Default:#FFFFFF

Color the theme will apply to the background. Hexadecimal value.

button

string, required

Default:#4FB0AE

Color the theme will apply to buttons. Hexadecimal value.

question

string, required

Default:#3D3D3D

Color the theme will apply to questions. Hexadecimal value.

fields

object

Defines font size and alignment for fields.

alignment

string, required

Valid values:leftcenter

Default:left

Fields alignment

font_size

string, required

Valid values:smallmediumlarge

Default:medium

Fields font size

font

string

Valid values:AcmeArialArvoAvenir NextBangersCabinCabin CondensedCourierCrete RoundDancing ScriptExoGeorgiaHandleeHelvetica NeueKarlaLatoLektonLobsterLoraMcLarenMontserratNixie OneOld Standard TTOpen SansOswaldPlayfair DisplayQuicksandRalewaySignikaSnigletSource Sans ProVollkorn

Default:Source Sans Pro

Font for the theme.

has_transparent_button

boolean

true if buttons should be transparent. Otherwise, false.

name

string

Name for the theme.

rounded_corners

string

Valid values:nonesmalllarge

Default:small

Specifies border radius style of buttons and other elements in the form.

screens

object

Defines font size and alignment for welcome and thankyou screens.

alignment

string, required

Valid values:leftcenter

Default:center

Screen alignment

font_size

string, required

Valid values:smallmediumlarge

Default:small

Screen font size

Example

{
  "background": {
    "brightness": -0.59,
    "href": "https://images.typeform.com/images/8p9aHGJup9EP",
    "layout": "fullscreen"
  },
  "colors": {
    "answer": "#800000",
    "background": "#FFFFFF",
    "button": "#808080",
    "question": "#000000"
  },
  "fields": {
    "alignment": "left",
    "font_size": "medium"
  },
  "font": "Arial",
  "has_transparent_button": false,
  "name": "My theme",
  "rounded_corners": "small",
  "screens": {
    "alignment": "center",
    "font_size": "small"
  },
  "visibility": "private"
}

Response

Status

200 OK

Schema

background

object

Settings for the background.

brightness

number

Brightness for the background. -1 is least bright (minimum) and 1 is most bright (maximum).

href

string

Background image URL.

layout

string

Valid values:fullscreenrepeatno-repeat

Default:fullscreen

Layout for the background.

colors

object

Colors the theme will apply to answers, background, buttons, and questions.

answer

string

Color the theme will apply to answers. Hexadecimal value.

background

string

Color the theme will apply to background. Hexadecimal value.

button

string

Color the theme will apply to buttons. Hexadecimal value.

question

string

Color the theme will apply to questions. Hexadecimal value.

fields

object

Defines font size and alignment for fields.

alignment

string

Valid values:leftcenter

Default:left

Fields alignment

font_size

string

Valid values:smallmediumlarge

Default:medium

Fields font size

font

string

Default:Source Sans Pro

Font for the theme.

has_transparent_button

boolean

true if buttons should be transparent. Otherwise, false.

string

Unique ID of the theme.

name

string

Name of the theme.

rounded_corners

string

Valid values:nonesmalllarge

Default:small

Specifies border radius style of buttons and other elements in the form.

screens

object

Defines font size and alignment for welcome and thankyou screens.

alignment

string

Valid values:leftcenter

Default:center

Screen alignment

font_size

string

Valid values:smallmediumlarge

Default:small

Screen font size

visibility

string

Valid values:publicprivate

Default:private

Specifies whether the theme is public (one of Typeform's built-in themes that are available in all accounts) or private (a theme you created). You can only change private themes. You can't change Typeform's public themes.

Example

{
  "background": {
    "brightness": -0.59,
    "image_id": 987,
    "layout": "fullscreen"
  },
  "colors": {
    "answer": "#800000",
    "background": "#FFFFFF",
    "button": "#808080",
    "question": "#000000"
  },
  "fields": {
    "alignment": "left",
    "font_size": "medium"
  },
  "font": "Arial",
  "has_transparent_button": false,
  "id": 456,
  "name": "My theme",
  "rounded_corners": "small",
  "screens": {
    "alignment": "center",
    "font_size": "small"
  },
  "visibility": "private"
}