--- category: [Platform and Product Extensions/Workday Extend, Platform and Product Extensions, Administration & Integrations, Administration & Integrations/Custom Integrations & Apps, Platform and Product Extensions/Integration] keyword: [Extend, App Builder, Model Components, Attachments, Attachment Objects] nav: wcp_docs parent_url: /wcp_docs/ title: Add Attachments in Visual Mode layout: subsection --- ### Prerequisites Create or open a Workday Extend app in App Builder. ### Context You can store file data and images in attachment objects. ### Steps 1. In App Builder, click the Add button next to Attachments in the components panel. 2. Use the toggle switch in the upper right of the interface to ensure that App Builder is in Visual mode. 3. Use the Attachment tab to provide fundamental information about your component. As you complete this tab, consider:

Option	Description
Name	Provide a name for the attachment. The name must begin with an uppercase alphabetic character (A–Z) and contain only alphanumeric characters (A–Z, a – z, 0–9). The maximum length allowed is 100 characters.
Label	Provide a label that succinctly indicates the nature of the attachment. If you specify a `label`, it must be unique for each model component type within an app. If you don't specify a `label`, Workday displays the `name` in the tenant.
Default Collection Name	Provide a name for Extend to use as an identifier for REST API resource to access all instances of the attachment object. Workday recommends that you use a pluralization of your object. Example: charityLogos.
Default Collection Label	Provide a label for Extend to use as the unfiltered report data source for the attachment object. Workday recommends that you prefix the attachment object with All and then pluralize it. Example: All Charity Logos.
Default Security Domains	Select the default security domains that control access to the attachment object. Each attachment object requires at least 1 default security domain. You can only use the names of security domains defined in the same app.
Enable for Purge	Specify whether you want to enable your app to support the purging of the attachment object's data and filename.

4. The Fields tab displays the fields that you've created for your attachment. As you add a new field, on the Properties and Security tabs, consider:

Option	Description
Name	Provide a name for the field. The name must begin with a lowercase alphabetic character (a–z) and contain only alphanumeric characters (A–Z, a – z, 0–9). The maximum length allowed is 100 characters.
Label	Provide a label that succinctly indicates the purpose of the field.
Type	Specify of the type of data that the field contains. These types are available: TEXT DECIMAL BOOLEAN INTEGER DATE CURRENCY SINGLE_INSTANCE
Enable Reference ID	Applies to text fields only. Enable this toggle to designate this field as the Reference ID of the attachment object. When you mark a field as the Reference ID, the field is required, and you can't delete it. You can only configure this attribute once for each attachment object.
Enable as Display Name	Applies to text and single instance fields only. Enable this toggle to use the contents of this field to set the display value of the attachment. You can only configure this attribute once for each attachment.
Enable for Purge	Specify whether you want to enable your app to support the purging of the instance field data.
Decimals	Applies to decimal fields only. Specify the number of decimal places that the number uses. The allowed range is 1–5.
Precision	Applies to date fields only. Specify how precise the date is. These levels of precision are available: Millisecond Second Minute Hour Day Month Year
Filter Targets/Relates To	Applies to single instance fields only. Select a target business object defined in the same app or a target Workday-delivered business object.
Enable Security by Target	Applies to single instance fields only. Enable this toggle to delegate contextual security to the instance of the target business object in addition to the security it applies to the Extend business object. You can only configure this attribute once for each attachment.
Default Security Domains	The default security domains that control access to the attachment object.
Security Domains	Specify security domains to override the default security domains defined at the business object level. You can only use the names of security domains defined in the same app.

5. The Derived Fields tab displays the fields that you've created for your business object. As you add a new field, on the Properties and Security tabs, consider:

Option	Description
Name	Provide a name for the field. The name must begin with a lowercase alphabetic character (a–z) and contain only alphanumeric characters (A–Z, a – z, 0–9). The maximum length allowed is 100 characters.
Label	Provide a label that succinctly indicates the purpose of the field.
Type	Specify of the type of data that the field contains. These types are available: TEXT DECIMAL BOOLEAN INTEGER DATE Note: Extend doesn't support the CURRENCY or SINGLE_INSTANCE field types for derived fields.
Decimals	Applies to decimal fields only. Specify the number of decimal places that the number uses. The allowed range is 1–5. Note: Once your app has been promoted, you can only increase the number of decimal places. You can't decrease it.
Date	Applies to date fields only. Specify how precise the date is. These options are available: Millisecond Second Minute Hour Day Month Year
Expression	Enter an expression to define the content in the field. See Reference: Derived Fields.
Default Security Domains	The default security domains that control access to the business object.
Security Domains	Specify security domains to override the default security domains defined at the business object level. You can only use the names of security domains defined in the same app.

6. The Relationships tab displays the 1-to-1 relationships between business objects, attachment objects, and Workday-delivered targets. Click Add Relationship to define the properties of a new relationship. Those properties are as described above for the Fields tab. You can create relationships: - Between your app's business objects and attachment objects, in any direction. - From your app's business objects and attachment objects to Workday-delivered targets.