Troubleshooting

A submission doesn't appear in Notion

Check these in order:

• Published is set to Yes on the form's Notion tab (Form Properties > Notion).
• The Notion API key is entered under Components > RSForm! Pro > Configuration > Notion, and hasn't been revoked on the Notion side.
• The Database ID is correct and the integration has been given access to that database, see "Give the integration access" in "Internal integration secret key".
• If Trigger on payment is set to Yes, the page is only created after a successful payment confirmation, not right after the visitor submits the form.

A wrong API key or database ID shows an on-screen error in the mapping table instead of failing silently, with the reason Notion gave underneath it.

Where can I see what went wrong?

Every failed call to Notion is written to a log file called plg_system_rsfpnotion.php. You'll find it in your log folder, which is listed in the Joomla administrator under System > Global Configuration > System > Path to Log Folder.

Each line holds the date, the status Notion returned and the message that came with it, for example that the database wasn't found or that the integration has no access to it. Values that were skipped are logged there too, such as a property that no longer exists in your Notion database or a number field that received something other than a number. Your integration secret is never written to the log.

Some fields arrive empty, or a field doesn't map at all

An empty RSForm! Pro field is skipped rather than sent as a blank value, so a missing value in Notion usually means the source field was empty on submission. Some property types also need a value in a certain shape, see "Values that need a certain format" in "Notion Settings in Form Properties".

A field that never arrives at all is usually mapped to a property that has since been renamed or removed in Notion. Both cases are named in the log file, see "Where can I see what went wrong?" above.

A comment isn't posted on the Notion page

The comments mapping only works if you enabled Comment capabilities when you created the integration. Without it, the plugin still creates the Notion page, it just can't add the comment. Nothing is shown on the site, but the failure is written to the log file. See "Internal integration secret key".

Trigger on payment stopped working after I removed a plugin

Trigger on payment depends on the RSForm! Pro Payment Package. If you disable or uninstall the Payment Package after enabling this option, submissions stop syncing to Notion entirely: the normal after-submit trigger still skips them because the option is still Yes, and the payment-confirmation trigger no longer fires. Set Trigger on payment back to No if you remove the Payment Package.

FAQ

Which Notion property types are supported?

Title, Text, Number, Select, Multi-select, Date, Checkbox, URL, Email, and Phone. Properties of any other type, such as Files & media, People, Relation, Formula and Rollup, can't be filled in. They aren't offered in the mapping table, they're listed in a notice below it instead.

My Notion database has more than one data source, which one is used?

The first one. The Notion tab of your form lists every data source it found, each with its own ID, so you can copy the ID of another one into the Database ID field to write to that table instead. Databases with a single data source, which is most of them, keep working without any change.

When is a checkbox ticked?

An empty value and the values 0, no, false and off, including their Dutch, German, French, Spanish and Italian equivalents, leave the checkbox unticked. Any other value ticks it.

Is my integration secret visible in the Joomla backend?

No. The field on the RSForm! Pro configuration screen is masked, so the secret can't be read off the screen. It's also never written to the log file.

Can the same form submission be sent to Notion twice?

No. The plugin tracks which submissions it has already processed, so a submission is never sent to Notion more than once, even if multiple RSForm! Pro events fire for it.

Does this work with more than one form?

Yes. Notion settings, published, database, mappings, are stored per form on that form's own Notion tab. Configure each form independently.

What happens if I disable the RSForm! Pro Notion plugin?

Submissions stop syncing to Notion until you re-enable it. Nothing already sent to Notion is affected, and your per-form mapping settings are kept, they're used again once the plugin is active.