{"_id":"5536e74dbbb4a70d00a53536","category":{"_id":"5536e6bf7fe60f0d000fd1c0","__v":18,"pages":["5536e6ed9f7f2d0d00b1cd56","5536e736bbb4a70d00a53534","5536e73f9f7f2d0d00b1cd59","5536e74dbbb4a70d00a53536","5536e7569f7f2d0d00b1cd5b","5536e7609f7f2d0d00b1cd5d","5536e76b20d5ca0d0001580d","5536e78220d5ca0d0001580f","5536e797b91d030d004c3d91","5536e7a120d5ca0d00015811","5536e7b320d5ca0d00015813","5536e7bbbbb4a70d00a5353a","5536e7c99f7f2d0d00b1cd60","5536e7d29030530d0007f860","5536e7dbbbb4a70d00a5353c","5536e7e69f7f2d0d00b1cd62","5571ef581cd8283500a8b4de","55b80d6be89bbf25009f045b"],"project":"55357364e02d480d0003c6d3","version":"553591cd63cc650d00312925","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-04-22T00:09:35.017Z","from_sync":false,"order":9,"slug":"form-fields","title":"Form Fields"},"version":{"_id":"553591cd63cc650d00312925","project":"55357364e02d480d0003c6d3","__v":13,"forked_from":"55357365e02d480d0003c6d6","createdAt":"2015-04-20T23:54:53.134Z","releaseDate":"2015-04-20T23:54:53.134Z","categories":["553591cd63cc650d00312926","553591cd63cc650d00312927","5536e4d39f7f2d0d00b1cd54","5536e55c20d5ca0d0001580a","5536e6bf7fe60f0d000fd1c0","5536f5bba171250d00c00556","553a974369c2630d00a8562e","553a97c60074c80d00621c2a","553a98332af5f20d000fc32a","553a9b9869c2630d00a85642","556e0f23d02e0b190042f13d","563249b1dcc27a1700823650","5639113f049e420d00476b03","59a5dd94aaa11d003334edb4"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"2.0.0","version":"2"},"__v":11,"project":"55357364e02d480d0003c6d3","user":"55356ede6040a20d00454508","parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-04-22T00:11:57.624Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":3,"body":"The Image Field is responsible for storing a path to an uploaded image.  The property `imageFile` is a `File` property type and has the following properties:\n\n- `id` - The `id` to a uploaded file to the `Files` endpoint.\n- `link` - A downloadable `link` to that file's location in storage.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"NOTE:\",\n  \"body\": \"The `link` property is read-only and will not be persisted if it is updated.\"\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n\\t\\\"Image\\\": {\\n      \\\"imageFile\\\": {\\n        \\\"id\\\": \\\"58078f6c-964c-4b27-96b5-a46c01094f2b\\\",\\n        \\\"link\\\": \\\"https://api.goformz.com/v2/files/58078f6c-964c-4b27-96b5-a46c01094f2b\\\"\\n      },\\n      \\\"id\\\": \\\"fbbd61f4-fbb8-4fb4-8207-a46c0108d3ca\\\",\\n      \\\"name\\\": \\\"Image\\\",\\n      \\\"type\\\": \\\"Image\\\"\\n    }\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"NOTE:\",\n  \"body\": \"The id, name, and type are not necessary when setting or updating the Image Field. These properties are returned in the JSON of the request for readability.\"\n}\n[/block]\nThe Image Field requires uploading a `File` first and then assigning that uploaded file's `id` with the `imageFile > id` property.  For more details see the section: \"[Uploading a file](doc:uploading-a-file)\".","excerpt":"","slug":"image-field","type":"basic","title":"Image Field"}
The Image Field is responsible for storing a path to an uploaded image. The property `imageFile` is a `File` property type and has the following properties: - `id` - The `id` to a uploaded file to the `Files` endpoint. - `link` - A downloadable `link` to that file's location in storage. [block:callout] { "type": "info", "title": "NOTE:", "body": "The `link` property is read-only and will not be persisted if it is updated." } [/block] [block:code] { "codes": [ { "code": "{\n\t\"Image\": {\n \"imageFile\": {\n \"id\": \"58078f6c-964c-4b27-96b5-a46c01094f2b\",\n \"link\": \"https://api.goformz.com/v2/files/58078f6c-964c-4b27-96b5-a46c01094f2b\"\n },\n \"id\": \"fbbd61f4-fbb8-4fb4-8207-a46c0108d3ca\",\n \"name\": \"Image\",\n \"type\": \"Image\"\n }\n}", "language": "json" } ] } [/block] [block:callout] { "type": "info", "title": "NOTE:", "body": "The id, name, and type are not necessary when setting or updating the Image Field. These properties are returned in the JSON of the request for readability." } [/block] The Image Field requires uploading a `File` first and then assigning that uploaded file's `id` with the `imageFile > id` property. For more details see the section: "[Uploading a file](doc:uploading-a-file)".