Settings
Activate your license, connect AI and page builders, tune performance, and move your testimonials between sites.
Everything that applies to the whole plugin, rather than to one block, lives in Settings. It's split into eight tabs down the left side: License Key, Integrations, AI Configuration, Performance, Advanced Controls, Tools, Additional CSS & JS and Classic Settings. Most people visit once to activate their license and then only come back for a specific job, so feel free to jump straight to the tab you need.

Opening Settings
- In the WordPress admin sidebar, click Real Testimonials → Settings. The dashboard opens on the Settings section with the License Key tab showing.
- Pick another tab from the settings sidebar if you need one. Each tab has its own web address (for example
#settings=performance), so you can bookmark the one you use most.
Already inside the dashboard? Click Settings in the top navigation instead.
Remember to save
The Performance, Advanced Controls, Additional CSS & JS and Classic Settings tabs share a Save Change button and a Reset button at the bottom. Save Change stays greyed out until you actually change something, and nothing applies until you click it. Reset asks you to confirm, then puts that one tab back to its defaults.
The other tabs work differently. License Key, Integrations and Tools act the moment you click. AI Configuration has its own Save Changes button inside each provider's form.
License Key
Your license is what keeps Real Testimonials working on your site: it shows your testimonials to visitors, brings in plugin updates, and gives you access to support. Activate it as soon as you've installed the plugin. The tab looks different depending on whether a key is active, so here's what to expect at each stage.
You'll be reminded until it's done
While your license isn't active, a green bar across the top of every dashboard screen says "The Real Testimonials Pro license needs to be activated." Click Activate Now in that bar to jump straight here. If your license has expired instead, the bar says so and offers Renew Now.
Activating your key
Before a key is active, the tab shows a single card titled Real Testimonials Pro License Key.

- Copy your license key from your ShapedPlugin account. Not sure where it is? The How to Find Your Key link under the card brings you to the step-by-step guide, and Your Account opens your ShapedPlugin account in a new tab.
- Paste the key into the field. It's the one with the
XXXX-XXXX-XXXX-XXXXplaceholder. - Click Activate, or just press Enter. The button reads Activating… while it checks with ShapedPlugin.
If the key is accepted, the card switches to your license details (see below). If it isn't, the reason appears in red right under the field, for example "Your license key has reached its activation limit." Fix the problem and try again. Typing in the field clears the message.
Your key stays private
After activation, the full key never comes back to your browser. The dashboard only ever shows a masked version with the first and last four characters, like ABCD••••••••••••WXYZ. Keep your own copy in your ShapedPlugin account, because you can't read the full key back from this screen.
When your license is active
Once activated, the tab shows a status card with a green check and the heading Your License Is Active, plus a line confirming that updates and priority support are switched on.

Underneath, a short table sums up your license:
| Row | What it tells you |
|---|---|
| Product | Real Testimonials Pro, with your plan underneath, such as 5 Sites Annual License or Unlimited Sites Lifetime License. |
| License Key | Your key, masked as described above. |
| Expires On | The date your license runs out, or Lifetime. |
| Licensed To | The name on your ShapedPlugin account, with the email partly hidden. Only shown when ShapedPlugin sends these details. |
| Sites | How many sites use the key, such as 2 of 5 sites activated. |
Below the table, a small line reads "Checked 5 minutes ago" with three links:
- Refresh asks ShapedPlugin about your license again, right now. Use it after you renew or upgrade, so the card picks up the change without waiting. The card simply updates in place; there's no pop-up message. It checks at most once a minute, so if you click again too soon you'll see "Your license was checked moments ago." and the card keeps the answer it already has.
- Your Account opens your ShapedPlugin account in a new tab.
- Get Support opens the ShapedPlugin support page in a new tab.
When something needs your attention
If ShapedPlugin reports a problem, the card's heading changes and, where it helps, a button appears to fix it:
| Heading you see | What it means | What to do |
|---|---|---|
| Your License Key Has Expired | Your testimonials keep displaying, but you no longer get plugin updates or support. | Click Renew License. |
| Your License Key Is Not Active on This Site | The key is fine, but this site isn't one of its activations. | Click Activate on This Site to use the stored key again in one click. |
| Your License Key Has Reached Its Activation Limit | Every site your plan allows is already in use. | Click Manage Sites to free one up in your account, or upgrade your plan. |
| This License Key Belongs to a Different Product | The key is for another ShapedPlugin product. | Click Your Account and copy the Real Testimonials key instead. |
| Your License Key Has Been Disabled | ShapedPlugin has switched the key off. | Click Get Support. |
| We Could Not Confirm Your License Key | Your site couldn't get an answer from ShapedPlugin. | Click Refresh to ask again. If it keeps failing, see Activation not working?. |
| There Is a Problem With Your License Key | Anything else ShapedPlugin reports. | Click Get Support. |
If the key on file turns out to be invalid or missing altogether, you're taken back to the empty activation field so you can enter a correct one.
Whenever the license isn't active or expired, a yellow note on the card adds: "Your testimonials are not displaying for visitors on this site until a license is active here."
Deactivating (moving to another site)
Each activation uses up one of your plan's sites. To move the license, say from a staging site to the live one, release it here first:
- Click Deactivate License on the status card.
- A box asks Deactivate License on This Site? It warns that updates and priority support stop on this site, and your testimonials stop displaying for visitors. Your settings stay as they are.
- Click Yes, Deactivate. (Cancel is selected by default, so pressing Enter by accident won't deactivate anything.)
The tab goes back to the empty activation card, and the key is free to activate on another site.
Integrations
This tab switches on support for page builders: Elementor, Divi, WPBakery, Oxygen, Beaver Builder and Bricks. Each toggle saves as soon as you click it. Turn on only the builders you actually use, so the plugin doesn't load code you don't need. See Integrations for what each one adds.
Looking for your AI keys?
AI provider keys used to live on this tab. They now have a tab of their own, AI Configuration, described next.
AI Configuration
Two features use AI: the AI summary in the Review Summary block, and Build with AI, which sets up a testimonial block from a plain-English description. Both need an API key, which is a personal access code you get from an AI company. This tab is where you add one.
You can connect Anthropic (Claude), Google Gemini, OpenAI (ChatGPT) and Groq. Each one shows as Connected or Not set up, and the counter at the top tells you how many are ready. The provider marked Primary is tried first. Any other connected provider steps in as a backup if the primary one fails or hits its limit.
See AI Configuration for the full setup walkthrough. If you don't use either AI feature, you can skip this tab entirely.
Performance
| Option | What it does |
|---|---|
| Google Fonts | Whether the plugin loads Google Fonts on your site (off by default). Leave it off if your theme already provides the fonts you use, or you want to avoid the extra requests. |
| Load Modal by Rest API | Fetch popup content in the background so popups feel quicker to open (on by default). |
| Cache | Save a ready-made copy of your testimonials so repeat visits load faster (off by default). |
| Cache Time (Cache on) | How long a cached copy is kept before it refreshes, in hours. Default 24. |
| Clear Cached | Click Flush Cache, then Save Change, to clear cached data. Use this if your testimonials look out of date after changes. |
Advanced Controls
| Option | What it does |
|---|---|
| Exclude from Search | Keep testimonial posts out of your site's internal search results. On by default. |
| Clean-up Data on Deletion | Delete all plugin data (testimonials, views, settings) when the plugin is uninstalled. Off by default. Only turn it on if you're certain. |
| Single Testimonial Template | Use the plugin's own layout for a single testimonial's page (what visitors see if they open one testimonial on its own), instead of your theme's standard post layout. Off by default. |
| Content Alignment (Single Testimonial Template on) | Lines up the content on that single testimonial page: Left (default), Center or Right. |
| Strict Random | Random ordering has a quirk: the same testimonial can reappear when a visitor clicks load-more or moves to the next page, because each request shuffles again. Turn this on and duplicates are filtered out. |
| Contribute to Real Testimonials Pro | Share non-sensitive diagnostic data with the plugin team so they can fix problems faster. Off by default. See below. |
Data removal is permanent
Clean-up Data on Deletion removes everything when you delete the plugin. Export a backup first (see Tools).
Contribute to Real Testimonials Pro
This toggle at the bottom of the tab lets you send the plugin team some basic, non-sensitive facts about your site. They use it to fix problems faster and keep the plugin compatible with popular themes and plugins. It's entirely optional and off unless you turn it on.
Click what we collect. next to the description to see the full list before you decide. In short, it's:
- your WordPress and PHP versions,
- your active theme and plugins,
- general system details,
- and an email address, used only for helpful updates or optional offers.
A few more details before you decide:
- It's the same choice you may have seen elsewhere. The setup wizard's last step and a one-time admin notice ask the same question. Whatever you choose here replaces your earlier answer.
- Turning it on and clicking Save Change sends the data once straight away, then refreshes it once a week while the toggle stays on.
- Turning it off and saving stops the weekly sending and stops the admin notice from asking you again.
- Nothing is sent from local test sites, such as
localhostor addresses ending in.localor.test, even with the toggle on. - Reset on this tab switches it back off along with everything else.
Tools: Export/Import Testimonials
Sooner or later you'll want your testimonials somewhere else. Maybe you're copying them to a staging site for a redesign, handing a finished build over to a client's live site, or just keeping a backup in case something goes wrong. The Tools tab handles all of that. It downloads your testimonials (or the Views and Forms built around them) as a file, and reads that file back in on any other site running Real Testimonials.

Where the controls live
- In the WordPress admin sidebar, click Real Testimonials → Settings.
- Pick Tools in the tab sidebar.
- The tab is split in two: Export on top, Import underneath.
Exporting
Pick one of the five options under Choose What To Export. You can only pick one at a time, because each export file holds one kind of thing:
| Option | What lands in the file |
|---|---|
| All Testimonials | Every testimonial: name, content, rating, reviewer details, custom fields, social profiles, the featured image URL, and any groups/categories it belongs to. |
| All Testimonial Views (Shortcodes) | Every saved View, with its layout and all of its shortcode options. The testimonials themselves aren't included. |
| All Testimonial Forms (Shortcodes) | Every submission form and its settings. |
| Selected Testimonial Views (Shortcodes) | Only the Views you tick in the multi-select list that appears. |
| Selected Testimonial Forms (Shortcodes) | Only the Forms you tick in the multi-select list that appears. |
Choose one of the Selected … options and a searchable list of your Views or Forms appears. Pick at least one. If you hit Export File with nothing selected, you'll get a "Choose at least one testimonial view." (or "…testimonial form.") warning instead of a download.
Export File Type only shows up for All Testimonials, since that's the only export that makes sense as a spreadsheet:
- JSON File keeps everything. Use it for migrations and backups.
- CSV File gives you one row per testimonial, which you can open in Excel, Google Sheets or Numbers. It's handy when you want to review or bulk-edit testimonials by hand.
Click Export File and your browser downloads testimonial-pro-export-<timestamp>.json (or .csv). The timestamp means repeat exports never overwrite each other. JSON exports also record the plugin version and the export date at the top of the file, so you can tell old backups apart.
What the CSV looks like
The CSV is also the easiest way to create testimonials in bulk: export one testimonial, open the file, copy the row, and fill in your own data. The columns are, in order:
version, date, all_testimonial, title, original_id, category, content, image,
_edit_last, _edit_lock, _thumbnail_id, company_logo, name, email, designation,
company_name, location, country, phone, website, video_url, rating,
extra_fields, social_profilestitle is the testimonial's title, content is the testimonial text, name is the reviewer, rating is a number from 1 to 5, and image is a full URL to the reviewer's photo.
Two things about the format will look odd until you know why:
- Commas and quotes inside a value get swapped out. In the columns that hold structured data (
category,company_logo,extra_fields,social_profiles), commas are stored as|and double quotes as'so they don't break the CSV grid. The importer swaps them back. Leave that packing alone when you edit a file. - Line breaks in the testimonial text are flattened to spaces, and any
"in it becomes\dq. Again, the importer reverses it.
If you're hand-writing rows, stick to plain text in content and you'll be fine.
Importing
The Import half is labeled Import JSON/CSV File To Upload:
- Drag your
.jsonor.csvfile onto the upload zone, or click Choose File and browse for it. Other file types are ignored. - Click Apply Input.
- When it works, you'll see an "Import completed." message. After a moment the page takes you to the list of whatever you just imported (Testimonials, Views or Forms), so you can check the result right away.
Before you click, keep these in mind:
- Import always creates new entries. There's no matching or merging: run the same file twice and you get two copies of everything. Delete or trash the old items first if you're re-importing.
- Reviewer images are re-downloaded. The file stores an image URL, and the importer fetches it into this site's Media Library. So the old site needs to still be online and its uploads publicly reachable. Importing from a password-protected staging site, or from a site that's already been taken down, brings in the testimonials without their photos, and you'll have to add those back by hand. If an image with the same filename is already in your Media Library, it's reused instead of downloaded again.
- Testimonial content is sanitized. HTML is filtered on the way in, the same way WordPress filters post content. Embeds and
<iframe>tags in testimonial text may be stripped. - New site, new IDs. Views and Forms get fresh IDs on the destination site, so any
[sp_testimonial id="12"]shortcode you'd pasted into a page by hand won't point at the right View any more. Open the imported View, copy its new shortcode, and update your pages. Blocks aren't affected, because they carry their settings with them. - CSV imports handle testimonials only. Views and Forms only travel as JSON.
- You need administrator access. Both export and import require the
manage_optionscapability, so editors and authors can't use this tab.
If one entry in the file is broken, the import reports the error and skips that one entry. The rest still come through.
Moving a whole site, in order
Migrating everything? Do it in this order so nothing points at the wrong thing:
- On the old site, export All Testimonials as JSON.
- Export your Views, then your Forms. Each type is its own export, so you'll end up with three files.
- On the new site, install and activate Real Testimonials, then import the testimonials file first. Views and Forms reference testimonials, so the content needs to exist before them.
- Import the Views file, then the Forms file.
- Check each imported View's shortcode and update any pages that used the old IDs.
Additional CSS & JS
This tab gives you two code editors, Custom CSS and Custom JS, for site-wide snippets that load alongside the plugin's blocks. Good for small styling tweaks when you'd rather not touch your theme files.
Classic Settings
A few options that date from the plugin's classic (shortcode) days live on their own tab, split into two sub-tabs. They apply to the whole site, blocks included.
| Sub-tab | What's inside |
|---|---|
| Custom Menu | Rename the plugin's admin labels: Singular name and Plural name for testimonials (default "Testimonial" / "Testimonials"), and Group Singular name and Group Plural name for groups (default "Group" / "Groups"). If your site calls them "Reviews" and "Categories" instead, set that here and the admin menu and edit screens pick up your names everywhere. |
| Control Assets | Individual switches for the CSS and JS libraries the plugin loads on the front end: Swiper, bxSlider, Font Awesome and Magnific Popup CSS, and Swiper, bxSlider, Isotope and Magnific Popup JS. They're all on by default. If your theme already loads one of these libraries, switch off the duplicate here. |
Like the Performance and Advanced Controls tabs, this one needs a click on Save Change before anything takes effect.
Where did the other classic options go?
The old classic settings screen also held cache, Google Fonts, single-template and custom code options. They've moved to the dashboard tabs above: Cache Time on Performance, Content Alignment on Advanced Controls, and the code editors on Additional CSS & JS.