Blogs

A CRM record only shows its current values. When something looks wrong—an unexpected status, a missing related Contact, a field nobody remembers changing—administrators need history, not only the latest screen.

This article explains what a SuiteCRM audit log is, what field and relationship history can show, and how to review, filter, and export that history. Product-specific steps refer to Advanced Audit Log as documented on its current product page.

What Is an Audit Log in SuiteCRM?

An audit log is a chronological sequence of record changes. Each entry shows what happened before and after an event, so you can review history instead of guessing from the current state.

SuiteCRM’s native auditing helps track field value updates. A complete picture also includes relationship linking and unlinking, plus a way to filter and export that history when you need it for review.

Why Track Changes in SuiteCRM?

Administrators typically need CRM change history for practical work, not for a dashboard of scores. When a value on a live record looks wrong, the current screen cannot tell you whether the field was always that way or whether it changed after a user edit, an import, or a relationship update.

Useful reasons include:

• Troubleshooting unexpected changes
• Reviewing SuiteCRM record history
• Identifying who changed information
• Understanding when a change occurred
• Reviewing relationship changes
• Preparing audit information for internal reviews

History answers who changed what and when. It does not, by itself, record why the user made the change unless that reason is stored in another field you have audited.

What Can You Track with Advanced Audit Log?

Advanced Audit Log records two documented categories of history.

Field Changes

Field-level change tracking captures old and new values for audited fields. You can see what a field was, what it became, who changed it, and when.

Relationship Changes

A relationship audit log tracks when records are linked or unlinked between modules. That is separate from field edits.

Field-Level Change History in SuiteCRM

For audited fields, history can show:

• The old value
• The new value
• The user associated with the change
• When the change occurred

That combination is enough to explain “what changed” on a field: the before/after values plus who and when. Module field history tracking is based on the audit log for those enabled fields.

Only fields enabled for audit are logged that way. The product page does not document extra metadata such as IP address, reason codes, or client type.

How to Track Old and New Values

The useful comparison is before versus after. For example:

Status: Pending → Approved

The audit history lets you compare the previous and current values. It does not claim automatic conflict detection, rollback, or restoring the old value.

Tracking Relationship Changes in SuiteCRM

Relationship history records when a relationship is created (linked) or removed (unlinked) from the module. That matters in CRM workflows where the important change is not a field value but whether two records are still related.

The product page example: on an Account’s detail view, you can see when Contact Mr. John was added and by whom. If that relationship is removed, that event is logged as well. The same linking/unlinking idea applies across modules the product describes as relationship audit—not only field edits.

How to Enable Audit Logging for a SuiteCRM Module

Some modules can already be audit-enabled. For another module, an admin can enable auditing without upgradesafe vardef work:

1. Go to Admin → Audit Log settings.
2. The select box lists modules that are audit enabled.
3. Select the additional module in the multiselect.
4. Save.

After save, that module is audit enabled. Enable the module first; then choose which fields to log. View Audit Log appears on the record detail view once the module is audit enabled.

How to Select Fields for Auditing

To add a field to the audit log:

1. Go to Admin → Studio → Your Module → Fields.
2. Open the field.
3. Mark the Audit checkbox.
4. Save.

From then on, changes to that field are logged. The product page does not state that every field type is supported, so this article does not claim that.

How to View the Audit History of a Record

When auditing is enabled for a module, the record detail view includes a View Audit Log button. Opening it shows a modal with:

• Changed fields, including old and new values
• Relationship events (linked or unlinked)

That is the documented review path. Extra screens or widgets are not described here.

How to Filter SuiteCRM Audit Logs

Documented filters:

• Field — a list of fields enabled for audit, so you can isolate one field’s history
• User — a dropdown of users, so you can see changes associated with a selected user
• Timeframe — actions in a chosen period; by default, all data is listed irrespective of timeframe

Use field filter when you care about one value, user filter during an investigation, and timeframe when you already know approximately when the change happened. Combining filters before export keeps the CSV focused on the same subset you reviewed on screen.

How to Export SuiteCRM Audit Logs to CSV

You can export field history and relationship history to a CSV file based on the selected filter. Apply Field, User, or Timeframe filters first if you only need a subset.

CSV is the documented export format. XLSX, PDF, JSON, API export, scheduled exports, and automated reports are not documented.

Field History vs Relationship History

Example: Investigating a Changed CRM Record

An Account status looks unexpected. An administrator can work through the history without assuming why the user made the change:

1. Open the record.
2. Click View Audit Log.
3. Review old and new field values.
4. See which user is associated with the change.
5. Narrow the timeframe if needed.
6. Check relationship history if related records also look wrong.
7. Filter by field, user, or timeframe.
8. Export to CSV if a copy is needed for an internal review.

The log shows what changed, who is associated with it, and when. It does not record a free-text reason unless that exists as another audited field.

Example: Reviewing Relationship Changes

Using the documented Account and Contact example: open the Account, use View Audit Log, and review whether Contact Mr. John was linked, when, and by whom. If the relationship was later unlinked, that removal is also in the log.

Auditing SuiteCRM Modules and Fields

These are two different administrator actions:

• Module auditing — enable the module in Admin → Audit Log settings so the module can be tracked and View Audit Log is available.
• Field auditing — enable Audit on individual fields in Studio so those fields record old and new values.

Enabling a module does not automatically mean every field is logged. Select the fields you need.

A Practical SuiteCRM Audit Workflow

1. Identify the module.
2. Enable audit logging in Admin → Audit Log settings.
3. Select fields in Studio and mark Audit.
4. Wait for (or make) changes to those fields or relationships.
5. Open the record.
6. Click View Audit Log.
7. Review field history (old/new values, user, time).
8. Review relationship history (linked or unlinked).
9. Filter by field, user, or timeframe.
10. Export to CSV when you need a file copy.

When Is SuiteCRM Audit History Useful?

Typical informational uses include troubleshooting, reviewing unexpected changes, investigating field history, reviewing relationship changes, and preparing audit information for internal reviews. Support, admin, and operations teams can use the before/after context on the record itself.

The product page describes CSV export for internal reviews and compliance reporting. This article does not claim legal certification, GDPR/HIPAA/SOC2 coverage, or that the add-on “ensures compliance.”

Advanced Audit Log for SuiteCRM

Advanced Audit Log for SuiteCRM provides the documented capabilities covered above:

• Field-level history with old and new values
• Relationship linking and unlinking
• View Audit Log on the record detail view
• Filters by field, user, and timeframe
• CSV export of field and relationship history based on the selected filter
• Admin → Audit Log settings to enable modules
• Studio Audit checkbox to select fields

The current product page states support for SuiteCRM 7.x and SuiteCRM 8.8 or greater.

Learn more about Advanced Audit Log for SuiteCRM.

Frequently Asked Questions