Email Queue
How to use Email Queue in Email & Notifications: access, working steps, fields, related records and troubleshooting.
Purpose and access
Maintain sending and receiving configuration, templates and notification rules. Check sender identity and delivery before enabling automatic notifications. Never place mailbox passwords or service keys in documentation or public fields.
This page is a internal/admin record in System Admin → Email & Notifications. Use the link above to open the configured destination; permissions are checked by the destination service.
Before you start
Review the current settings or existing records and prepare the information needed for the change.
Confirm the company, party, dates, units and source references that apply. Select existing links carefully and check for an existing record before creating a duplicate.
Working steps
- Open Email Queue from System Admin → Email & Notifications, or use ERP Search.
- Filter the list and open the relevant record. To add a record, use Add/New when your role provides that action.
- Complete the editable fields described below. Required fields and validation conditions must be satisfied; read-only values are set by the system or their source records.
- Add the required child rows. Review each row’s identifiers, linked records and values, using the child-table field reference below.
- Save the record and address validation messages. Reload and verify the saved values and relationships.
- Use any additional workflow actions only when the record and your role provide them. Saving this record does not automatically complete a related transaction or external action.
Field reference
These fields come from the installed ERP definition. Hidden fields and password inputs are omitted. Additional conditions, custom scripts and workflow rules can make a field required or read-only in a particular context.
| Field | Type / behavior | How to use it |
|---|---|---|
Sendersender | Data Optional | Enter the identifier or short text requested by the label. Preserve external reference numbers accurately. |
Recipientrecipients | Table Optional | Add the relevant child rows and review required columns, quantities and references before saving. Linked record: Email Queue Recipient |
Show as ccshow_as_cc | Small Text Optional | Provide concise contextual information relevant to the record. Avoid unrelated personal or confidential data. |
Messagemessage | Code Optional | Administrator/integration field. Use a validated configuration or supported script and test its impact before deployment. |
Errorerror | Code Optional | Administrator/integration field. Use a validated configuration or supported script and test its impact before deployment. |
Message IDmessage_id | Small Text Optional · Read-only | Provide concise contextual information relevant to the record. Avoid unrelated personal or confidential data. |
Reference Document Typereference_doctype | Link Optional · Read-only | Choose an existing linked record. Check its company and ownership; typing a label alone does not create a new relationship. Linked record: DocType |
Reference DocNamereference_name | Data Optional · Read-only | Enter the identifier or short text requested by the label. Preserve external reference numbers accurately. |
Communicationcommunication | Link Optional | Choose an existing linked record. Check its company and ownership; typing a label alone does not create a new relationship. Linked record: Communication |
Send Aftersend_after | Datetime Optional · Read-only | Record the date and time in the configured system/user time zone. |
Prioritypriority | Int Optional · Read-only | Enter a whole-number value. |
Add Unsubscribe Linkadd_unsubscribe_link | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Unsubscribe Paramsunsubscribe_params | Code Optional · Read-only | Administrator/integration field. Use a validated configuration or supported script and test its impact before deployment. |
Unsubscribe Methodunsubscribe_method | Data Optional | Enter the identifier or short text requested by the label. Preserve external reference numbers accurately. |
Expose Recipientsexpose_recipients | Data Optional | Enter the identifier or short text requested by the label. Preserve external reference numbers accurately. |
Attachmentsattachments | Code Optional · Read-only | Administrator/integration field. Use a validated configuration or supported script and test its impact before deployment. |
Retryretry | Int Optional · Read-only | Enter a whole-number value. |
Email Accountemail_account | Link Optional | Choose an existing linked record. Check its company and ownership; typing a label alone does not create a new relationship. Linked record: Email Account |
Send As Raw HTMLraw_html | Check Optional · Read-only | Raw HTML emails are rendered as complete Jinja templates. Otherwise, emails are wrapped in the standard.html email template, which inserts brand_logo, header and footer. |
Redact Message After Sendredact_message_after_send | Check Optional · Read-only | Replace the message body with a placeholder once the email has been sent, so that sensitive content like password reset links is not retained in the queue. |
Child tables
Recipient — child-row fields
| Field | Type / behavior | How to use it |
|---|---|---|
Recipientrecipient | Data Optional | Enter the identifier or short text requested by the label. Preserve external reference numbers accurately. |
Statusstatus | Select Optional | Choose one of the configured list values. Status fields may be controlled by the record workflow.Available choices
|
Errorerror | Code Optional | Administrator/integration field. Use a validated configuration or supported script and test its impact before deployment. |
Troubleshooting
- Not permitted: verify the account, role and source-document permission. Do not share an administrator login.
- Missing record or address: inspect the relevant Link or Dynamic Link fields; a matching title alone does not establish a relationship.
- Cannot save or change status: review required fields, read-only values, document status and the configured approval transition.
- Unexpected report or portal result: review company/date filters, source-document submission and the approved party or Employee link.