Skip to main content

Manage Attachments on Subscription

Zuora

Manage Attachments on Subscription

Use attachments in Zuora to upload documents of various formats to associate additional information with accounts, subscriptions, invoices, credit memos, or debit memos. Example attachments could be purchase orders (PO's), tax exemption document, or ownership transfer forms.

Credit memos or debit memos are available if you have the Invoice Settlement feature enabled. The Invoice Settlement feature is in Limited Availability. If you want to have access to the feature, submit a request at Zuora Global Support

You can upload any number of attachments for each supported Zuora record, up to the value set in the Maximum number of attachments per record field in tenant profile.

An attachment can belong to only one Zuora record, such as a specific invoice, a credit memo, a debit memo, a subscription, or a customer account.

For subscriptions, an attachment is tied to all versions of the subscription via the Subscription Number.

See Attachments for managing attachments through Zuora REST API.

Required Permissions

To view attachments on an account, subscription, invoice, credit memo, or debit memo, you must have the permission to view the specific account, subscription, or invoice. You must also have a Billing role that includes the Manage Attachments permission.

To add or edit attachments on an account, subscription, invoice, credit memo, or debit memo, you must have:

  • The permission to update (create or manage) the specific account, subscription, or invoice
  • The 'API Write Access' platform permission
  • A Billing role that includes the Manage Attachments permission

To delete attachments, you must have a Billing role that includes the Manage Attachments permission and the Delete Attachments permission.

To change your Billing role, contact your Zuora platform administrator. For information about assigning Billing roles to users, see Billing roles.

Limits

The following limits apply to attachments.

Maximum size of one attachment file 4MB
Total maximum size of all attachment files in one tenant 8GB
Maximum number of attachments on one record 200
Executable files as attachments Not supported 

Supported File Types

Files with the following extensions can be used as attachments in Zuora.

  • .pdf
  • .csv
  • .png
  • .xlsx
  • .xls
  • .doc
  • .docx
  • .msg
  • .jpg
  • .txt
  • .htm
  • .html
  • .eml
  • .pptx
  • .gif
  • .rtf
  • .xml
  • .jpeg
  • .log
  • .cls

Manage Attachments in UI

Follow the steps in this section to add, view, edit, or delete an attachment on a Customer Account, Subscription, Invoice, Credit Memo, or Debit Memo detail page.

To add an attachment:

  1. In the Attachments section, click + new attachment.
  2. Click choose file and select the file you want to attach.
    See Supported File Types for the types of files you can use as attachments.
  3. In the Description field, give a description of the attachment.
  4. Click save.

To delete an attachment:

  1. In the Attachments section, click the title of the attachment you want to delete.
  2. Click the action menu bar and select Delete.
  3. Click OK to confirm.

To edit an attachment:

  1. In the Attachments section, click the title of the attachment you want to edit.
  2. You can edit the file name and the description of the attachment.
  3. You cannot edit the content in the attachment file. To edit the file content, delete the attachment and add another the updated attachment.
  4. Click save.

To download an attachment:

  • In the Attachments section, click the title of the attachment you want to download.