---
sourceDocument: Brazil ServiceNow AI Platform Administration
sourceDocumentLink: https://www.servicenow.com/docs/r/platform-administration

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil ServiceNow AI Platform Administration

ft:clusterId :

    - platadm

bundleId :

    - platadm

workflow :

    - Platform


---

# Attachments

# Administering attachments {#ariaid-title1}

Release version: Brazil  
Updated September 10, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes to read
Summarize  
![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI  
This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.  

## Summary of Administering attachments

ServiceNow administrators can configure how file attachments are uploaded, viewed, and managed within the platform.
This includes setting system properties to control file size limits, attachment indexing, thumbnail scaling, and user permissions.
Attachment actions trigger specific events usable in notifications or scripting, enabling enhanced tracking and automation.
Show full answer Show less  

## Attachment Storage and Management

* Attachment metadata is stored in the **sysattachment** table, while file data is saved in 4KB chunks in the **sysattachmentdoc** table.
* Uploading, viewing, deleting, and renaming attachments generate distinct events for processing or notification purposes.
* Attachments can be indexed on specific tables to allow text search across records and their attached files.

## Thumbnail Scaling and Image Handling

* The system property **glide.ui.activitystream.scaleimages** enables automatic thumbnail creation for large images in activity streams, scaling them to a maximum of 525 pixels wide by 350 pixels high.
* To prevent out-of-memory errors when attaching large images (over 5 MB), the **com.glide.attachment.maxgetsize** property can be set to specify the maximum size for image scaling. Images larger than this threshold will not be scaled but linked instead.

## Attachment Events and Logging

* Four main attachment events are available: **attachment.read** , **attachment.uploaded** , **attachment.deleted** , and **attachment.renamed**.
* Only one event is created per action per record, even if multiple attachments are involved, except when deleting records with multiple attachments (each triggers a separate delete event).
* Attachment download events can be logged with details such as filename and table name, aiding in auditing and monitoring.

## Debugging and System Properties

* Administrators can enable debug logging for attachment indexing using properties like **glide.ts.index.attachment.debug** and **glide.ts.index.attachment.listterms.debug**.
* Normal operations should keep verbose debug logging disabled for performance, enabling it only during troubleshooting.

## Configurable Attachment Settings

* Drag-and-drop upload of attachments can be disabled while still allowing file browsing uploads.
* File size limits and allowed file extensions can be restricted to control upload behavior.
* Attachments can be disabled entirely on specific tables to prevent users from adding files.
* The \[view\] link beside attachments, which opens files in-browser executing JavaScript, can be hidden for security while still allowing access via the file name link.
* Attachment icons can be customized based on file type for better visual identification.  
Administrators can configure system properties for how files are uploaded and attached
to records. Uploading, viewing, and deleting file attachments triggers a single event that can
be used for notifications or in scripts.

## Attachment tables {#r_AdministeringAttachments__section_sn5_rnw_t1b}

When you store an attachment to any table, a record is created in the Attachment
\[sys_attachment\] table that contains attachment metadata. The file data is stored in the
Attachment Document \[sys_attachment_doc\] table, in 4k chunks. For example, if you attach a
12k file called My_attachment.pdf, then there is an Attachment entry
with three related Attachment Document entries.

To learn how to upload attachments to records, see [Add and manage attachments](https://www.servicenow.com/docs/access?context=t_AddingAnAttachment&version=brazil&pubname=brazil-platform-user-interface&ft:locale=en-US).

## Activity stream thumbnail scaling {#r_AdministeringAttachments__section_zdr_n2x_t1b}

The glide.ui.activity_stream.scale_images property scales large images down and creates thumbnails for the activity stream view of the images. This property is active by default. It applies to images retroactively, so any attachments included in an activity stream in the past also see the effects.

* Maximum dimensions for thumbnails using this property are 525 pixels width by 350 pixels height. The system favors the pixel height first, so you can end up with images that are wider than 525 pixels.
* Attaching image files over 5 MB can create an out of memory error and cause the instance to restart. An out of memory error and restart occur when the system generates the thumbnail when you attach a new image. The error and restart can also occur the first time you load existing images on a record.
* The administrator can add the com.glide.attachment.max_get_size system property to control the maximum image scaling dimensions.
{#r_AdministeringAttachments__ul_u4p_rrm_rkb}  
Enter the following information into the \[sys_properties.list\] table:{#r_AdministeringAttachments__table_tg1_mnt_51b__entry__2}

| Field | Description |
|-|-|
| Name | com.glide.attachment.max_get_size |
| Type | integer |
| Value | 5242880 |
[ ]

{#r_AdministeringAttachments__table_tg1_mnt_51b}  
The value field represents the size in bytes.

* The base system value is 5242880 bytes (5 MB). You can change the value as necessary.
* With this property set, images that are larger than 5 MB are not scaled and the system creates a link instead. Images smaller than 5 MB are scaled down.
{#r_AdministeringAttachments__ul_pvd_wrm_rkb}

## Configure the max image size property for Activity Streams {#r_AdministeringAttachments__section_xnv_4qz_51b}

When attaching an image in an Activity Stream, the system controls the maximum size of the
image. Use the com.glide.attachment.max_get_size property to control
the maximum image scaling dimensions.

## Attachment events and logging {#r_AdministeringAttachments__section_ojh_wnw_t1b}

A script action or notification can process attachment events. Only one event is created
when action is taken on a record with attachments, even when the record has multiple
attachments. The following events are provided.

Only one event is created when action is taken on a record with attachments, even when the
record has multiple attachments. The following events are provided.
{#r_AdministeringAttachments__table_yrk_h4w_p4__entry__2}

| Event | Description |
|-|-|
| attachment.read | An attachment has been read or downloaded. |
| attachment.uploaded | An attachment has been uploaded. If multiple attachments are uploaded to a record at one time, only one event is created. |
| attachment.deleted | An attachment has been deleted. This event is also triggered when the record containing the attachment is deleted. If a record is deleted that contains multiple attachments, a separate event is triggered for each attachment in the deleted record. |
| attachment.renamed | An attachment has been renamed. |
[Table 1. Attachment events]

{#r_AdministeringAttachments__table_yrk_h4w_p4}

## Attachment logging {#r_AdministeringAttachments__section_akw_2nw_t1b}

When an attachment is downloaded, the attachment.read event record is written, and you can do something with this event. For example, you can record when and by whom certain attachments are downloaded. For this functionality, current is a sys_attachment record, and the event record uses the following parameters:

* parm1: File name
* parm2: Table name
{#r_AdministeringAttachments__ul_s1t_3yg_xw}

## Debug attachment indexing {#r_AdministeringAttachments__section_blr_z2x_t1b}

To change debugging options for attachment indexing, add these system properties.  
* glide.ts.index.attachment.debug: When the value is set to true, enables log messages for exceptions that occur when indexing attachments (default is false).

  You can leave this
  property enabled during normal operations to capture stack trace information about any
  exceptions.
* glide.ts.index.attachment.list_terms.debug: When the value is set to true, logs all indexed terms when an attachment is indexed (default is false).

  \[Recommended\] For optimal performance, set
  this property to false during normal operations. Only enable
  this property when you are actively debugging an issue.

{#r_AdministeringAttachments__ul_ljk_npr_np}  
Note:  
To learn more about the properties that affect attachments processing, see Attachments (instance security hardening) in Instance Security Hardening Settings.
* **[Configure attachment system properties](https://www.servicenow.com/docs/yG2rN7pK7bKBPtZNhalFew#t_DisablingTheDragAndDropFeature)**   
  You can disable the drag-and-drop feature. (Users can still upload attachments by browsing to the file.) You can also limit the attachment file size, restrict who can upload attachments, and restrict what file extensions can be uploaded.
* **[Disable attachments on a table](https://www.servicenow.com/docs/djA4JHSaWNHmU4gWmekjqA)**   
  You can prevent users from adding attachments to records on a specific table.
* **[Index attachments on a table](https://www.servicenow.com/docs/B396RDkCTo9AWtKkWYO5Rw)**   
  You can enable attachment indexing for a table so text searches can return matches from the record and its file attachments.
* **[Hide the attachment \[view\] link](tEYP1hf6me~PbOZIXnFf6Q)**   
  Users can open an attachment by clicking either the file name or the \[view\] link. The \[view\] link opens the file from within the browser, which executes JavaScript code as part of the attachment. You can hide the \[view\] link. Users can still view attachments by clicking the file name.
* **[Configure attachment icons](https://www.servicenow.com/docs/7EdtY9o2rN0sfUdLZAEL6w)**   
  Configure the icon that appears beside an attachment of a particular file type.

